UseColorName プロパティ

SelectedColorが既知の色の場合、GcColorPickerのテキスト部分にSelectedColorのRGB書式ではなく色名を表示するかどうかを示す値を取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property UseColorName As Boolean

public bool UseColorName {get; set;}

プロパティ値

SelectedColorが既知の色の場合、テキスト部分にSelectedColorの色名を表示する場合はtrue、SelectedColorのRGB書式を表示する場合はfalse。falseに設定すると、テキスト部分には常にSelectedColorのRGB書式が表示されます。デフォルトはtrueです。

解説

UseColorNameがtrueの場合、GcColorPickerのSelectedColorは、SelectedColorが既知の色の場合にはSelectedColorの色名に、既知の色でない場合にはRGB文字列に、それぞれ書式設定されます。UseColorNameがfalseの場合、GcColorPickerのSelectedColorは常にRGB文字列に書式設定されます。

使用例

次のサンプルコードは、UseColorNameプロパティの使用方法を示します。このサンプルコードを実行するには、以下のコードをSystem.Windows.Forms.Formプロジェクトに追加し、ここで作成したメソッドをコンストラクターまたはフォーム上の別のメソッドから呼び出します。

C#
Visual Basic

private void CreateGcColorPickerWithUseColorName()
{
    // 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 UseColorName to false.
    gcColorPicker.UseColorName = false;

    // Set a SelectedColor.
    gcColorPicker.SelectedColor = Color.Red;

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

Private Sub CreateGcColorPickerWithUseColorName()
    ' 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 UseColorName to false.
    gcColorPicker.UseColorName = False

    ' Set a SelectedColor.
    gcColorPicker.SelectedColor = Color.Red

    ' 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 メンバ
 SelectedColor プロパティ
 SelectedColor プロパティ