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 샘플