GcColorPicker.ColorFormattingイベントを処理すると、色値から、GcColorPickerコントロールに表示される書式設定されたテキストへの変換をカスタマイズできます。

GcColorPicker.ColorFormattingイベントは、GcColorPicker.SelectedColorをGcColorPickerに表示されるテキストに書式設定する必要があるときに発生します。GcColorPicker.ColorFormattingイベントを処理するとき、ColorプロパティはGcColorPicker.SelectedColorの値で初期化されます。選択された色から表示テキストへのカスタム変換を行う場合は、Textプロパティを変換後のテキストに設定します。

書式設定されたユーザー指定のテキストから実際の色値への変換をカスタマイズするには、GcColorPicker.ColorParsingイベントを処理します。

次のサンプルコードは、GcColorPicker.ColorFormattingイベントを使用して、選択された色から表示テキストへの変換をカスタマイズする方法を示します。このサンプルコードを実行するには、System.Windows.Forms.Formプロジェクトを作成し、GcColorPickerインスタンスを追加して、以下のコードをプロジェクトに貼り付けます。そして、このイベントハンドラをGcColorPickerインスタンスのGcColorPicker.ColorFormattingイベントに関連付けます。

private void GcColorPicker_FormatColor(object sender, ColorFormattingEventArgs e)
{
    Color myColor1 = Color.FromArgb(255, 192, 192);
    Color myColor2 = Color.FromArgb(255, 255, 192);

    // If the seleced color is my defined color, format the displayed text to the required text.
    if (e.Color == myColor1)
    {
        e.Text = "MyColor1";
    }
    else if (e.Color == myColor2)
    {
        e.Text = "MyColor2";
    }
}

Private Sub GcColorPicker_FormatColor(ByVal sender As Object, ByVal e As ColorFormattingEventArgs)
    Dim myColor1 As Color = Color.FromArgb(255, 192, 192)
    Dim myColor2 As Color = Color.FromArgb(255, 255, 192)

    ' If the selected color is my defined color, format the displayed text to the required text.
    If e.Color = myColor1 Then
        e.Text = "MyColor1"
    ElseIf e.Color = myColor2 Then
        e.Text = "MyColor2"
    End If
End Sub

System.Object
   System.EventArgs
      GrapeCity.Win.Pickers.ColorFormattingEventArgs

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

ColorFormattingEventArgs メンバ
GrapeCity.Win.Pickers 名前空間
GcColorPicker クラス
SelectedColor プロパティ
ColorParsing イベント
GcColorPicker クラス
SelectedColor プロパティ
ColorParsing イベント