4D Doc Center : SET MENU ITEM PROPERTY

4D v14.3

SET MENU ITEM PROPERTY


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	cadeia	Tipo de propriedade
valor	Expression	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 das constantes do tema “Propriedades de item de menu ou qualquer valor personalizado:

Propriedade padrão: as constantes do tema “Propriedades de item de menu assim como suas possíveis valores são descritos a continuação. Considere que no caso da propriedade Associated Standard Action, pode passar uma das constantes do tema “Valores para ação padrão associada no parâmetro valor:

Propriedade (Constante)	Valor (valores possíveis)
Associated Standard Action	0 = Sem ação
Used to associate a standard action	1 = Cancelar
with a menu item.	2 = Aceitar
	3 = Seguinte registro
	4 = Registro anterior
	5 = Primeiro registro
	6 = Último registro
	7 = Eliminar registro
	8 = Seguinte página
	9 = Página anterior
	10 = Primeira página
	11 = Última página
	12 = Editar subregistro
	13 = Eliminar subregistro
	14 = Adicionar subregistro
	17 = Desfazer
	18 = Cortar
	19 = Copiar
	20 = Pegar
	21 = Apagar
	22 = Selecionar tudo
	23 = Mostrar área de transferência
	26 = Testar aplicação
	27 = Sair
	31 = Refazer
	32 = Preferências
	35 = Voltar ao ambiente Desenho
	36 = CSM
Start a New Process	0 = No
Permite ativar a opção "Iniciar	1 = Sim
novo processo".
Access Privileges	0 = Todos os grupos
Permite atribuir um grupo de acesso	>0 = ID grupo
ao comando.

Para maior informação sobre as propriedades padrão das linhas de menus, consulte o capítulo “Criação de menus personalizados” no Manual de Desenho.

Propriedade personalizada: em propriedade, pode passar todo texto personalizado e associar um valor de tipo texto, numérico e 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 cadeia personalizada, simplesmente tenha certeza de utilizar um título utilizado por 4D (por convenção, as propriedades definidas por 4D começam por “4D_”).

Nota: se a linha de menu corresponde ao título de um submenu hierárquico, a ação padronizada não será chamada quando é selecionada a linha de menu.