Compartilhar via


CommandBars.FindControls method (Office) (Método CommandBars.FindControls [Office])

Obtém a coleção CommandBarControls que se adequa aos critérios especificados.

Observação

[!OBSERVAçãO] O uso de CommandBars em alguns aplicativos do Microsoft Office foi substituído pelo novo componente da faixa de opções da interface de usuário do Microsoft Office Fluent. Para obter mais informações, consulte Descrição geral do friso do Office Fluent.

Sintaxe

expressão. FindControls (Tipo, ID, Etiqueta, Visível)

expressão Uma variável que representa um objeto CommandBars .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Type Opcional Variant É uma das constantes msoControlType que especifica o tipo de controlo.
Id Opcional Variant O identificador do controlo.
Tag Opcional Variant O valor da etiqueta do controlo.
Visible Opcional Variant Verdadeiro para incluir apenas controlos de barra de comando visíveis na pesquisa. O valor padrão é False.

Valor de retorno

CommandBarControls

Comentários

Se não forem encontrados controlos que se ajustem aos critérios, o método FindControls devolve Nada.

Exemplo

Este exemplo utiliza o método FindControls para devolver todos os membros da coleção CommandBars que têm um ID de 18 e apresenta (numa caixa de mensagem) o número de controlos que cumprem os critérios de pesquisa.

Dim myControls As CommandBarControls 
Set myControls = CommandBars.FindControls(Type:=msoControlButton, ID:=18) 
MsgBox "There are " & myControls.Count & _ 
    " controls that meet the search criteria."

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.