Documentação do Gambas
Api
Como fazer ...
Compilação e Instalação
Components
Classes nativas
gb.args
gb.compress
gb.crypt
gb.data
gb.db
gb.db.form
gb.dbus
gb.debug
gb.desktop
gb.desktop.x11
gb.eval
gb.form
gb.form.dialog
gb.form.mdi - Interface Multi Documento
gb.gtk
gb.gtk.opengl
gb.gui
gb.gui.opengl
gb.image - Componente de processamento de imagens
gb.inotify
gb.logging
gb.map
gb.markdown
gb.media
gb.media.form
gb.mime
gb.ncurses
gb.net
gb.net.curl
gb.net.smtp
gb.openal
gb.opengl
gb.option
gb.pcre
gb.pdf
gb.qt4
_GridView_Columns
_GridView_Rows
_split
_TreeView
Action
Align
Application
Arrange
Border
Button
CheckBox
Clipboard
Color
ColumnView
ComboBox
Container
Control
Cursor
Desktop
Dialog
Drag
Draw
DrawingArea
embedder
Fill
Font
Fonts
Form
Frame
GridView
HBox
HPanel
HSplit
IconView
Image
Key
Label
Line
ListBox
ListView
Menu
Action
Caption
Checked
Children
Click
Delete
Enabled
Hide
Hide
Name
Picture
Popup
Radio
Shortcut
Show
Show
Tag
Text
Toggle
Value
Visible
Window
Message
Mouse
MovieBox
Paint
PaintBrush
PaintExtents
PaintMatrix
Panel
Picture
PictureBox
Point
Pointer
PointF
Printer
ProgressBar
RadioButton
Rect
RectF
Screen
Screens
Scroll
ScrollArea
ScrollBar
ScrollView
Select
Separator
Shortcut
Slider
SpinBox
Style
SvgImage
TabStrip
TextArea
TextBox
TextLabel
ToggleButton
ToolButton
trayicon
trayicons
TreeView
UserContainer
UserControl
VBox
VPanel
VSplit
Watcher
Window
Windows
gb.qt4.ext
gb.qt4.webkit
gb.report
gb.sdl
gb.sdl.sound
gb.sdl2.audio
gb.settings
gb.signal
gb.util
gb.vb
gb.web
gb.xml - Ferramentas XML baseadas em libxml
Documentação do Desenvolvedor
Documentação do IDE
Documentos
Índice da Linguagem
LEIA-ME
Léxico
Manual Wiki
Mensagens de erro
Pedaços de Códigos
Registrar-se
Repositório de aplicativos
Traduzir
Tutoriais
Ultimas modificações
Visão geral da linguagem

Menu (gb.qt4)

Esta classe representa um menu pop-up, ou um elemento de um menu popup.

Esta classe é criável.

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

Métodos
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.

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