SET MENU ITEM PROPERTY

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

Parâmetro	Tipo		Descrição
menu	Integer, Text	→	Número de menu ou menu de referência
menuItem	Integer	→	Número de item de menu ou -1 para o último item adicionado ao menu
propriedade	Text	→	Tipo de propriedade
valor	Text, Number, Boolean	→	Valor da propriedade
processo	Integer	→	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 | Comentário |
  | -------------------------- | ------ | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Access privileges | Cadeia | 4D_access_group | Ativar a opção "Iniciar um novo processo"
  0 = Não, 1 = Sim |
  | Associated standard action | Cadeia | 4D_standard_action | Associar uma ação padrão à linha de menu
  Ver as constantes de tema "Ação estandarte" |
  | n/a | Cadeia | 4D_execute_without_validating | Ativar a opção Execute without validating (para itens de menu associados à ações padrão).
  True=ativado, False (padrão)=desativado |
  | Start a new process | Cadeia | 4D_start_new_process | Ativar a opção "Start New Process"
  0 = Não, 1 = Sim |

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

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.

Note: ISe o item menu corresponder ao título do submenu hierárquico, a ação padrão não será chamada quando o item menu for selecionado

Proprierdade personalizada - Nesta propriedade pode passar qualquer texto personalizado e associar um valor do texto, núemro ou tipo Booleano. Este valor será armazenado com o item e pode ser recuperado usando o comando GET MENU ITEM PROPERTY. Pode usar qualquer string personalziada na propriedade parâmetro, simplesmente tenha certeza de não usar um título usado por 4D (por convenção, propriedades estabelecidas por 4D começam com “4D_”).

Ver também

Dynamic pop up menu
GET MENU ITEM PROPERTY

Propriedades

Número do comando	973
Thread-seguro	✗