Label 要素

  • [アーティクル]

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

適用対象: SharePoint Foundation 2010

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

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

<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

オプション。アイコンとして使用する 16 x 16 ピクセルの画像を含むファイルのサーバー相対 URL ("/_layouts/1033/images/formatmap16x16.png" など)。

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

オプション。状態情報をポーリングするときに実行するコマンドの名前。

Command

オプション。ラベルがフォーカスを受け取ったときに実行するコマンドの名前。

子要素

なし

親要素

CommandUIDefinition

Controls

出現回数

最小: 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>