Text プロパティ (GcFontPicker)

このコントロールに関連付けられているテキストを取得または設定します。

構文

Visual Basic (宣言)
C#

Public Overrides Property Text As String

public override string Text {get; set;}

プロパティ値

このコントロールに関連付けられているテキスト。

例外

例外	解説
System.ArgumentException	指定されたテキストが既存のフォント名ではありません。

解説

Textに値を設定すると、その値が既存のフォント名である場合、Textが正常に設定され、SelectedFontInfoが変更されます。既存のフォント名でない場合はSystem.ArgumentExceptionがスローされ、Textは変更されません。

使用例

次のサンプルコードは、Textプロパティを使用してSystem.Drawing.Fontをプログラムによって指定する方法を示します。この例では、設定された文字列が有効なフォント名であり、System.Drawing.Fontに変換できるため、Textは正常に設定されます。実行時にGcFontPickerコントロールのテキストエディタに文字列を入力すると、入力した文字列が有効なフォント名である場合はSelectedFontInfoが変更されます。無効なフォント名である場合、SelectedFontInfoは変更されません。このサンプルコードを実行するには、以下のコードをSystem.Windows.Forms.Formプロジェクトに追加し、ここで作成したメソッドをコンストラクターまたはフォーム上の別のメソッドから呼び出します。

C#
Visual Basic

private void CreateGcFontPickerWithText()
{
    // Create an instance of GcFontPicker control.
    GcFontPicker gcFontPicker = new GcFontPicker();

    // Initialize the Name and Location of the gcFontPicker.
    gcFontPicker.Name = "gcFontPicker";
    gcFontPicker.Location = new Point(10, 50);

    // Set a valid font name to the Text property of gcFontPicker.
    gcFontPicker.Text = "Arial";

    // Set an invalid font name to the Text property will throw an exception,
    // if you want to execute the follwing code, comment out it.
    //gcFontPicker.Text = "123";

    // adds gcFontPicker to the form.
    this.Controls.Add(gcFontPicker);
}

Private Sub CreateGcFontPickerWithText()
    ' Create an instance of GcFontPicker control.
    Dim gcFontPicker As New GcFontPicker()

    ' Initialize the Name and Location of the gcFontPicker.
    gcFontPicker.Name = "gcFontPicker"
    gcFontPicker.Location = New Point(10, 50)

    ' Set a valid font name to the Text property of gcFontPicker.
    gcFontPicker.Text = "Arial"

    ' Set an invalid font name to the Text property will throw an exception,
    ' if you want to execute the follwing code, comment out it.
    'gcFontPicker.Text = "123";

    ' adds gcFontPicker to the form.
    Me.Controls.Add(gcFontPicker)
End Sub

プラットフォーム

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

参照

GcFontPicker クラス
 GcFontPicker メンバ