Partilhar via


<TextBox> (RibbonDiffXml)

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Preterido: especificava um controle usado para inserir texto.

Importante

Este controle foi desativado no Microsoft Dynamics CRM 2011. Este controle não renderizará com o Microsoft Dynamics 365 (online e local).

Sintaxe

<TextBox
 Command="String"
 Id="String"
 ImeEnabled =["0" | "1" | "true" | "false"]
 MaxLength="Integer"
 QueryCommand="String"
 Sequence="Integer"
 ShowAsLabel =["0" | "1" | "true" | "false"]
 TemplateAlias="String"
 ToolTipDescription="String"
 ToolTipHelpKeyWord="String"
 ToolTipImage32by32="String"
 ToolTipImage32by32Class="String"
 ToolTipImage32by32Left="Non Positive Integer"
 ToolTipImage32by32Top="Non Positive Integer"
 ToolTipShortcutKey="String"
 ToolTipTitle="String"
 Width="String"
 />

Atributos e Elementos

O diagrama a seguir descreve os atributos, os elementos filho e elementos principais.

Atributos

Atributo

Descrição

Tipo

Uso

Comando

Especifica a ID do comando da faixa de opções deste controle.

Cadeia de caracteres

Opcional

ID

Especifica um identificador exclusivo para a definição de um elemento da 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 o token {!EntityLogicalName} no atributo Id quando você definir um elemento da faixa de opções que será usado para várias entidades. Isso insere o nome lógico da entidade no valor Id para garantir que o valor de ID é globalmente exclusivo.

Por exemplo, se você usar MyISV.{!EntityLogicalName}.form.SendToOtherSystem.Button com a entidade conta, a Id será MyISV.account.form.SendToOtherSystem.Button. Para a entidade de contato, a Id será MyISV.contact.form.SendToOtherSystem.Button.

Importante

Se você não definir um valor de Id exclusivo global, a faixa de opções não pode ser exibida.

Cadeia de caracteres

Obrigatório

ImeEnabled

Especifica se o estado ativo de um IME está habilitado. Um IME permite digitar e editar caracteres em chinês, japonês e coreano. Os IMEs podem estar em um estado ativo ou inativo. O estado ativo aceita caracteres em chinês, japonês ou coreano. O estado inativo tem comportamento semelhante ao de um teclado normal e usa um conjunto limitado de caracteres.

Booliano

Opcional

MaxLength

O número máximo de caracteres que o usuário pode inserir.

Inteiro

Opcional

QueryCommand

Especifica o nome do comando a ser executado durante a sondagem das informações de estado.

Cadeia de caracteres

Opcional

Sequência

Especifica o local da modificação da faixa de opções definindo o valor da Sequência como um número mais alto ou mais baixo que os elementos existentes da faixa de opções.

Inteiro

Opcional

ShowAsLabel

Definir para TRUE para desabilitar a caixa de texto de forma que não responda a entrada do usuário e pareça o mesmo que um controle <Label> (RibbonDiffXml). O valor padrão é FALSE.

Cadeia de caracteres

Opcional

TemplateAlias

Associa o filho de um elemento de faixa de opções de CommandUIDefinition com um espaço reservado de local no filho de um elemento Layout. Esse valor define onde o controle será exibido em um grupo de controles quando o layout for alterado.

Observação

Este elemento não pode ser associado a um alias de modelo que representa um elemento <OverflowSection> (RibbonDiffXml) ou um elemento <ControlRef> (RibbonDiffXml) que usa o modo de exibição grande.

Cadeia de caracteres

Opcional

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".

Cadeia de caracteres

Opcional

ToolTipHelpKeyWord

Este elemento não é usado no Microsoft Dynamics 365.

Cadeia de caracteres

Opcional

ToolTipImage32by32

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

Cadeia de caracteres

Opcional

ToolTipImage32by32Class

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

Cadeia de caracteres

Opcional

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.

Não inteiro positivo

Opcional

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.

Não inteiro positivo

Opcional

ToolTipShortcutKey

Este elemento não é usado no Microsoft Dynamics 365.

Cadeia de caracteres

Opcional

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".

Cadeia de caracteres

Opcional

Largura

Especifica uma largura desejada para o controle em pixels.

Cadeia de caracteres

Opcional

Elementos Filho

Este elemento não tem elementos filho.

Elementos Pai

Elemento

Descrição

<CommandUIDefinition> (RibbonDiffXml)

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

<Controls> (RibbonDiffXml)

Contém uma coleção de controles.

Informações do Elemento

XPath

//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/TextBox |
//Controls/TextBox

Nome do Esquema

TextBoxType

Arquivo de Validação

RibbonWSS.xsd

Pode estar vazio

Sim

Confira Também

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

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais