ControlRef 元素
上次修改时间: 2015年3月9日
适用范围: SharePoint Foundation 2010
本文内容
属性
子元素
父元素
出现次数
备注
表示 GroupTemplate 元素中某控件的占位符。
<ControlRef
DisplayMode="Small | Medium | Large | Menu | Menu16 | Menu32"
TemplateAlias="Text"
/>
属性
属性 |
说明 |
---|---|
DisplayMode |
可选。一个确定控件呈现方式的枚举值。
|
TemplateAlias |
可选。一个控件可在其自己的 TemplateAlias 属性中引用的字符串。在对某个组应用模板时,可使用 TemplateAlias 属性调整该组中控件的大小和位置。同一 GroupTemplate 元素包含的任何两个元素都不能具有相同的 TemplateAlias 值。 |
子元素
无
父元素
出现次数
最小值:0 最大值:无限制 |
备注
控件不一定支持所有显示模式。下表列出了各个类型的控件支持的模式。
Small |
Medium |
Large |
Menu |
Menu16 |
Menu32 |
|
---|---|---|---|---|---|---|
X |
X |
X |
X |
X |
X |
|
X |
X |
|||||
X |
||||||
X |
||||||
X |
||||||
X |
X |
X |
X |
X |
X |
|
X |
X |
|||||
X |
||||||
X |
X |
|||||
X |
X |
|||||
X |
X |
X |
||||
X |
||||||
X |
X |
X |
||||
X |
||||||
X |
X |
X |
示例
下面的示例是一个 XML 片段,演示 Group 元素中控件的 TemplateAlias 属性和 GroupTemplate 元素中 ControlRef 元素的相同属性之间的关系。请注意,Group 元素包含三个 Button 元素,每个元素的 TemplateAlias 属性值设置为"row1"、"row2"或"row3"。GroupTemplate 元素也包含三个 ControlRef 元素,其属性值设置为"row1"、"row2"或"row3"。在将模板应用到该组时,将通过匹配 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>