Share via

Jewel Element

  • Article

Applies to: SharePoint Foundation 2010

Defines the Microsoft Office button.

<Jewel
  Alt="Text"
  CacheMenuVersions="TRUE | FALSE"
  Command="Text"
  CommandMenuClose="Text"
  CommandMenuOpen="Text"
  Height="Integer"
  Id="Text"
  ImageDownArrow="Url"
  ImageDownArrowClass="CSS Selector"
  ImageDownArrowLeft="Negative Integer"
  ImageDownArrowTop="Negative Integer"
  ImageSideArrow="Url"
  ImageSideArrowClass="CSS Selector"
  ImageSideArrowLeft="Negative Integer"
  ImageSideArrowTop="Negative Integer"
  ImageUpArrow="Url"
  ImageUpArrowClass="CSS Selector"
  ImageUpArrowLeft="Negative Integer"
  ImageUpArrowTop="Negative Integer"
  Image="Url"
  ImageClass="CSS Selector"
  ImageLeft="Negative Integer"
  ImageTop="Negative Integer"
  ImageHover="Url"
  ImageHoverClass="CSS Selector"
  ImageHoverLeft="Negative Integer"
  ImageHoverTop="Negative Integer"
  ImageDown="Url"
  ImageDownClass="CSS Selector"
  ImageDownLeft="Negative Integer"
  ImageDownTop="Negative Integer"
  ImageLeftSide="Url"
  ImageLeftSideClass="CSS Selector"
  ImageLeftSideLeft="Negative Integer"
  ImageLeftSideTop="Negative Integer"
  ImageLeftSideWidth="Integer"
  ImageLeftSideHover="Url"
  ImageLeftSideHoverClass="CSS Selector"
  ImageLeftSideHoverLeft="Negative Integer"
  ImageLeftSideHoverTop="Negative Integer"
  ImageLeftSideDown="Url"
  ImageLeftSideDownClass="CSS Selector"
  ImageLeftSideDownLeft="Negative Integer"
  ImageLeftSideDownTop="Negative Integer"
  ImageRightSide="Url"
  ImageRightSideClass="CSS Selector"
  ImageRightSideLeft="Negative Integer"
  ImageRightSideTop="Negative Integer"
  ImageRightSideWidth="Integer"
  ImageRightSideHover="Url"
  ImageRightSideHoverClass="CSS Selector"
  ImageRightSideHoverLeft="Negative Integer"
  ImageRightSideHoverTop="Negative Integer"
  ImageRightSideDown="Url"
  ImageRightSideDownClass="CSS Selector"
  ImageRightSideDownLeft="Negative Integer"
  ImageRightSideDownTop="Negative Integer"
  LabelCss="CSS Selector"
  LabelText="Text"
  PopulateDynamically="TRUE | FALSE"
  PopulateQueryCommand="Text"
  PopulateOnlyOnce="TRUE | FALSE"
/>

Attributes

Attribute

Description

Alt

Optional. Alternative text that is used for the control.

CacheMenuVersions

Optional. TRUE to store previously constructed versions of a dynamic menu. The default is FALSE.

Command

Optional. The name of the command to execute when the control is clicked.

CommandMenuClose

Optional. The name of the command to execute when the drop-down menu is closed.

CommandMenuOpen

Optional. The name of the command to execute when the drop-down menu is opened.

Height

Optional. The height of the control in pixels.

Id

Required. A string that identifies the element.

ImageDownArrow

Optional. A server-relative URL to a file that contains a 16-by-16-pixel image to use for the down arrow, such as "/_layouts/1033/images/formatmap16x16.png".

ImageDownArrowClass

Optional. The name of a CSS class selector to be applied to the down arrow image.

ImageDownArrowLeft

Optional. A negative integer that represents an offset for the left edge of the image. Use this attribute when the ImageDownArrow attribute points to an image file that contains the images for many icons. The value of the ImageDownArrowLeft attribute is used to set the CSS left attribute for the inline style of an HTML img tag when the page is created.

ImageDownArrowTop

Optional. A negative integer that represents an offset for the top edge of the image. Use this attribute when the ImageDownArrow attribute points to an image file that contains the images for many icons. The value of the ImageDownArrowTop attribute is used to set the CSS top attribute for the inline style of an HTML img tag when the page is created.

ImageSideArrow

Optional. A server-relative URL to a file that contains a 16-by-16-pixel image to use for the side arrow.

ImageSideArrowClass

Optional. The name of a CSS class selector to be applied to the side arrow image.

ImageSideArrowLeft

