APPEND MENU ITEM

4D v20 R7

APPEND MENU ITEM


APPEND MENU ITEM ( menu ; itemTexto {; subMenu {; processo {; *}}} )

Parâmetro	Tipo	Descrição
menu	Inteiro longo	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

Descrição

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:

Separe cada elemento da seguinte com um ponto e vírgula (;). Por exemplo,
"ItemText1;ItemText2;ItemText3".
Para desativar uma linha: Coloque um parênteses aberto (() no texto da linha.
Para definir uma linha de separação: Passe "-" ou "(-" como texto da linha.
Para especificar um estilo de fonte para uma linha: no texto da linha, ponha um sinal menor que (<) seguido por um dos seguintes caracteres:

	<B	Negrito
	<I	Cursiva
	<U	Sublinhado

Para adicionar uma marca de seleção a uma linha: no texto da linha, ponha um sinal de exclamação (!) seguido pelo caractere que deseja como marca de seleção. Em Macintosh, o caractere é mostrado; em Windows, é mostrada uma marca de seleção sem importar que caractere passe.
Para adicionar um ícone a uma linha: no texto da linha, ponha um acento circunflejo (^) seguido por um carácter cujo código mais 208 é o número do recurso do ícone Mac OS.
Para adicionar um atalho a uma linha: no texto da linha, ponha uma barra obliqua (/) seguida pelo caractere de atalho para o elemento.
(A partir de 4D v16 R3) se o elemento estiver associado com uma ação padrão, passe a constante ak standard action title em itemText para utilizar automaticamente o nome da ação localizada e a informação de contexto (se houver), por exemplo "Undo <previous action>".

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

Exemplo

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)

Ver também

DELETE MENU ITEM
INSERT MENU ITEM
SET MENU ITEM PARAMETER