menubar — u_pbt_menubar #

← Referência dos componentes · Índice do guia

Barra de menus da aplicação: menus, submenus, entradas marcáveis, separadores, ícones e atalhos — tudo desenhado pela biblioteca, sem qualquer menu do Windows.

▶ Ver ao vivo — Aplicação de demonstração, mosaico Menu bar: a pré-visualização, o código que o produz e esta página, lado a lado.

Em resumo #

Início rápido #

// evento open da janela
uo_menus.of_add_menu(/*key*/ "file", /*text*/ "Ficheiro")
uo_menus.of_add_item(/*keys*/ "file/open", /*text*/ "Abrir")
uo_menus.of_add_item(/*keys*/ "file/save", /*text*/ "Guardar")

// event ue_item_selected : (string as_keys)
choose case as_keys
	case "open"; of_ouvrir()
	case "save"; of_enregistrer()
end choose

O modelo: três níveis, uma chave por nível #

Uma barra de menus tem três níveis, e cada um indica-se pela sua chave:

Um id de entrada só é único dentro do seu menu: por isso of_item pede dois. Dois menus podem assim ter cada um a sua entrada "open" sem se estorvarem.

Um separador não tem chave: of_add_separator traça uma linha onde o chamar, e depois não há nada para reler.

Propriedades #

Propriedades de uma entrada — n_pbt_menubar_item #

Obtidas através de of_item(menu/id):

Métodos #

Eventos #

A altura não se define, anuncia-se. Uma barra de menus não desliza: uma altura fixa só pode produzir espaço vazio sob a barra ou menus truncados. Ajusta-se portanto sempre, e ue_auto_height diz-lhe de quanto.

Com o teclado #

Exemplos #

Uma barra de menus completa #

uo_menus.of_set_redraw(false)

// O menu Ficheiro, com um icone em Abrir e uma linha antes de Sair
uo_menus.of_add_menu(/*key*/ "file", /*text*/ "F")
uo_menus.of_add_item(/*keys*/ "file/open", /*text*/ "O", /*image*/ "mono:img\packimages.dll:svg/samples/folder-open", /*checked*/ false)
uo_menus.of_add_separator(/*keys*/ "file")
uo_menus.of_add_item(/*keys*/ "file/quit", /*text*/ "Q")

// Um submenu: Exportar, e depois os seus dois formatos
uo_menus.of_add_item(/*keys*/ "file/export", /*text*/ "E")
uo_menus.of_add_item(/*keys*/ "file/export/csv", /*text*/ "CSV")
uo_menus.of_add_item(/*keys*/ "file/export/pdf", /*text*/ "PDF")

// O menu Ver: uma opcao que se marca
uo_menus.of_add_menu(/*key*/ "view", /*text*/ "V")
uo_menus.of_add_item(/*keys*/ "view/grid", /*text*/ "G", /*image*/ "", /*checked*/ true)

uo_menus.of_set_redraw(true)

Marcar, desmarcar, desativar #

// O utilizador inverteu a apresentacao da grelha
uo_menus.of_item(/*keys*/ "view/grid").ib_checked = not uo_menus.of_item(/*keys*/ "view/grid").ib_checked

// Uma entrada que deixou de fazer sentido e desativada, nao desaparece:
// o utilizador tem de poder ver que existe
uo_menus.of_item(/*keys*/ "file/save").ib_enabled = false

Reconstruir a barra #

// Mudar de area de trabalho: esvazia-se e volta-se a por
// of_set_redraw evita repintar em cada linha
uo_menus.of_set_redraw(false)
uo_menus.of_clear()
uo_menus.of_add_menu(/*key*/ "tools", /*text*/ "T")
uo_menus.of_set_redraw(true)

Boas práticas #

• Dê a cada entrada um identificador de negócio estável ("save"): é esse que recebe em ue_item_selected, não uma etiqueta que muda com a língua.
• Desative em vez de retirar: uma entrada ausente deixa o utilizador à procura, uma desativada diz-lhe que existe e que lhe falta alguma coisa.
• Enquadre a construção com of_set_redraw(false) / of_set_redraw(true): uma barra completa são trinta chamadas em pouco tempo.
• Reposicione o que está sob a barra no ue_auto_height — a altura depende do tema e do corpo de letra, não é a mesma em todo o lado.
• Para as etiquetas, passe por of_set_translation se a sua aplicação for multilingue: veja o capítulo da língua.

Herdado da base comum #

Estes membros existem em todos os componentes visuais — não são próprios deste. São detalhados uma só vez, nos capítulos transversais; esta tabela apenas diz onde os ler.

Duas ajudas não são herdadas: of_icon e of_escape_markup vivem em n_pbt_utils. Declare um — n_pbt_utils lnv_utils, nada a criar — e chame-as nele.

← Referência dos componentes · Índice do guia