Text プロパティ (GcColorPicker)

System.Windows.Forms.TextBoxに表示されるテキストを取得または設定します。

構文

Visual Basic (宣言)
C#

Public Overrides Property Text As String

public override string Text {get; set;}

プロパティ値

string値。

例外

例外	解説
System.ArgumentException	指定されたテキストが有効ではなく、System.Drawing.Colorに変換できません。

解説

Textに値を設定すると、その値がSystem.Drawing.Color構造体に変換できる場合、Textが正常に設定され、SelectedColorが変換された色に変更されます。変換できない場合、TextとSelectedColorは変更されません。

使用例

次のサンプルコードは、Textプロパティの使用方法を示します。この例では、指定された文字列がSystem.Drawing.Color構造体に変換できるため、Textプロパティは正常に設定されます。このサンプルコードを実行するには、以下のコードをSystem.Windows.Forms.Formプロジェクトに追加し、ここで作成したメソッドをコンストラクターまたはフォーム上の別のメソッドから呼び出します。

C#
Visual Basic

private void CreateGcColorPickerWithText()
{
    // Create an instance of GcColorPicker control.
    GcColorPicker gcColorPicker = new GcColorPicker();

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

    // Set the text to red successfully.
    gcColorPicker.Text = "Red";

    /// Set an invalid string will throw an ArgumentException.
    //gcColorPicker.Text = "aBlue";

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

Private Sub CreateGcColorPickerWithText()
    ' Create an instance of GcColorPicker control.
    Dim gcColorPicker As New GcColorPicker()

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

    ' Set the text to red successfully.
    gcColorPicker.Text = "Red"

    ' Set an invalid string will throw an ArgumentException.
    'gcColorPicker.Text = "aBlue";

    ' adds gcColorPicker to the form.
    Me.Controls.Add(gcColorPicker)
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

参照

GcColorPicker クラス
 GcColorPicker メンバ