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 |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
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_”).