다음을 통해 공유


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"/>

특성

attribute Type 필수 설명
ChipSize
xs:string
No
각 색상 칩 또는 견본의 크기입니다.
다음 값 중 하나로 제한됨:

(작음)
각 색상 칩은 11x11 픽셀 정사각형입니다.
(중간)
각 색 칩은 16x16 픽셀 정사각형입니다.
(Large)
각 색 칩은 24x24 픽셀 정사각형입니다.
ColorTemplate
xs:string
No
드롭다운 색 선택기 유형을 지정하는 레이아웃 템플릿입니다.
다음 값 중 하나로 제한됩니다( 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
No
색 칩(또는 견본) 열의 수입니다.

(xs:positiveInteger)
1에서 256 사이의 양수 정수 값(포함)입니다.
CommandName
xs:positiveInteger 또는 xs:string
No
요소를 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
No
최근 색 영역의 색 칩(또는 견본) 행 수입니다.
ColorTemplate 특성에 대해 가 지정된 경우에만 ThemeColors 유효합니다.

(xs:positiveInteger)
1에서 256 사이의 양수 정수 값(포함)입니다.
StandardColorGridRows
xs:positiveInteger
No
표준 색 영역의 색 칩(또는 견본) 행 수입니다.

(xs:positiveInteger)
1에서 256 사이의 양수 정수 값(포함)입니다.
ThemeColorGridRows
xs:positiveInteger
No
테마 색 영역의 색 칩(또는 견본) 행 수입니다.
ColorTemplate 특성에 대해 가 지정된 경우에만 ThemeColors 유효합니다.

(xs:positiveInteger)
1에서 256 사이의 양수 정수 값(포함)입니다.

자식 요소

자식 요소가 없습니다.

부모 요소

요소
ControlGroup
DropDownButton
DropDownGallery
그룹
MenuGroup
SplitButton
SplitButtonGallery

설명

선택 사항입니다.

ControlGroup, DropDownButton, DropDownGallery, Group, MenuGroup, SplitButton 또는 SplitButtonGallery 요소에 대해 하나 이상 발생할 수 있습니다.

예제

다음 예제에서는 드롭다운 색 선택기 세 가지 유형 모두에 대한 기본 태그를 보여 줍니다.

이 코드 섹션에서는 DropDownColorPicker 요소 3개에 대한 명령 선언을 보여 줍니다.

<!-- 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"/>

이 코드 섹션에서는 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 샘플