ControlRef-Element

  • Artikel

Letzte Änderung: Mittwoch, 13. Oktober 2010

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen
Hinweise

Stellt einen Platzhalter für ein Steuerelement in einem GroupTemplate-Element dar.

<ControlRef
  DisplayMode="Small | Medium | Large | Menu | Menu16 | Menu32"
  TemplateAlias="Text"
/>

Attribute

Attribut

Beschreibung

DisplayMode

Optional. Ein Enumerationswert, mit dem das Rendern eines Steuerelements bestimmt wird.

  • Small. Wird als kleines Symbol ohne Beschriftungstext gerendert.

  • Medium. Wird als Symbol mit 16x16 Pixeln mit Beschriftungstext gerendert.

  • Large. Wird als Symbol mit 32x32 Pixeln mit Beschriftungstext gerendert.

  • Menu. Wird als ein Nur-Text-Menüelement gerendert.

  • Menu16. Wird als ein Menüelement mit einem Symbol von 16x16 Pixeln gerendert.

  • Menu32. Wird als ein Menüelement mit einem Symbol von 32x32 Pixeln gerendert.

TemplateAlias

Optional. Eine Zeichenfolge, auf die ein Steuerelement in seinem eigenen TemplateAlias-Attribut verweisen kann. Das TemplateAlias-Attribut dient zum Bestimmen der Größe und Position von Steuerelementen in einer Gruppe, wenn eine Vorlage auf die Gruppe angewendet wird. Alle Elemente im selben GroupTemplate-Element müssen einen unterschiedlichen TemplateAlias-Wert haben.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Row

Strip

Vorkommen

Minimum: 0

Maximum: Unbegrenzt

Hinweise

Steuerelemente unterstützen nicht notwendigerweise alle Anzeigemodi. Die folgende Tabelle listet die Modi auf, die von allen Typen von Steuerelementen unterstützt werden.

Klein

Mittel

Groß

Menü

Menu16

Menu32

Button

X

X

X

X

X

X

CheckBox

X

X

ColorPicker

X

ComboBox

X

DropDown

X

FlyoutAnchor

X

X

X

X

X

X

GalleryButton

X

X

InsertTable

X

Label

X

X

MenuSection

X

X

MRUSplitButton

X

X

X

Spinner

X

SplitButton

X

X

X

TextBox

X

ToggleButton

X

X

X

Beispiel

Das folgende Beispiel ist ein XML-Fragment, das die Beziehung zwischen dem TemplateAlias-Attribut für Steuerelemente in einem Group-Element und dasselbe Attribut für ControlRef-Elemente in einem GroupTemplate-Element zeigt. Beachten Sie, dass das Group-Element drei Button-Elemente enthält, deren TemplateAlias-Attribut auf den Wert "row1", "row2" oder "row3" festgelegt ist. Das GroupTemplate-Element enthält auch drei ControlRef-Elemente, deren Attribute auf den Wert "row1", "row2" oder "row3" festgelegt sind. Bei Anwenden der Vorlage auf die Gruppe wird das Layout der Steuerelemente in der Gruppe durch Abgleichen des TemplateAlias-Attributs eines Button-Elements mit dem TemplateAlias-Attribut eines ControlRef-Elements bestimmt.

<Group
  Id="Ribbon.CustomTabExample.CustomGroupExample"
  Description="This is a custom group."
  Title="Custom Group"
  Sequence="52"
  Template="Ribbon.Templates.CustomTemplateExample">
  <Controls Id="Ribbon.CustomTabExample.CustomGroupExample.Controls">
    <Button
      Id="Ribbon.CustomTabExample.CustomGroupExample.HelloWorld"
      Command="CustomTabExample.HelloWorldCommand"
      Sequence="15"
      Description="Says hello to the World!"
      LabelText="Hello!"
      TemplateAlias="row1"/>
    <Button
      Id="Ribbon.CustomTabExample.CustomGroupExample.GoodbyeWorld"
      Command="CustomTabExample.GoodbyeWorldCommand"
      Sequence="17"
      Description="Says goodbye to the World!"
      LabelText="Goodbye!"
      TemplateAlias="row2"/>
    <Button
      Id="Ribbon.CustomTabExample.CustomGroupExample.LaterWorld"
      Command="CustomTabExample.LaterWorldCommand"
      Sequence="19"
      Description="Says I will see you later to the World!"
      LabelText="Later!"
      TemplateAlias="row3"/>
  </Controls>
</Group>

<GroupTemplate Id="Ribbon.Templates.CustomTemplateExample">
  <Layout
    Title="OneLargeTwoMedium"
    LayoutTitle="OneLargeTwoMedium">
    <Section Alignment="Top" Type="OneRow">
      <Row>
        <ControlRef DisplayMode="Large" TemplateAlias="row1" />
      </Row>
    </Section>
    <Section Alignment="Top" Type="TwoRow">
      <Row>
        <ControlRef DisplayMode="Medium" TemplateAlias="row2" />
      </Row>
      <Row>
        <ControlRef DisplayMode="Medium" TemplateAlias="row3" />
      </Row>
    </Section>
  </Layout>
</GroupTemplate>