ControlRef 要素

最終更新日: 2015年3月9日

適用対象: SharePoint Foundation 2010

この記事の内容
属性
子要素
親要素
出現回数
解説

GroupTemplate 要素内のコントロールのプレースホルダーを表します。

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

属性

属性

説明

DisplayMode

オプション。コントロールのレンダリング方法を決定する列挙値。

  • Small。ラベル テキストなしの小さなアイコンとしてレンダリングします。

  • Medium。ラベル テキスト付きの 16 x 16 ピクセルのアイコンとしてレンダリングされます。

  • Large。ラベル テキスト付きの 32 x 32 ピクセルのアイコンとしてレンダリングされます。

  • Menu。テキストのみのメニュー項目としてレンダリングされます。

  • Menu16。16 x 16 ピクセルのアイコンを持つメニュー項目としてレンダリングされます。

  • Menu32。32 x 32 ピクセルのアイコンを持つメニュー項目としてレンダリングされます。

TemplateAlias

オプション。コントロールが自身の TemplateAlias 属性内で参照できる文字列。TemplateAlias 属性は、テンプレートをグループに適用するときにグループ内でコントロールのサイズと位置を調整するために使用されます。同じ GroupTemplate 要素に含まれる 2 つの要素が、同じ TemplateAlias 値を持つことはできません。

子要素

なし

親要素

Row

Strip

出現回数

最小: 0

最大: 制約なし

解説

コントロールは、必ずしもすべての表示モードをサポートするとは限りません。以下の表に、コントロールの各種類でサポートされるモードを示します。

Small

Medium

Large

Menu

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

以下の例は、Group 要素内のコントロールの TemplateAlias 属性と、GroupTemplate 要素内の ControlRef 要素の同じ属性との関係を示す XML フラグメントです。Group 要素には、3 つの Button 要素が含まれています。各要素に TemplateAlias 属性があり、それぞれ値 "row1"、"row2"、"row3" に設定されています。GroupTemplate 要素にも、値 "row1"、"row2"、"row3" に設定された属性を持つ 3 つの ControlRef 要素が含まれています。テンプレートをグループに適用すると、Button 要素の TemplateAlias 属性と ControlRef 要素の TemplateAlias 属性が照合されて、グループ内のコントロールのレイアウトが決まります。

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