Unit element (Spinner) (Server Ribbon)

Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Defines a unit for use within the spinner control.

<Unit
  Name="Text"
  MinimumValue="Decimal"
  MaximumValue="Decimal"
  DecimalDigits="Integer"
  Interval="Double"
/>

Elements and attributes

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description
Name
Optional. The name of the unit, such as inches, pixels, or percent.
MinimumValue
Optional. The minimum acceptable value.
MaximumValue
Optional. The maximum acceptable value.
DecimalDigits
Optional. The number of decimal digits to display.
Interval
Optional. The amount by which the value should be incremented or decremented.

Child elements

Parent elements

Occurrences

  • Minimum: 1
  • Maximum: unbounded

Example

The following XML example defines a spinner control that contains several units.

<Spinner
   Id="Ribbon.Table.Layout.Properties.TableWidth"
   DefaultUnit="inch"
   DefaultValue="1.5"
   AltUpArrow="$Resources:core,cui_spnUpAlt;"
   AltDownArrow="$Resources:core,cui_spnDownAlt;"
   AccelerationInterval="125"
   MultiplierInterval="2000"
   Command="SetTableWidth"
   ImeEnabled="false"
   QueryCommand="QueryTableWidth"
   ToolTipTitle="$Resources:core,LabelTableWidth;"
   ToolTipDescription="$Resources:core,cui_stt_ButWidthHeightMenuTableWidthTooltip;"
   Sequence="30"
   TemplateAlias="o1"
>
  <Unit
      Name="inch"
      MinimumValue="0.1"
      MaximumValue="200"
      DecimalDigits="1"
      Interval="0.1"
  >
    <UnitAbbreviation Value="in" />
    <UnitAbbreviation Value="&amp;quot;"/>
  </Unit>
  <Unit
      Name="pixel"
      MinimumValue="1"
      MaximumValue="2000"
      DecimalDigits="0"
      Interval="5"
  >
    <UnitAbbreviation Value="px" />
  </Unit>
  <Unit
      Name="centimeter"
      MinimumValue="0.1"
      MaximumValue="500"
      DecimalDigits="1"
      Interval="0.5"
  >
    <UnitAbbreviation Value="cm" />
  </Unit>
  <Unit
      Name="percent"
      MinimumValue="1"
      MaximumValue="100"
      DecimalDigits="0"
      Interval="1"
  >
    <UnitAbbreviation Value="%" />
  </Unit>
</Spinner>