Elemen InRibbonGallery

Artikel
09/03/2023

Mewakili Galeri Pita Dalam, kontrol berbasis galeri yang mengekspos subset item default langsung di Pita. Item yang tersisa ditampilkan saat tombol menu drop-down diklik.

Penggunaan

<InRibbonGallery
  CommandName = "xs:positiveInteger or xs:string"
  HasLargeItems = "Boolean"
  ItemHeight = "xs:integer"
  ItemWidth = "xs:integer"
  MinColumnsLarge = "xs:integer"
  MaxColumnsMedium = "xs:integer"
  MinColumnsMedium = "xs:integer"
  MaxColumns = "xs:integer"
  MaxRows = "xs:integer"
  TextPosition = "TextPositionType"
  Type = "xs:string">
  child elements
</InRibbonGallery>

Atribut

Atribut	Jenis	Diperlukan	Deskripsi
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.
HasLargeItems	Boolean	Tidak	Menentukan apakah sumber daya gambar besar atau kecil dari Perintah ditampilkan dalam kontrol galeri. Catatan: Hanya berlaku untuk galeri di mana nilai atribut Type sama dengan `Command`. Dibatasi untuk salah satu nilai berikut (0 dan 1 tidak valid): (benar) Default. (false)
ItemHeight	xs:bilangan bulat	Tidak	Bersama dengan ItemWidth, menentukan ukuran gambar item yang ditampilkan dalam kontrol galeri. Catatan: Hanya berlaku untuk galeri di mana nilai atribut Type sama dengan `Item`. (xs:bilangan bulat) Defaultnya adalah -1.
ItemWidth	xs:bilangan bulat	Tidak	Bersama dengan ItemHeight, menentukan ukuran gambar item yang ditampilkan dalam kontrol galeri. Catatan: Hanya berlaku untuk galeri di mana nilai atribut Type sama dengan `Item`. (xs:bilangan bulat) Defaultnya adalah -1.
MaxColumns	xs:bilangan bulat	Tidak	Menentukan jumlah maksimum kolom yang ditampilkan InRibbonGallery , misalnya, di menu drop-down Tata letak grup besar . (xs:bilangan bulat)
MaxColumnsMedium	xs:bilangan bulat	Tidak	Menentukan jumlah maksimum kolom yang ditampilkan InRibbonGallery dalam tata letak grup Sedang , sebelum beralih ke tata letak Besar . (xs:bilangan bulat)
MaxRows	xs:bilangan bulat	Tidak	Menentukan jumlah maksimum baris untuk tata letak item InRibbonGallery . (xs:bilangan bulat) Defaultnya adalah 1.
MinColumnsLarge	xs:bilangan bulat	Tidak	Menentukan jumlah kolom minimum yang ditampilkan InRibbonGallery dalam tata letak grup Besar , sebelum beralih ke Sedang. (xs:bilangan bulat)
MinColumnsMedium	xs:bilangan bulat	Tidak	Menentukan jumlah kolom minimum yang ditampilkan InRibbonGallery dalam tata letak grup Sedang , sebelum beralih ke Kecil. (xs:bilangan bulat)
TextPosition	TextPositionType	Tidak	Menentukan di mana label item ditampilkan, relatif terhadap gambar. Dibatasi untuk salah satu nilai berikut: (Bawah) (Sembunyikan) (Kiri) (Tumpang tindih) (Kanan) (Atas)
Jenis	xs:string	Tidak	Dibatasi untuk salah satu nilai berikut: (Item) (Perintah)

Elemen anak

Elemen	Deskripsi
CheckBox	Dapat terjadi satu atau beberapa kali
InRibbonGallery.MenuGroups	Harus terjadi tepat sekali
InRibbonGallery.MenuLayout	Dapat terjadi paling banyak sekali
Tombol	Dapat terjadi satu atau beberapa kali
SplitButton	Dapat terjadi satu atau beberapa kali
ToggleButton	Dapat terjadi satu atau beberapa kali

Elemen induk

Elemen	Deskripsi
ControlGroup
Grup
QuickAccessToolbar.ApplicationDefaults	Catatan: Windows 8 dan yang lebih baru.

Keterangan

Pilihan.

Dapat terjadi paling banyak sekali untuk setiap elemen ControlGroup atau Group .

Cuplikan layar berikut mengilustrasikan kontrol Galeri Pita Di Pita di Microsoft Paint untuk Windows 7.

cuplikan layar kontrol galeri di pita di pita cat microsoft.

Contoh

Contoh berikut menunjukkan markup dasar untuk Galeri Dalam Pita.

Bagian kode ini menunjukkan deklarasi Perintah InRibbonGallery , dengan Grup terkait yang bertindak sebagai kontainer induk untuk elemen InRibbonGallery .

<!-- InRibbonGallery -->
<Command Name="cmdInRibbonGalleryGroup"
         Symbol="cmdInRibbonGalleryGroup"
         Comment="InRibbonGallery Group"
         LabelTitle="InRibbonGallery"/>
<Command Name="cmdInRibbonGallery"
         Symbol="cmdInRibbonGallery"
         Comment="InRibbonGallery"
         LabelTitle="InRibbonGallery"/>

Bagian kode ini menunjukkan deklarasi kontrol InRibbonGallery .

<!-- InRibbonGallery -->
<Group CommandName="cmdInRibbonGalleryGroup" SizeDefinition="OneInRibbonGallery">
  <InRibbonGallery CommandName="cmdInRibbonGallery"
                   MaxColumns="10"
                   MaxColumnsMedium="5"
                   MinColumnsLarge="5"
                   MinColumnsMedium="3"
                   Type="Items">
    <InRibbonGallery.MenuLayout>
      <VerticalMenuLayout Rows="2"
                          Gripper="Vertical"/>
    </InRibbonGallery.MenuLayout>
    <InRibbonGallery.MenuGroups>
      <MenuGroup>
        <Button CommandName="cmdButton1"></Button>
        <Button CommandName="cmdButton2"></Button>
      </MenuGroup>
      <MenuGroup>
        <Button CommandName="cmdButton3"></Button>
      </MenuGroup>
    </InRibbonGallery.MenuGroups>            
  </InRibbonGallery>
</Group>

Informasi Elemen

Sistem minimum yang didukung: Windows 7
Bisa kosong: Tidak

Lihat juga

Kontrol Galeri Dalam Pita
Bekerja dengan Galeri
Sampel Galeri

Bagikan melalui