DropDownColorPicker 要素

  • [アーティクル]

クリックするとカラー 見本のパレットが表示される ドロップダウン カラー ピッカーコントロールを表します。

使用法

<DropDownColorPicker
  CommandName = "xs:positiveInteger or xs:string"
  Columns = "xs:positiveInteger"
  ThemeColorGridRows = "xs:positiveInteger"
  StandardColorGridRows = "xs:positiveInteger"
  RecentColorGridRows = "xs:positiveInteger"
  IsAutomaticColorButtonVisible = "Boolean"
  IsNoColorButtonVisible = "Boolean"
  ColorTemplate = "xs:string"
  ChipSize = "xs:string"/>

属性

属性 Type 必須 説明
ChipSize
 xs:string
 いいえ
 各カラー チップまたは見本のサイズ。
次のいずれかの値に制限されます。

(小)
各カラー チップは 11 x 11 ピクセルの正方形です。
(中)
各カラー チップは 16 x 16 ピクセルの正方形です。
(大)
各カラー チップは 24 x 24 ピクセルの正方形です。
ColorTemplate
 xs:string
 いいえ
 ドロップダウン カラー ピッカーの種類を指定するレイアウト テンプレート。
次のいずれかの値に制限されます ( ColorTemplate に関連する省略可能な属性が宣言されていない場合、既定のビューが表示されます)。

(ThemeColors)
既定値。
ColorTemplate 属性が 'ThemeColors' に設定されている DropDownColorPicker 要素のスクリーン ショット。
ColorTemplate 属性を に設定するとThemeColors、次の機能が有効になります。
  • SplitButton アンカー。
  • 既定では、[自動 色] ボタンが表示されます。
  • Windows テーマの色 見本グリッド。
  • 標準色 見本グリッド。
  • 最近使用した色 見本グリッドは省略可能です。
  • [その他の色 ] ダイアログ ボックス起動ツール。
  • 既定では、[色] ボタンは表示されません。
(StandardColors)
ColorTemplate 属性が 'StandardColors' に設定されている DropDownColorPicker 要素のスクリーン ショット。
ColorTemplate 属性を に設定するとStandardColors、次の機能が有効になります。
  • SplitButton アンカー。
  • 既定では、[自動 色] ボタンが表示されます。
  • 標準色 見本グリッド。
  • [その他の色 ] ダイアログ ボックス起動ツール。
  • 既定では、[色] ボタンは表示されません。
(HighlightColors)
ColorTemplate 属性が 'HighlightColors' に設定されている DropDownColorPicker 要素のスクリーン ショット。
ColorTemplate 属性を に設定するとHighlightColors、次の機能が有効になります。
  • SplitButton アンカー。
  • ヘッダーのない標準色 見本グリッド。
  • 既定では、[色] ボタンは表示されません。
[列]
 xs:positiveInteger
 いいえ
 カラー チップ (または見本) 列の数。

(xs:positiveInteger)
1 から 256 までの正の整数値 (両端を含む)。
CommandName
 xs:positiveInteger または xs:string
 いいえ
 要素を Command に関連付 けます。

(xs:positiveInteger または xs:string)
文字列、2 ~ 59999 の整数値、または 0x2 と 0xea5f の間の 16 進数の値 (両端を含む)。
値はリボン XML ドキュメント内で一意である必要があります。
最大長: 100 文字。
IsAutomaticColorButtonVisible
 ブール型
 いいえ
 [自動色] ボタンを表示 (または非表示) します。
ColorTemplate 属性に または ThemeColors が指定されている場合StandardColorsにのみ有効です。
次のいずれかの値に制限されます (0 と 1 は無効です)。

(true)
(false)
IsNoColorButtonVisible
 ブール型
 いいえ
 [ 色なし ] ボタンを表示 (または非表示) します。
すべての ColorTemplate 値に対して 有効です。
次のいずれかの値に制限されます (0 と 1 は無効です)。

(true)
(false)
RecentColorGridRows
 xs:positiveInteger
 いいえ
 [最近使用した色] 領域のカラー チップ (または見本) 行の数。
ColorTemplate 属性に が指定されている場合ThemeColorsにのみ有効です。

(xs:positiveInteger)
1 から 256 までの正の整数値 (両端を含む)。
StandardColorGridRows
 xs:positiveInteger
 いいえ
 [標準色] 領域のカラー チップ (または見本) 行の数。

(xs:positiveInteger)
1 から 256 までの正の整数値 (両端を含む)。
ThemeColorGridRows
 xs:positiveInteger
 いいえ
 [テーマの色] 領域のカラー チップ (または見本) 行の数。
ColorTemplate 属性に が指定されている場合ThemeColorsにのみ有効です。

(xs:positiveInteger)
1 ~ 256 の正の整数値 (両端を含む)。

子要素

子要素はありません。

親要素

要素
ControlGroup
DropDownButton
DropDownGallery
グループ
MenuGroup
SplitButton
SplitButtonGallery

解説

省略可能。

ControlGroup、DropDownButton、DropDownGallery、Group、MenuGroup、SplitButton、または SplitButtonGallery 要素ごとに 1 回以上発生する可能性があります。

例

次の例では、3 種類の ドロップダウン カラー ピッカーすべてに対する基本的なマークアップを示します。

コードのこのセクションでは、3 つの DropDownColorPicker 要素の Command 宣言を示します。

<!-- DropDownColorPickers -->
<Command Name="cmdDropDownColorPickerGroup"
         Symbol="cmdDropDownColorPickerGroup"
         Comment="DropDownColorPicker Group"
         Id="55000"/>
<Command Name="cmdDropDownColorPickerThemeColors"
         Symbol="cmdDropDownColorPickerThemeColors"
         Comment="DropDownColorPicker ThemeColors"
         Id="55010"
         LabelTitle="ThemeColors"
         LabelDescription="ThemeColors\ndescription."/>
<Command Name="cmdDropDownColorPickerStandardColors"
         Symbol="cmdDropDownColorPickerStandardColors"
         Comment="DropDownColorPicker StandardColors"
         Id="55011"
         LabelTitle="StandardColors"/>
<Command Name="cmdDropDownColorPickerHighlightColors"
         Symbol="cmdDropDownColorPickerHighlightColors"
         Comment="DropDownColorPicker HighlightColors"
         Id="55012"
         LabelTitle="HighlightColors"/>

コードのこのセクションでは、3 種類の DropDownColorPicker コントロール宣言を示します。

<Group CommandName="cmdDropDownColorPickerGroup"
       SizeDefinition="ThreeButtons">
  <DropDownColorPicker
    CommandName="cmdDropDownColorPickerThemeColors"
    ColorTemplate="ThemeColors"/>
  <DropDownColorPicker
    CommandName="cmdDropDownColorPickerStandardColors"
    ColorTemplate="StandardColors"/>
  <DropDownColorPicker
    CommandName="cmdDropDownColorPickerHighlightColors"
    ColorTemplate="HighlightColors"
    StandardColorGridRows="1"/>
</Group>

要素情報

  • サポートされている最小システム: Windows 7
  • 空の場合: はい

関連項目

ドロップダウン カラー ピッカー コントロール

DropDownColorPicker サンプル