4D v14.3

APPEND MENU ITEM

Página Inicial

 
4D v14.3
APPEND MENU ITEM

APPEND MENU ITEM 


 

APPEND MENU ITEM ( menu ; itemTexto {; subMenu {; processo {; *}}} ) 
Parâmetro Tipo   Descrição
menu  Inteiro longo, MenuRef in Número de menu ou menu de referência
itemTexto  Texto in Texto para os novos itens de menu
subMenu  MenuRef in Referência do submenu associado com o item
processo  Inteiro longo in Número de referência de processo
Operador in 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:

  • 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:
<BNegrito
<ICursiva
<USublinhado
  • 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.

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.

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)

 
PROPRIEDADES 

Produto: 4D
Tema: Menus
Número 411

Este comando não pode ser utilizado com 4D Server

 
HISTÓRIA 

Modificado: 4D v11 SQL Release 4

 
VER TAMBÉM 

DELETE MENU ITEM
INSERT MENU ITEM
SET MENU ITEM PARAMETER

 
ARTICLE USAGE

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)