Compartir a través de

Elemento CheckBox (cinta de opciones del servidor)

Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Define un control de casilla de verificación.

<CheckBox
     Alt="Text"
     Command="Text"
     Id="Text"
     LabelText="Text"
     MenuItemId="Text"
     QueryCommand="Text"
     Sequence="Integer"
     TemplateAlias="Text"
     ToolTipImage32by32="Url"
     ToolTipImage32by32Class="CSS Class Selector"
     ToolTipImage32by32Left="Negative Integer"
     ToolTipImage32by32Top="Negative Integer"
     ToolTipTitle="Text"
     ToolTipDescription="Text"
     ToolTipHelpKeyWord="Text"
     ToolTipShortcutKey="Text"
/>

Elementos y atributos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo Descripción
Alt
Opcional. Texto alternativo que se usa para la casilla de verificación.
Command
Opcional. Nombre del comando que se va a ejecutar cuando se selecciona el control. Si el control está en un elemento CommandUIDefinition, el valor del atributo Command del control debe ser el mismo que el valor del atributo Command de un elemento CommandUIHandler correspondiente.
Id
Necesario. Identifica el control. El valor puede ser una representación de cadena de un GUID o un término único, como "Ribbon.Library.Share.NewRibbonCheckBox".
LabelText
Opcional. El texto para etiquetar el control.
MenuItemId
Opcional. Cadena que identifica el elemento de menú en el que se ubica el botón.
QueryCommand
Opcional. El nombre del comando que debe ejecutarse cuando se realiza un sondeo de la información de estado.
Sequence
Opcional. Entero que especifica el orden de colocación entre nodos XML del mismo nivel.
TemplateAlias
Opcional. Cadena que coincide con el valor del atributo TemplateAlias de un elemento ControlRef, un elemento OverflowArea o un elemento OverflowSection en un elemento GroupTemplate. El atributo TemplateAlias se usa para cambiar el tamaño de los controles y posicionarlos dentro de un grupo cuando se aplica una plantilla al grupo.
ToolTipImage32by32
Opcional. Dirección URL relativa al servidor a un archivo que contiene una imagen de 32 por 32 píxeles que se usará en la información sobre herramientas, como "/_layouts/1033/images/formatmap32x32.png".
ToolTipImage32by32Class
Opcional. Nombre de un selector de clases CSS que se aplicará a la imagen de la información sobre herramientas.
ToolTipImage32by32Left
Opcional. Entero negativo que representa un desplazamiento del borde izquierdo de la imagen. Use este atributo cuando el atributo ToolTipImage32by32 señale a un archivo de imagen que contenga imágenes de varios iconos. El valor del atributo ToolTipImage32by32Left se usa para establecer el atributo left de CSS para el estilo en línea de una etiqueta HTML img.
ToolTipImage32by32Top
Opcional. Entero negativo que representa un desplazamiento del borde superior de la imagen. Use este atributo cuando el atributo ToolTipImage32by32 señale a un archivo de imagen que contenga las imágenes de varios iconos. El valor del atributo ToolTipImage32by32Top se usa para establecer el atributo top de CSS para el estilo en línea de una etiqueta HTML img.
ToolTipTitle
Opcional. Texto que aparece como título de la información sobre herramientas.
ToolTipDescription
Opcional. Texto que aparece en el cuerpo de la información sobre herramientas.
ToolTipHelpKeyWord
Opcional. Palabra clave que se usa en la ayuda contextual.
ToolTipShortcutKey
Opcional. El texto para mostrar en la tecla de método abreviado de la información sobre herramientas. Por ejemplo, si la tecla de método abreviado del control es Alt+J, el valor de este atributo es "Alt+J". La información sobre herramientas mostrará el texto de la tecla de método abreviado entre paréntesis después del título de la información sobre herramientas: "(Alt+J)".

Elementos secundarios

Ninguno

Elementos principales

Repeticiones

  • Mínimo: 0
  • Máximo: sin límite

Ejemplo

El ejemplo siguiente es un fragmento de XML que define un grupo de controles que incluye un elemento CheckBox.

