4D v14.3APPEND MENU ITEM |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v14.3
APPEND MENU ITEM
|
APPEND MENU ITEM ( menu ; itemTexto {; subMenu {; processo {; *}}} ) | ||||||||
Parâmetro | Tipo | Descrição | ||||||
menu | Inteiro longo, MenuRef |
![]() |
Número de menu ou menu de referência | |||||
itemTexto | Texto |
![]() |
Texto para os novos itens de menu | |||||
subMenu | MenuRef |
![]() |
Referência do submenu associado com o item | |||||
processo | Inteiro longo |
![]() |
Número de referência de processo | |||||
* | Operador |
![]() |
Se passado: considerar metacaracteres como caracteres comuns | |||||
O comando APPEND MENU ITEM adiciona nova linhas de menu ao menu cujo número ou referência se passa em menu.
Se omite o parâmetro processo, APPEND MENU ITEM se aplica a barra de menus do processo atual. Do contrário, APPEND MENU ITEM é aplicado a barra de menus do processo atual cujo número de referência se passa em processo.
Nota: se passa um MenuRef em menu, o parâmetro processo é inútil e será ignorado.
Se não passar o parâmetro *, APPEND MENU ITEM lhe permite adicionar uma ou várias linhas de menu em uma só chamada.
As linhas a adicionar são definidas com o parâmetro itemText da seguinte maneira:
<B | Negrito | |
<I | Cursiva | |
<U | Sublinhado |
Nota: utilize menus que tenham um número razoável de linhas. Por exemplo, se quer mostrar mais de 50 elementos, considere utilizar uma área de rolagem em um formulário em lugar de um menu.
Se passa o parâmetro *, os caracteres "especiais" (; ( !...) incluídos no texto do elemento serão considerados como caracteres padrão e não como meta caracteres. Isto permite criar elementos de menu tais como "Copiar (especial)..." ou "Pesquisar/Substituir...". Note que quando se passa o parâmetro *, não pode criar vários elementos em uma só chamada já que o caractere ";" é considerado como um caracter padrão.
Nota: os comandos GET MENU ITEMS e Get menu item devolverão ou não os meta caracteres no texto de um elemento de menu dependendo de como foi criado: se foi criado com a opção *, os meta caracteres serão devolvidos como caracteres padrão.
O parâmetro opcional subMenu permite designar um menu como elemento adicionado e portanto definir um submenu hierárquico. Deve passar neste parâmetro uma referência de menu (cadeia de tipo MenuRef) especificando um menu criado por exemplo, utilizando o comando Create menu. Se o comando adiciona mais de um elemento de menu, o submenu é associado a primeira linha.
Importante: as novas linhas não têm métodos ou ações associados. Estes devem ser associados com os elementos utilizando os comandos SET MENU ITEM PROPERY ou SET MENU ITEM METHOD, ou os elementos também podem ser administradas por um método de formulário utilizando o comando Menu selected.
Este exemplo adiciona os nomes das fontes disponíveis num menu Fontes, o qual neste exemplo é o sexto menu da barra de menus atual:
` No método base On Startup
` A lista de fontes é carregada e o texto da linha de menu é construída
FONT LIST(◊asFonteDisp)
◊atFonteMenuItens:=""
For($vlFont;1;Size of array(◊asFonteDisp))
◊atFonteMenuItens:=◊atFonteMenuItens+";"+◊asFonteDisp{$vlFont}
End for
Então, em todo método de formulário ou de projeto, pode escrever:
APPEND MENU ITEM(6;◊atFonteMenuItens)
Produto: 4D
Tema: Menus
Número
411
Modificado: 4D v11 SQL Release 4
DELETE MENU ITEM
INSERT MENU ITEM
SET MENU ITEM PARAMETER
Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)