Label 要素 (サーバー リボン)

  • [アーティクル]

適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

ラベル コントロールを定義します。

<Label
  ForId="Text"
  Id="Text"
  LabelText="Text"
  Image16by16="Url"
  Image16by16Class="CSS Class Selector"
  Image16by16Left="Negative Integer"
  Image16by16Top="Negative Integer"
  Sequence="Integer"
  TemplateAlias="Text"
  QueryCommand="Text"
  Command="Text"
/>

要素と属性

以下のセクションで、属性、子要素、親要素について説明します。

属性

属性 説明
ForId
オプション。 このコントロールによってラベルが付けられるコントロールの ID。
Id
必須です。 コントロールを識別する文字列 ("Ribbon.Image.Image.Size.HorizontalSizeLabel" など)。
LabelText
オプション。 ラベルのテキスト。
Image16by16
オプション。 "/_layouts/1033/images/formatmap16x16.png" などのアイコンとして使用される 16 x 16 ピクセルのイメージを含むファイルへのサーバー相対 URL。
Image16by16Class
オプション。 画像に適用される CSS クラス セレクターの名前。
Image16by16Left
オプション。 画像の左端のオフセットを表す負の整数。 Image16by16 属性が、多くのアイコンの画像を含む画像ファイルを指定している場合に、この属性を使用します。 Image16by16Left 属性の値は、HTML img タグのインライン スタイルの CSS left 属性を設定するために使用します。
Image16by16Top
オプション。 画像の上端のオフセットを表す負の整数。 Image16by16 属性が、多くのアイコンの画像を含む画像ファイルを指定している場合に、この属性を使用します。 Image16by16Top 属性の値は、HTML img タグのインライン スタイルの CSS top 属性を設定するために使用します。
Sequence
オプション。 兄弟 XML ノード間の配置順序を指定する整数。
TemplateAlias
オプション。 GroupTemplate 要素内の ControlRef 要素、OverflowArea 要素、または OverflowSection 要素の TemplateAlias 属性の値に一致する文字列。 TemplateAlias 属性は、テンプレートをグループに適用するときにグループ内でコントロールのサイズと位置を調整するために使用されます。
QueryCommand
オプション。 状態情報をポーリングするときに実行するコマンドの名前。
コマンド
オプション。 ラベルがフォーカスを受け取ったときに実行するコマンドの名前。

子要素

None

親要素

Occurrences

  • 最小 : 0
  • 最大 : 1

例

以下の XML フラグメントは、2 つのテキスト ボックス コントロールとそのコントロールの 2 つのラベルが含まれる Controls 要素を示しています。

<Controls Id="Ribbon.Link.Link.Properties.Controls">
  <Label
    Id="Ribbon.Link.Link.Properties.LinkAddressLabel"
    LabelText="$Resources:core,LabelLinkAddress;"
    Command="LinkUrlLabel"
    ForId="Ribbon.Link.Link.Properties.LinkAddress"
    Sequence="10"
    Image16by16="/_layouts/$Resources:core,Language;/images/formatmap16x16.png" Image16by16Top="-160" Image16by16Left="-224"
    TemplateAlias="o1"/>
  <TextBox
    Id="Ribbon.Link.Link.Properties.LinkAddress"
    Command="LinkUrlChanged"
    ToolTipTitle="$Resources:core,cui_LinkAddress;"
    ToolTipDescription="$Resources:core,cui_STT_LinkAddress;"
    QueryCommand="QueryLinkUrl"
    MaxLength="512"
    TemplateAlias="o2"
    Sequence="20"
                />
  <Label
    Id="Ribbon.Link.Link.Properties.LinkTooltipLabel"
    LabelText="$Resources:core,LabelLinkTooltip;"
    Command="LinkAltLabel"
    ForId="Ribbon.Link.Link.Properties.LinkTooltip"
    Image16by16="/_layouts/$Resources:core,Language;/images/formatmap16x16.png" Image16by16Top="0" Image16by16Left="-88"
    Sequence="30"
    TemplateAlias="o1"/>
  <TextBox
    ToolTipTitle="$Resources:core,cui_LinkTooltip;"
    ToolTipDescription="$Resources:core,cui_STT_LinkTooltip;"
    Id="Ribbon.Link.Link.Properties.LinkTooltip"
    Command="LinkTitleChanged"
    QueryCommand="QueryLinkTitle"
    MaxLength="128"
    Sequence="40"
    TemplateAlias="o2"/>
</Controls>