Propriedade IRibbonControl.Tag (Office)

  • Artigo

Usado para armazenar sequências de caracteres arbitrárias e buscá-las no tempo de execução. Somente leitura.

Sintaxe

expressão. Tag

Expressão Uma expressão que retorna um objeto IRibbonControl .

Valor de retorno

Cadeia de caracteres

Comentários

Normalmente, você pode distinguir entre controles em um arquivo de personalização XML da interface do usuário do Ribbon usando a propriedade Id . No entanto, existem restrições sobre o que podem conter IDs (sem caracteres não alfanuméricos e eles devem ser todos exclusivo). A propriedade Tag não tem essas restrições, portanto, pode ser usada nas seguintes situações, em que a ID não funciona:

  • Se você precisar armazenar uma sequência especial de caracteres com seu controle, como nome de arquivo. Por exemplo: tag="C:\path\file.xlsm."

  • Se você quiser que vários controles sejam tratados da mesma maneira pelos procedimentos de retorno de chamada, mas não deseja manter uma lista de todas as suas IDs (que devem ser exclusivas). Por exemplo, você pode ter botões em guias diferentes na Faixa de Opções, tudo com tag="blue" e, em seguida, basta escolher a propriedade Tag em vez da propriedade ID ao perfroming algumas ações comuns.

Exemplo

No XML usado para personalizar a interface do usuário da faixa de opções, você pode definir uma marca da seguinte maneira. Quando a ação MyFunction é chamada, você pode ler a propriedade Tag, que será igual a "alguma cadeia de caracteres".

<button id="mybutton" tag="some string" onAction="MyFunction"/>

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.