Tab element

Represents a core or contextual tab.

Usage

<Tab
  ApplicationModes = "xs:string"
  CommandName = "xs:positiveInteger or xs:string">
  child elements
</Tab>

Attributes

AttributeTypeRequiredDescription

ApplicationModes

xs:string

No

Valid only if MenuGroup is the parent element.

(xs:string)

A string that contains a comma-separated list of integers between 0 and 31.

White space is valid and ignored.

Maximum length: 250 characters.

CommandName

xs:positiveInteger or xs:string

No

Associates the element with a Command.

(xs:positiveInteger or xs:string)

A string, an integer value between 2 and 59999, inclusive, or a hexadecimal value between 0x2 and 0xea5f, inclusive.

The value must be unique within the Ribbon XML document.

Maximum length: 100 characters.

Child elements

ElementDescription

Group

May occur one or more times

Tab.ScalingPolicy

May occur at most once

Parent elements

Element

Ribbon.Tabs

TabGroup

Remarks

Required.

Must occur at least once for each Ribbon.Tabs or TabGroup element.

Tab supports application modes.

If ScalingPolicy.IdealSizes is present for the Tab element, then an entry for each Group element and its ideal size is required under ScalingPolicy.IdealSizes.

Examples

The following example demonstrates the basic markup for the Tab element.

This section of code shows the Tab Command declarations for a Home tab.


<Command Name="cmdHomeTab"
         LabelTitle="Home"
         Keytip="H" />
<Command Name="cmdClipboardGroup"
         Symbol="IDR_CMD_CLIPBOARD"
         Id="10000"
         Comment="Command definition for clipboard group"
         LabelTitle="Clipboard"
         Keytip="CB" />
<Command Name="cmdCopy"
         Symbol="IDR_CMD_COPY"
         LabelTitle="Copy"
         LabelDescription="Copy"
         Keytip="C"
         TooltipTitle="Copy"
         TooltipDescription="Click to copy">
  <Command.SmallImages>
    <Image>res/copyS_16.bmp</Image>
  </Command.SmallImages>
  <Command.LargeImages>
    <Image>res/copyL_32.bmp</Image>
  </Command.LargeImages>
</Command>
<Command Name="cmdPaste"
         Symbol="IDR_CMD_PASTE" >
  <Command.LabelTitle>Paste</Command.LabelTitle>
  <Command.LabelDescription>
    <String Content="Paste contents of clipboard"
            Id="10001"
            Symbol="IDR_RES_LABELDESC_PASTE" />
  </Command.LabelDescription>
  <Command.Keytip>P</Command.Keytip>
  <Command.TooltipTitle>
    <String Content="Paste contents of clipboard"
            Id="10002"
            Symbol="IDR_RES_TOOLTIP_PASTE"/>
  </Command.TooltipTitle>
  <Command.TooltipDescription>
    <String Content="Click to paste contents of clipboard"/>
  </Command.TooltipDescription>
  <Command.SmallImages>
    <Image
      Id="10010"
      MinDPI="96"
      Symbol="IDR_RES_SMALL_IMAGE96">
      <Image.Source>res/pasteS_96bpp.bmp</Image.Source>
    </Image>
    <Image Source="res/pasteS_120bpp.bmp"
           Id="10011"
           MinDPI="120"
           Symbol="IDR_RES_SMALL_IMAGE120" />
  </Command.SmallImages>
  <Command.LargeImages>
    <Image>res/pasteL_32.bmp</Image>
  </Command.LargeImages>
</Command>
<Command Name="cmdMinimize"
         Symbol="IDR_CMD_MINIMIZE"
         Id="10001"
         LabelTitle="Minimize" />


This section of code shows the Tab control declarations.


<Tab CommandName="cmdHomeTab">
  <Group CommandName="cmdClipboardGroup" 
         SizeDefinition="ThreeButtons">
    <Button CommandName="cmdCopy"/>
    <Button CommandName="cmdPaste"/>
    <ToggleButton CommandName="cmdMinimize"/>
  </Group>
</Tab>


Element information

Minimum supported system

Windows 7
Can be emptyNo

See also

Tab control
Tab Group control
SetModes

 

 

Community Additions

ADD
Show:
© 2014 Microsoft