Menu (gb.qt4)
Esta classe representa um menu pop-up, ou um elemento de um menu popup.
Properties
Action
|
Retorna ou define a sequência de ação associado ao controle.
|
Caption
|
Um sinônimo para a propriedade Text.
|
Checked
|
Indica se um menu está marcado.
|
Children
|
Retorna uma coleção de cada filho do menu.
|
Closed
|
|
Enabled
|
Indica se o menu está habilitado.
|
Name
|
Retorna ou define o nome do controle menu.
|
Parent
|
|
Picture
|
Retorna ou define o ícone exibido no menu.
|
Proxy
|
|
Radio
|
Retorna ou define se um menu funciona como um botão rádio.
|
Shortcut
|
Retorna ou define o nome de atalho do menu.
|
Tag
|
Retorna ou define o tag associado ao menu.
|
Text
|
Retorna ou define o texto exibido no menu.
|
Toggle
|
Retorna ou define se o Menu atua como uma alternância (toggle).
|
Value
|
Um sinônimo para a propriedade Checked.
|
Visible
|
Indica se o menu é visível.
|
Window
|
Retorna a que Window este Menu pertence.
|
Methods
Close
|
|
Delete
|
Deleta o menu.
|
Hide
|
Oculta o menu.
|
Popup
|
Abra o menu sob o mouse, e espera até que seja fechado.
|
Show
|
Mostra o menu.
|
Events
Click
|
Gerado quando o usuário clicar no menu.
|
Hide
|
Este evento é gerado logo após o menu ficar oculto.
|
Show
|
Gerado pouco antes do menu ser mostrado.
|
Criando um menu popup.
Um menu pop-up é construído através da criação de uma árvore de hierarquia de objetos de Menu
-
Cada menu filho da hierarquia torna-se um sub-menu.
-
Cada folha da árvore hierárquica torna-se uma entrada de menu.
-
O menu raiz deve ser um menu de nível superior (veja abaixo).
Menus de nível superior
Para criar um menu de nível superior, ou seja, uma entrada na barra de menu, a janela deve ser o objeto pai do menu.
Assim que a janela tem pelo menos um menu
visível top-level, a barra de menu da janela torna-se visível.
Caso contrário, ele estará oculto.
O desktop Unity remove a barra de menu da janela do aplicativo para colocá-lo no painel do no topo do desktop.
Infelizmente, ele não funciona bem nas janelas que não são janelas de nível superior, mas nas janelas incorporadas (como o controle
Workspace funciona).
Para resolver o problema, execute o seguinte código no início do seu programa:
Application.Env ["APPMENU_DISPLAY_BOTH"] = "1"
Para criar um menu pop-up contextual não visível na barra de menu, basta configurar sua propriedade
Visible para False.
Entradas do menu
Entradas do menu são objetos de menu com nenhum filho.
Observe que os controles do menu não herdam a classe
Control, e eles não levantam qualquer evento da classe Control.
A ordem das entradas do menu em seu menu pop-up pai segue a ordem da criação.
Separadores
Se a propriedade
Text de um item do menu é nula, então a entrada do menu é substituído por um separador.
Separadores inúteis são automaticamente removidos quando o menu pop-up é exibido.