InRibbonGallery-Element

Artikel
08/14/2024

Stellt den Katalog im Menüband dar, ein katalogbasiertes Steuerelement, das eine Standardteilmenge von Elementen direkt im Menüband verfügbar macht. Alle verbleibenden Elemente werden angezeigt, wenn auf eine Dropdownmenüschaltfläche geklickt wird.

Verbrauch

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

Attribute

attribute	type	Erforderlich	BESCHREIBUNG
CommandName	xs:positiveInteger oder xs:string	Nein	Ordnet das Element einem Befehl zu. (xs:positiveInteger oder xs:string) Eine Zeichenfolge, ein ganzzahliger Wert zwischen 2 und 59999 einschließlich oder ein Hexadezimalwert zwischen 0x2 und 0xea5f, einschließlich. Der Wert muss innerhalb des XML-Dokuments des Menübands eindeutig sein. Maximale Länge: 100 Zeichen.
HasLargeItems	Boolesch	Nein	Bestimmt, ob die große oder kleine Bildressource des Befehls im Katalogsteuerelement angezeigt wird. Hinweis: Gilt nur für Kataloge, in denen der Wert des Type-Attributs gleich `Command`ist. Beschränkt auf einen der folgenden Werte (0 und 1 sind ungültig): (true) Standard. (false)
Itemheight	xs:integer	Nein	Bestimmt zusammen mit ItemWidth die Größe des Elementbilds, das im Katalogsteuerelement angezeigt wird. Hinweis: Gilt nur für Kataloge, in denen der Wert des Type-Attributs gleich `Item`ist. (xs:integer) Der Standard ist -1.
ItemWidth	xs:integer	Nein	Bestimmt zusammen mit ItemHeight die Größe des Elementbilds, das im Katalogsteuerelement angezeigt wird. Hinweis: Gilt nur für Kataloge, in denen der Wert des Type-Attributs gleich `Item`ist. (xs:integer) Der Standard ist -1.
MaxColumns	xs:integer	Nein	Gibt die maximale Anzahl von Spalten an, die in Der InRibbonGallery angezeigt wird, z. B. in der Dropdownliste Großes Gruppenlayout. (xs:integer)
MaxColumnsMedium	xs:integer	Nein	Gibt die maximale Anzahl von Spalten an, die die InRibbonGallery im Layout mittlerer Gruppe anzeigt, bevor Sie zu Großes Layout wechseln. (xs:integer)
MaxRows	xs:integer	Nein	Gibt die maximale Anzahl von Zeilen für das Layout von InRibbonGallery-Elementen an . (xs:integer) Der Standardwert ist 1.
MinColumnsLarge	xs:integer	Nein	Gibt die Mindestanzahl von Spalten an, die die InRibbonGallery im Layout große Gruppe anzeigt, bevor Sie zu Mittel wechseln. (xs:integer)
MinColumnsMedium	xs:integer	Nein	Gibt die Mindestanzahl von Spalten an, die die InRibbonGallery im Layout mittlerer Gruppe anzeigt, bevor Sie zu Klein wechseln. (xs:integer)
TextPosition	TextPositionType	Nein	Gibt an, wo die Elementbezeichnung relativ zum Bild angezeigt wird. Beschränkt auf einen der folgenden Werte: (Unten) (Ausblenden) (Links) (Überlappung) (Rechts) (Oben)
Type	xs:string	Nein	Beschränkt auf einen der folgenden Werte: (Elemente) (Befehle)

Untergeordnete Elemente

Element	BESCHREIBUNG
Checkbox	Kann ein oder mehrere Male auftreten
InRibbonGallery.MenuGroups	Muss genau einmal auftreten
InRibbonGallery.MenuLayout	Kann höchstens einmal auftreten
Schaltfläche	Kann ein oder mehrere Male auftreten
SplitButton	Kann ein oder mehrere Male auftreten
ToggleButton	Kann ein oder mehrere Male auftreten

Übergeordnete Elemente

Element	BESCHREIBUNG
ControlGroup
Gruppe
QuickAccessToolbar.ApplicationDefaults	Hinweis: Windows 8 und neuer.

Hinweise

Optional.

Kann für jedes ControlGroup- oder Group-Element höchstens einmal auftreten.

Der folgende Screenshot veranschaulicht das Menüband-In-Menüband-Katalog-Steuerelement in Microsoft Paint für Windows 7.

Screenshot eines Menübandkatalogsteuerelements im Microsoft-Farbband

Beispiele

Das folgende Beispiel veranschaulicht das grundlegende Markup für einen In-Ribbon-Katalog.

Dieser Codeabschnitt zeigt die InRibbonGallery-Befehlsdeklarationen mit einer zugeordneten Gruppe , die als übergeordneter Container für das InRibbonGallery-Element fungiert.

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

Dieser Codeabschnitt zeigt die InRibbonGallery-Steuerelementdeklarationen .

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

Elementinformationen

Unterstützte Mindestsystem: Windows 7
Kann leer sein: Nein

Weitere Informationen

In-Menübandkatalog-Steuerelement
Arbeiten mit Galerien
Katalogbeispiel

Freigeben über