Partilhar via


<Controls> (RibbonDiffXml)

Aplica-se a: CRM 2016 on-prem, CRM Online

Contém uma coleção de controles.

Importante

The valid child elements of the Controls element depend on the parent element.

Sintaxe

    <CommandUIDefinition>
     <Controls
      Id="String"
      ToolTipDescription="String"
      ToolTipHelpKeyWord="String"
      ToolTipImage32by32="String"
      ToolTipImage32by32Class="String"
      ToolTipImage32by32Left="NonPositiveInteger"
      ToolTipImage32by32Top="NonPositiveInteger"
      ToolTipTitle="String">
      [ 
        <Button /> |
        <CheckBox /> |
        <ComboBox /> |
        <ColorPicker /> |
        <ContextualGroup /> |
        <Controls /> |
        <DropDown /> |
        <FlyoutAnchor /> |
        <Gallery /> |
        <GalleryButton /> |
        <GroupTemplate /> |
        <Group /> |
        <Groups /> |
        <InsertTable /> |
        <Label /> |
        <MRUSplitButton /> |
        <MaxSize /> |
        <Menu /> |
        <MenuSection /> |
        <Scale /> |
        <Scaling /> |
        <Spinner /> |
        <SplitButton /> |
        <Tab /> |
        <TextBox/> |
        <ToggleButton />
       ]
     </Controls>
    </CommandUIDefinition>
    <MenuSection>
     <Controls
      Id="String"
      ToolTipDescription="String"
      ToolTipHelpKeyWord="String"
      ToolTipImage32by32="String"
      ToolTipImage32by32Class="String"
      ToolTipImage32by32Left="NonPositiveInteger"
      ToolTipImage32by32Top="NonPositiveInteger"
      ToolTipTitle="String">
      [ 
        <ToggleButton /> |
        <Button /> |
        <ColorPicker /> |
        <FlyoutAnchor /> |
        <InsertTable /> 
       ]
     </Controls>
    </MenuSection>

Atributos e elementos

The following table lists the attributes, child elements, and parent elements.

Atributos

Attribute Description Type Usage

Id

Especifica um identificador exclusivo para a definição de um elemento de Faixa de Opções. A convenção de nomenclatura recomendável é usar um ponto para separar as partes do nome, como: [identificador da solução].[entidade].[faixa de opções].[função].[nome do elemento]. Por exemplo: MyISV.account.form.SendToOtherSystem.Button.

Use the {!EntityLogicalName} token in the Id attribute when you define a ribbon element that will be used for multiple entities. This inserts the entity logical name into the Id value to make sure that the Id value is globally unique.

For example, if you use MyISV.{!EntityLogicalName}.form.SendToOtherSystem.Button with the account entity, the Id will be MyISV.account.form.SendToOtherSystem.Button. For the contact entity, the Id will be MyISV.contact.form.SendToOtherSystem.Button.

Importante

If you don’t set a globally unique Id value, the ribbon might not display.

Importante

String

Required

ToolTipDescription

Especifica uma cadeia de caracteres a ser exibida como dica de ferramenta para um controle. Isso pode referenciar um elemento LocLabel usando a diretiva $LocLabels:, por exemplo, "$LocLabels:MyISV.account.Save.Button.Tooltip".

String

Optional

ToolTipHelpKeyWord

Esse elemento não é usado no Microsoft Dynamics CRM.

String

Optional

ToolTipImage32by32

Especifica uma imagem de 32 x 32 pixels a ser exibida com a dica de ferramenta.

String

Optional

ToolTipImage32by32Class

Especifica uma classe CSS a ser aplicada à imagem de 32 x 32 pixels a ser exibida com a dica de ferramenta.

String

Optional

ToolTipImage32by32Left

Especifica o número de pixels em que a imagem de 32 x 32 pixels da dica de ferramenta será movida para a esquerda. Isso é representado por um número negativo.

Non Positive Integer

Optional

ToolTipImage32by32Top

Especifica o número de pixels em que a imagem de 32 x 32 pixels da dica de ferramenta será movida para a parte superior. Isso é representado por um número negativo.

Non Positive Integer

Optional

ToolTipSelectedItemTitle

Esse elemento não é usado no Microsoft Dynamics CRM.

String

Optional

ToolTipShortcutKey

Esse elemento não é usado no Microsoft Dynamics CRM.

String

Optional

ToolTipTitle

Especifica uma cadeia de caracteres a ser exibida como título de uma dica de ferramenta para um controle. Esse é geralmente o mesmo valor do controle LabelText. Isso pode referenciar um elemento LocLabel usando a diretiva $LocLabels:, por exemplo, "$LocLabels:MyISV.account.Save.Button.Label".

String

Optional

Elementos filho

Element Description

<Button> (RibbonDiffXml)

Especifica um botão simples usado para executar uma ação.

<CheckBox> (RibbonDiffXml)

Especifica uma caixa de seleção usado para selecionar uma opção.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<ColorPicker> (RibbonDiffXml)

Preterido: Especificava uma grade usada para selecionar uma cor ou um estilo.

This element is only valid when Controls is a child of <MenuSection> (RibbonDiffXml)

<ComboBox> (RibbonDiffXml)

Preterido: Especificava uma lista usada para selecionar um valor clicando ou digitando.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<DropDown> (RibbonDiffXml)

Preterido: Especificava uma lista usada para selecionar um valor clicando.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<FlyoutAnchor> (RibbonDiffXml)

Especifica um botão com uma seta para baixo usada para abrir um menu.

<GalleryButton> (RibbonDiffXml)

Preterido: Especificava um controle de botão em um elemento de galeria.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<InsertTable> (RibbonDiffXml)

Preterido: Especificava uma grade de 10 x 10 usada para especificar as dimensões de uma tabela.

This element is only valid when Controls is a child of <MenuSection> (RibbonDiffXml)

<Label> (RibbonDiffXml)

Especifica uma linha de texto usada para fornecer informações.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<MRUSplitButton> (RibbonDiffXml)

Preterido: Especificava um controle de botão de divisão que exibe os itens usados mais recentemente.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<Spinner> (RibbonDiffXml)

Especifica um controle usado para inserir um valor digitando ou usando as teclas de seta para percorrer os valores.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<SplitButton> (RibbonDiffXml)

Especifica um controle usado como um botão e um menu.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<TextBox> (RibbonDiffXml)

Preterido: Especificava um controle usado para inserir texto.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<ToggleButton> (RibbonDiffXml)

Especifica um botão usado para alternar entre um estado ligado e desligado.

Elemento pai

Element Description

<Group> (RibbonDiffXml)

Especifica um grupo de controles em uma guia que compartilham um modelo de layout comum.

<CommandUIDefinition> (RibbonDiffXml)

Especifica os elementos de Faixa de Opções visíveis a serem incluídos no elemento CustomAction.

<MenuSection> (RibbonDiffXml)

Especifica uma seção usada para dividir um menu. Uma seção de menu pode ter um título e controles.

Informações do elemento

XPath

//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Controls |
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Menu/MenuSection/Controls |
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/MenuSection/Controls

Schema Name

ControlsType

Validation File

RibbonWSS.xsd

Can be Empty

Yes

Consulte também

Outros recursos

Personalizar os comandos e a faixa de opções
Ribbon XML reference

Microsoft Dynamics CRM 2016 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.