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
省略可能。Optional. イメージの左端までのオフセットを表す負の整数です。A negative integer that represents an offset for the left edge of the image. Image16by16属性は、多くのアイコンのイメージを含むイメージ ファイルをポイントしたときは、この属性を使用します。Use this attribute when the Image16by16 attribute points to an image file that contains images for many icons. インライン スタイルは、HTML のimgタグの CSS のleft属性を設定するのにはImage16by16Left属性の値を使用します。The value of the Image16by16Left attribute is used to set the CSS left attribute for the inline style of an HTML img tag.
Image16by16TopImage16by16Top
省略可能。Optional. イメージの上端の座標のオフセットを表す負の整数です。A negative integer that represents an offset for the top edge of the image. Image16by16属性は、多くのアイコンのイメージを含むイメージ ファイルをポイントしたときは、この属性を使用します。Use this attribute when the Image16by16 attribute points to an image file that contains images for many icons. HTML のimgタグのインライン スタイルの CSSの属性を設定するのにはImage16by16Top属性の値を使用します。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
省略可能。Optional. ControlRef要素、 OverflowAreaの要素、またはため要素内のOverflowSection要素のTemplateAlias属性の値に一致する文字列です。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. TemplateAlias属性は、サイズを使用し、テンプレートと、グループ内での位置のコントロールがグループに適用します。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

次の使用例は、それらの 2 つのテキスト ボックス コントロールと 2 つのラベルを含むコントロール要素を表示する XML フラグメントです。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>