Label 要素 (サーバー リボン)Label element (Server Ribbon)

に適用されます: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint オンライン |SharePoint Server 2013Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

ラベル コントロールを定義します。Defines a label control.

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

要素と属性Elements and attributes

以下のセクションで、属性、子要素、親要素について説明します。The following sections describe attributes, child elements, and parent elements.

属性Attributes

属性Attribute 説明Description
ForIdForId
オプション。このコントロールによってラベルが付けられるコントロールの ID。Optional. The ID of the control that this control labels.
IdId
必須。コントロールを識別する文字列 ("Ribbon.Image.Image.Size.HorizontalSizeLabel" など)。Required. A string that identifies the control, such as "Ribbon.Image.Image.Size.HorizontalSizeLabel".
LabelTextLabelText
オプション。ラベルのテキスト。Optional. The text of the label.
Image16by16Image16by16
省略可能。Optional. 次のように、アイコンとして使用する 16 x 16 ピクセル画像を含むファイルへの相対 URL"/_layouts/1033/images/formatmap16x16.png"です。A server-relative URL to a file that contains a 16-by-16-pixel image to be used as an icon, such as "/_layouts/1033/images/formatmap16x16.png".
Image16by16ClassImage16by16Class
オプション。画像に適用される CSS クラス セレクターの名前。Optional. The name of a CSS class selector to be applied to the image.
Image16by16LeftImage16by16Left
オプション。画像の左端のオフセットを表す負の整数。Image16by16 属性が、多くのアイコン画像を含む画像ファイルを指している場合に、この属性を使用します。Image16by16Left 属性の値は、HTML img タグのインライン スタイルの CSS left 属性を設定するために使用します。Optional. A negative integer that represents an offset for the left edge of the image. Use this attribute when the Image16by16 attribute points to an image file that contains images for many icons. The value of the Image16by16Left attribute is used to set the CSS left attribute for the inline style of an HTML img tag.
Image16by16TopImage16by16Top
オプション。画像の上端のオフセットを表す負の整数。Image16by16 属性が、多くのアイコンの画像を含む画像ファイルを指定している場合に、この属性を使用します。Image16by16Top 属性の値は、HTML img タグのインライン スタイルの CSS top 属性を設定するために使用します。Optional. A negative integer that represents an offset for the top edge of the image. Use this attribute when the Image16by16 attribute points to an image file that contains images for many icons. The value of the Image16by16Top attribute is used to set the CSS top attribute for the inline style of an HTML img tag.
SequenceSequence
オプション。兄弟 XML ノード間の配置順序を指定する整数。Optional. An integer that specifies the order of placement among sibling XML nodes.
TemplateAliasTemplateAlias
オプション。GroupTemplate 要素内の ControlRef 要素、OverflowArea 要素、または OverflowSection 要素の TemplateAlias 属性の値に一致する文字列。TemplateAlias 属性は、テンプレートをグループに適用するときにグループ内でコントロールのサイズと位置を調整するために使用されます。Optional. A string that matches the value of the TemplateAlias attribute for a ControlRef element, an OverflowArea element, or an OverflowSection element in a GroupTemplate element. The TemplateAlias attribute is used to size and position controls within a group when a template is applied to the group.
QueryCommandQueryCommand
オプション。状態情報をポーリングするときに実行するコマンドの名前。Optional. The name of the command to execute when polling for state information.
CommandCommand
オプション。ラベルがフォーカスを受け取ったときに実行するコマンドの名前。Optional. The name of the command to execute when the label receives focus.

子要素Child elements

なしNone

親要素Parent elements

出現回数Occurrences

  • 最小 : 0Minimum: 0
  • 最大 : 1Maximum: 1

Example

以下の XML フラグメントは、2 つのテキスト ボックス コントロールとそのコントロールの 2 つのラベルが含まれる Controls 要素を示しています。The following example is an XML fragment that shows a Controls element that contains two text box controls and two labels for them.

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