GcColorPicker.ColorParsingイベントを処理すると、ユーザー指定の文字列からGcColorPicker.SelectedColorプロパティで指定された色へのカスタムの値変換を実行できます。

GcColorPicker.ColorParsingイベントはGcColorPickerの入力テキストが変更されるたびに発生するため、このイベントのイベントハンドラには時間のかかる処理を記述しないでください。GcColorPicker.ColorParsingイベントを処理するとき、Textプロパティは、GcColorPickerコントロールの入力テキストで初期化されます。入力テキストから選択された色へのカスタム変換を行う場合は、Colorプロパティを変換後の色に設定します。

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

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

private void GcColorPicker_ParseColor(object sender, ColorParsingEventArgs e)
{
    switch (e.Text.ToLower())
    {
        case "mycolor1":
            e.Color = Color.FromArgb(255, 192, 192);
            break;
        case "mycolor2":
            e.Color = Color.FromArgb(255, 255, 192);
            break;
    }
}

Private Sub GcColorPicker_ParseColor(ByVal sender As Object, ByVal e As ColorParsingEventArgs)
    Select Case e.Text.ToLower()
        Case "mycolor1"
            e.Color = Color.FromArgb(255, 192, 192)
            Exit Select
        Case "mycolor2"
            e.Color = Color.FromArgb(255, 255, 192)
            Exit Select
    End Select
End Sub

System.Object
   System.EventArgs
      GrapeCity.Win.Pickers.ColorParsingEventArgs

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

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