【VB.NET】【WPF】Extended WPF Toolkit ColorPicker の使い方

WPF の標準コントロールには Forms の ColorDialog に相当するものがありません。

Forms の ColorDialog を WPF で使うこともできるわけですが・・・あまり気持ち良くないじゃないですか（？）。

で、ネット検索してみると、WPF で使えるものがいくつかの団体や会社から提供されているようですね。個人で開発している方もおられるようでした。

選択肢はいくつかあるようですが、ここでは Extended WPF Toolkit の ColorPicker の使い方をご紹介させていただきます。

Extended WPF Toolkit のインストール

Visual Studio の上部メニューから［ツール］＞［NuGet パッケージマネージャー］＞［ソリューションの NuGet パッケージの管理］を選択します。

［参照］を選択し、検索ボックスに「Extended.Wpf.Toolkit」と入力します。左ペインで Extended.Wpf.Toolkit が見つかったらそれを選択し、右側のペインでインストール先プロジェクトにチェックを入れて［インストール］ボタンをクリックします。

確認ダイアログが表示されたら［OK］をクリックします。

ColorPicker を設置する（xaml の編集）

Extended.Wpf.Toolkit をインストールしたら、ColorPicker を使用する Window の xaml を編集します。

Window タグに下記の xctk 名前空間を追加します。

そして ColorPicker を設置したいところに下記のタグを追加します。

もちろん上記は最低限のタグなので、必要に応じてプロパティを追加してください。

ちなみに、この記事の最初の図のような ColorPicker を表示するには、下記のようにプロパティを追加します。

<xctk:ColorPicker Name="ColorPicker" AdvancedButtonHeader="ユーザー設定" StandardButtonHeader="標準" AvailableColorsHeader="使用可能な色" 
     ShowRecentColors="True" RecentColorsHeader="最近使った色" StandardColorsHeader="標準色" Margin="5,0,0,0" DisplayColorAndName="False" 
     SelectedColorChanged="ColorPicker_SelectedColorChanged" Closed="ColorPicker_Closed" AvailableColorsSortingMode="HueSaturationBrightness" 
     UsingAlphaChannel="True" Width="60" SelectedColor="Red" />

プロパティ

ColorPicker のプロパティは次の通りです。

イベント

ColorPicker の主なイベントは次の通りです。

値の保存と復元

ColorPicker の「選択中の色」と「最近使った色」を保存／復元するコードの例です。

Dim ColorPickerValuesFile As String = "D:\temp\ColorPickerValues.txt"

Friend Sub SaveColorPickerValues(oColorPicker As Xceed.Wpf.Toolkit.ColorPicker)

If oColorPicker.SelectedColor.HasValue = True OrElse oColorPicker.RecentColors.Count > 0 Then
    Dim sw As New System.IO.StreamWriter(ColorPickerValuesFile)

    '選択中の色
    If oColorPicker.SelectedColor.HasValue = True Then
        Dim c As Color = oColorPicker.SelectedColor.Value
        sw.WriteLine("SelectedColor:" & c.A & "," & c.R & "," & c.G & "," & c.B)
    End If

    '最近使った色
    If oColorPicker.RecentColors.Count > 0 Then
        For Each item As Xceed.Wpf.Toolkit.ColorItem In oColorPicker.RecentColors
            If item.Color IsNot Nothing Then
                Dim c As Color = item.Color
                sw.WriteLine("RecentColor:" & item.Name & "," & c.A & "," & c.R & "," & c.G & "," & c.B)
            End If
        Next
    End If

    sw.Close() : sw.Dispose()
End If

End Sub

Friend Sub ReadColorPickerValues(oColorPicker As Xceed.Wpf.Toolkit.ColorPicker)

If System.IO.File.Exists(ColorPickerValuesFile) = True Then
    Dim allLines() As String = System.IO.File.ReadAllLines(ColorPickerValuesFile)
    For Each aLine As String In allLines
        If aLine.Contains(":") = True Then
            Dim vals As String = aLine.Remove(0, aLine.IndexOf(":")+1)
            Dim valsArray() As String = vals.Split(",")
            If aLine.Contains("SelectedColor") = True Then
                '選択中の色
                oColorPicker.SelectedColor = Color.FromArgb(valsArray(0),valsArray(1),valsArray(2),valsArray(3))
            Else
                '最近使った色
                Dim oColor As Color = Color.FromArgb(valsArray(1),valsArray(2),valsArray(3),valsArray(4))
                Dim oColorItem As New Xceed.Wpf.Toolkit.ColorItem(oColor, valsArray(0))
                oColorPicker.RecentColors.Add(oColorItem)
            End If
        End If
    Next
End If

End Sub

選択された色を Color に変換

Dim c As Color = oColorPicker.SelectedColor.Value

Dim DrawingColor = System.Drawing.Color.FromArgb(c.A, c.R, c.G, c.B)

Dim MediaColor = System.Windows.Media.Color.FromArgb(c.A, c.R, c.G, c.B)
'Dim MediaColor As System.Windows.Media.Color = oColorPicker.SelectedColor.Value

ビルド出力パスにコピーされる DLL

Extended Wpf Toolkit version 3.5.0 を参照して使用したところ、下記の５つの DLL がビルド出力パスにコピーされました。

• Xceed.Wpf.AvalonDock.dll
• Xceed.Wpf.AvalonDock.Themes.Aero.dll
• Xceed.Wpf.AvalonDock.Themes.Metro.dll
• Xceed.Wpf.AvalonDock.Themes.VS2010.dll
• Xceed.Wpf.Toolkit.dll

個人的には・・・１つか２つくらいにまとめてほしいな。Xceed.Wpf.Toolkit.dll 以外は必ずしも必要ではない気もするんだけど・・・よく分からない。