<Group
  Id="Ribbon.Image.Image.Size"
  Sequence="50"
  Command="ImageSizeGroup"
  Description=""
  Title="$Resources:core,GrpSize;"
  Image32by32Popup="/_layouts/$Resources:core,Language;/images/formatmap32x32.png" Image32by32PopupTop="-128" Image32by32PopupLeft="0"
  Template="Ribbon.Templates.Flexible2"
>
  <Controls Id="Ribbon.Image.Image.Size.Controls">
    <Label
      Id="Ribbon.Image.Image.Size.HorizontalSizeLabel"
      LabelText="$Resources:core,LabelHorizSize;"
      Command="ImageHorizontalLabel"
      ForId="Ribbon.Image.Image.Size.HorizontalSize"
      Image16by16="/_layouts/$Resources:core,Language;/images/formatmap16x16.png" Image16by16Top="-80" Image16by16Left="-16"
      TemplateAlias="o1"
      Sequence="10"
    />
    <Spinner
       Id="Ribbon.Image.Image.Size.HorizontalSize"
       DefaultUnit="pixel"
       DefaultValue="10"
       AltUpArrow="$Resources:core,cui_spnUpAlt;"
       AltDownArrow="$Resources:core,cui_spnDownAlt;"
       AccelerationInterval="125"
       MultiplierInterval="2000"
       ImeEnabled="false"
       Command="ImageWidth"
       QueryCommand="QueryImageWidth"
       ToolTipTitle="$Resources:core,LabelHorizSize;"
       ToolTipDescription="$Resources:core,cui_stt_ButSizeMenuHorizontalSizeTooltip;"
       TemplateAlias="o2"
      Sequence="20"
    >
      <Unit
          Name="pixel"
          MinimumValue="1"
          MaximumValue="2000"
          DecimalDigits="0"
          Interval="5"
        >
        <UnitAbbreviation Value="px" />
      </Unit>
      <Unit
          Name="percent"
          MinimumValue="1"
          MaximumValue="100"
          DecimalDigits="0"
          Interval="1"
        >
        <UnitAbbreviation Value="%" />
      </Unit>
    </Spinner>
    <Label
      Id="Ribbon.Image.Image.Size.VertSizeLabel"
      LabelText="$Resources:core,LabelVertSize;"
      Command="ImageVerticalLabel"
      ForId="Ribbon.Image.Image.Size.VerticalSize"
      Image16by16="/_layouts/$Resources:core,Language;/images/formatmap16x16.png" Image16by16Top="-208" Image16by16Left="-224"
      TemplateAlias="o1"
      Sequence="30"
    />
    <Spinner
      Id="Ribbon.Image.Image.Size.VerticalSize"
      DefaultUnit="pixel"
      DefaultValue="10"
      AltUpArrow="$Resources:core,cui_spnUpAlt;"
      AltDownArrow="$Resources:core,cui_spnDownAlt;"
      AccelerationInterval="125"
      MultiplierInterval="2000"
      Command="ImageHeight"
      ImeEnabled="false"
      QueryCommand="QueryImageHeight"
      ToolTipTitle="$Resources:core,LabelVertSize;"
      ToolTipDescription="$Resources:core,cui_stt_ButSizeMenuVerticalSizeTooltip;"
      TemplateAlias="o2"
      Sequence="40"
    >
      <Unit
          Name="pixel"
          MinimumValue="1"
          MaximumValue="2000"
          DecimalDigits="0"
          Interval="5"
        >
        <UnitAbbreviation Value="px" />
      </Unit>
      <Unit
          Name="percent"
          MinimumValue="1"
          MaximumValue="100"
          DecimalDigits="0"
          Interval="1"
        >
        <UnitAbbreviation Value="%" />
      </Unit>
    </Spinner>
    <CheckBox
      Id="Ribbon.Image.Image.Size.LockAspect"
      Command="ImageLockRatio"
      QueryCommand="QueryImageLockRatio"
      LabelText="$Resources:core,LabelLockAspect;"
      Alt="$Resources:core,ButLockAspectAlt;"
      TemplateAlias="o2"
      Sequence="50"
    />
  </Controls>
</Group>
  • Last updated on