Elemen DropDownColorPicker

Artikel
06/13/2023

Mewakili kontrol Pemilih Warna Drop-Downyang saat diklik menampilkan palet swatch warna.

Penggunaan

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

Atribut

Atribut	Jenis	Diperlukan	Deskripsi
ChipSize	xs:string	Tidak	Ukuran setiap chip warna atau swatch. Dibatasi untuk salah satu nilai berikut: (Kecil) Setiap chip warna adalah persegi 11x11 piksel. (Sedang) Setiap chip warna adalah persegi 16x16 piksel. (Besar) Setiap chip warna adalah persegi 24x24 piksel.
ColorTemplate	xs:string	Tidak	Templat tata letak yang menentukan jenis Pemilih Warna Turun Bawah. Dibatasi untuk salah satu nilai berikut (jika tidak ada atribut opsional yang terkait dengan ColorTemplate yang dinyatakan, tampilan default ditampilkan): (ThemeColors) Default. Mengatur atribut ColorTemplate untuk `ThemeColors` mengaktifkan fungsionalitas berikut: Jangkar SplitButton. Tombol warna otomatis ditampilkan secara default. Kisi swatch warna Tema Windows. Kisi swatch warna standar. Kisi swatch Warna Terbaru bersifat opsional. Peluncur kotak dialog warna lainnya. Tidak ada tombol warna yang ditampilkan secara default. (StandardColors) Mengatur atribut ColorTemplate untuk `StandardColors` mengaktifkan fungsionalitas berikut: Jangkar SplitButton. Tombol warna otomatis ditampilkan secara default. Kisi swatch warna standar. Peluncur kotak dialog warna lainnya. Tidak ada tombol warna yang ditampilkan secara default. (Warna Sorotan) Mengatur atribut ColorTemplate untuk `HighlightColors` mengaktifkan fungsionalitas berikut: Jangkar SplitButton. Kisi swatch warna standar tanpa header. Tidak ada tombol warna yang ditampilkan secara default.
Kolom	xs:positiveInteger	Tidak	Jumlah kolom chip warna (atau swatch). (xs:positiveInteger) Setiap nilai bilangan bulat positif antara 1 dan 256, inklusif.
CommandName	xs:positiveInteger atau xs:string	Tidak	Mengaitkan elemen dengan Perintah. (xs:positiveInteger atau xs:string) String, nilai bilangan bulat antara 2 dan 59999, inklusif, atau nilai heksadesimal antara 0x2 dan 0xea5f, inklusif. Nilai harus unik dalam dokumen XML Pita. Panjang maksimum: 100 karakter.
IsAutomaticColorButtonVisible	Boolean	Tidak	Menampilkan (atau menyembunyikan) tombol Warna otomatis . Hanya berlaku ketika `StandardColors` atau `ThemeColors` ditentukan untuk atribut ColorTemplate . Dibatasi untuk salah satu nilai berikut (0 dan 1 tidak valid): (benar) (false)
IsNoColorButtonVisible	Boolean	Tidak	Menampilkan (atau menyembunyikan) tombol Tanpa warna . Berlaku untuk semua nilai ColorTemplate . Dibatasi untuk salah satu nilai berikut (0 dan 1 tidak valid): (benar) (false)
RecentColorGridRows	xs:positiveInteger	Tidak	Jumlah baris chip warna (atau swatch) di area Warna terbaru . Hanya berlaku ketika `ThemeColors` ditentukan untuk atribut ColorTemplate . (xs:positiveInteger) Setiap nilai bilangan bulat positif antara 1 dan 256, inklusif.
StandardColorGridRows	xs:positiveInteger	Tidak	Jumlah baris chip warna (atau swatch) di area Warna standar . (xs:positiveInteger) Setiap nilai bilangan bulat positif antara 1 dan 256, inklusif.
ThemeColorGridRows	xs:positiveInteger	Tidak	Jumlah baris chip warna (atau swatch) di area Warna tema . Hanya berlaku ketika `ThemeColors` ditentukan untuk atribut ColorTemplate . (xs:positiveInteger) Setiap nilai bilangan bulat positif antara 1 dan 256, inklusif.

Elemen anak

Tidak ada elemen anak.

Elemen induk

Elemen
ControlGroup
DropDownButton
DropDownGallery
Grup
Grup Menu
SplitButton
SplitButtonGallery

Keterangan

Pilihan.

Dapat terjadi satu atau beberapa kali untuk setiap elemen ControlGroup, DropDownButton, DropDownGallery, Group, MenuGroup, SplitButton, atau SplitButtonGallery .

Contoh

Contoh berikut menunjukkan markup dasar untuk ketiga jenis Pemilih Warna Drop-Down.

Bagian kode ini menunjukkan deklarasi Perintah untuk tiga elemen DropDownColorPicker .

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

Bagian kode ini menunjukkan tiga jenis deklarasi kontrol DropDownColorPicker .

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

Informasi Elemen

Sistem minimum yang didukung: Windows 7
Bisa kosong: Ya

Lihat juga

Kontrol Pemilih Warna Turun Bawah
Sampel DropDownColorPicker

Share via