Método CommandBar.ShowPopup (Office)
Exibe uma barra de comandos como um menu de atalho nas coordenadas especificadas ou nas coordenadas atuais do ponteiro.
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 Visão geral da faixa de opções fluente do Office.
Sintaxe
expressão. ShowPopup(x, y)
Expressão Uma variável que representa um objeto CommandBar .
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| x | Opcional | Variantes | A coordenada x na qual o local do menu de atalho se baseia. Se esse argumento for omitido, a coordenada x atual do ponteiro será usada. |
| y | Opcional | Variantes | A coordenada y na qual o local do menu de atalho é baseado. Se esse argumento for omitido, a coordenada y atual do ponteiro será usada. |
Comentários
Quando os menus são alinhados à esquerda, o menu de atalho exibido pelo método ShowPopup tem seu canto superior esquerdo em (x, y + 1); quando os menus estão alinhados à direita, o menu de atalho tem seu canto superior direito em (x + 1, y + 1). Use a função Do Windows GetSystemMetrics(SM_MENUDROPALIGNMENT) para verificar a métrica do sistema para alinhamento de menu suspenso.
Quando o local da tela das coordenadas (x, y) faria com que todo ou parte do menu pop-up fosse exibido além da borda da tela visível, o menu pop-up muda para se encaixar na área visível.
Exemplo
Este exemplo cria um menu de atalho contendo dois controles. O método ShowPopup é usado para tornar visível o menu de atalho.
Set myBar = CommandBars _
.Add(Name:="Custom", Position:=msoBarPopup, Temporary:=False)
With myBar
.Controls.Add Type:=msoControlButton, Id:=3
.Controls.Add Type:=msoControlComboBox
End With
myBar.ShowPopup
Observação
Se a propriedade Position da barra de comandos não estiver definida como msoBarPopup, esse método irá falhar.
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.