SET MENU ITEM PROPERTY

4D v17.4


SET MENU ITEM PROPERTY ( menu ; menuItem ; propriedade ; valor {; processo} )

Parâmetro	Tipo	Descrição
menu	Inteiro longo, MenuRef	Número de menu ou menu de referência
menuItem	Inteiro longo	Número de item de menu ou -1 para o último item adicionado ao menu
propriedade	String	Tipo de propriedade
valor	Texto, Número, Booleano	Valor da propriedade
processo	Inteiro longo	Número de processo

Descrição

O comando SET MENU ITEM PROPERTY permite fixar o valor da propriedade para a linha de menu designada pelos parâmetros menu e menuItem.

Pode passar -1 em menuItem para especificar a última linha adicionada a menu.

Em menu, pode passar uma referencia de menu (MenuRef) ou um número de menu. Se passa uma referência de menu, o comando se aplicará a todas as instâncias do menu em todos os processos Neste caso, se passar o parâmetro processo, ele será ignorado. Se passa um número de menu, o comando se aplicará ao menu correspondente na barra de menus principal do processo atual. Se quer designar outro processo, passe seu número no parâmetro opcional processo.

No parâmetro propriedade, passe a propriedade cujo valor quer modificar e passe o novo valor em valor. Para o parâmetro propriedade, pode utilizar uma propriedade padrão (uma das constantes de tema “Propriedades de item de menu”) ou uma propriedade personalizada:

Propriedade padrão: as constantes do tema “Propriedades de item de menu assim como suas possíveis valores são descritos a continuação.

Constante	Tipo	Valor
Access privileges	Cadeia	4D_access_group
Associated standard action	Cadeia	4D_standard_action
Start a new process	Cadeia	4D_start_new_process

Considere que no caso da propriedade Associated Standard Action, pode passar no parâmetro valor um nome de ação padrão.

Para obtener uma lista completa das ações disponíveis, consulte a seção Ações padrões do manual de Desenho. As ações mais comuns também estão disponíveis como constantes no tema Ação estandarte.
Nota de compatibilidade: em versões anteriores, as constantes de tema Valores para ação padrão associada se utilizaram no parâmetro valor (Inteiro longo). A partir de 4D v16 R3, são obsoletas, mas ainda são suportadas por compatibilidade.

Propriedade personalizada: em propriedade, pode passar todo texto personalizado e associar um valor de tipo texto, numérico ou booleano. Este valor será armazenado com o elemento e pode ser recuperado utilizando o comando GET MENU ITEM PROPERTY. No parâmetro propriedade pode utilizar toda string personalizada, simplesmente tenha certeza de utilizar um título utilizado por 4D (por convenção, as propriedades definidas por 4D começam por “4D_”).

Ver também

Dynamic pop up menu
GET MENU ITEM PROPERTY