Optional. A negative integer that represents an offset for the left edge of the image.

ImageSideArrowTop

Optional. A negative integer that represents an offset for the top edge of the image.

ImageUpArrow

Optional. A server-relative URL to a file that contains a 16-by-16-pixel image to use for the up arrow, such as "/_layouts/1033/images/formatmap16x16.png".

ImageUpArrowClass

Optional. The name of a CSS class selector to be applied to the up arrow image.

ImageUpArrowLeft

Optional. A negative integer that represents an offset for the left edge of the image.

ImageUpArrowTop

Optional. A negative integer that represents an offset for the top edge of the image.

Image

Optional. A server-relative URL to a file that contains the center image.

ImageClass

Optional. The name of a CSS class selector to be applied to the image.

ImageLeft

Optional. A negative integer that represents an offset for the left edge of the image.

ImageTop

Optional. A negative integer that represents an offset for the top edge of the image.

ImageHover

Optional. A server-relative URL to a file that contains the image to replace the center image when the mouse pointer hovers over it.

ImageHoverClass

Optional. The name of a CSS class selector to be applied to the image.

ImageHoverLeft

Optional. A negative integer that represents an offset for the left edge of the image.

ImageHoverTop

Optional. A negative integer that represents an offset for the top edge of the image.

ImageDown

Optional. A server-relative URL to a file that contains the image to replace the center image when the toolbar is expanded.

ImageDownClass

Optional. The name of a CSS class selector to be applied to the image.

ImageDownLeft

Optional. A negative integer that represents an offset for the left edge of the image.

ImageDownTop

Optional. A negative integer that represents an offset for the top edge of the image.

ImageLeftSide

Optional. A server-relative URL to a file that contains the image for the left side of the jewel.

ImageLeftSideClass

Optional. The name of a CSS class selector to be applied to the image.

ImageLeftSideLeft

Optional. A negative integer that represents an offset for the left edge of the image.

ImageLeftSideTop

Optional. A negative integer that represents an offset for the top edge of the image.

ImageLeftSideWidth

Optional. The width of the image in pixels.

ImageLeftSideHover

Optional. A server-relative URL to a file that contains the image to replace the left image when the mouse pointer hovers over it.

ImageLeftSideHoverClass

Optional. The name of a CSS class selector to be applied to the image.

ImageLeftSideHoverLeft

Optional. A negative integer that represents an offset for the left edge of the image.

ImageLeftSideHoverTop

Optional. A negative integer that represents an offset for the top edge of the image.

ImageLeftSideDown

Optional. A server-relative URL to a file that contains the image to replace the left image when the toolbar is expanded.

ImageLeftSideDownClass

Optional. The name of a CSS class selector to be applied to the image.

ImageLeftSideDownLeft

Optional. A negative integer that represents an offset for the left edge of the image.

ImageLeftSideDownTop

Optional. A negative integer that represents an offset for the top edge of the image.

ImageRightSide

Optional. A server-relative URL to a file that contains the image for the right side of the jewel.

ImageRightSideClass

Optional. The name of a CSS class selector to be applied to the image.

ImageRightSideLeft

Optional. A negative integer that represents an offset for the left edge of the image.

ImageRightSideTop

Optional. A negative integer that represents an offset for the top edge of the image.

ImageRightSideWidth

Optional. The width of the image in pixels.

ImageRightSideHover

Optional. A server-relative URL to a file that contains the image to replace the right image when the mouse pointer hovers over it.

ImageRightSideHoverClass

Optional. The name of a CSS class selector to be applied to the image.

ImageRightSideHoverLeft

Optional. A negative integer that represents an offset for the left edge of the image.

ImageRightSideHoverTop

Optional. A negative integer that represents an offset for the top edge of the image.

ImageRightSideDown

Optional. A server-relative URL to a file that contains the image to replace the right image when the toolbar is expanded.

ImageRightSideDownClass

Optional. The name of a CSS class selector to be applied to the image.

ImageRightSideDownLeft

Optional. A negative integer that represents an offset for the left edge of the image.

ImageRightSideDownTop

Optional. A negative integer that represents an offset for the top edge of the image.

LabelCss

Optional. The name of a CSS class selector to be applied to the label.

LabelText

Optional. The text of the label.

PopulateDynamically

Optional. TRUE to create the menu dynamically. The default is FALSE.

PopulateOnlyOnce

Optional. TRUE to populate a dynamic menu only the first time that it is accessed.

Child Elements

Menu

Parent Elements

CommandUI

Occurrences

Minimum: 0

Maximum: 1