SET HELP MENU
SET HELP MENU ( menuCol )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| menuCol | Collection | → | Coleção de objetos menu |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando SET HELP MENU lhe permite substituir o menu Ajuda por padrão de 4D pela coleção de elementos do menu menuCol de modo aplicação.
Este comando substitui o menu Ajuda por padrão do modo aplicação em todos os ambientes 4D: interpretado, compilado, fusionado, monousuario e cliente/servidor.
Notas:
- A propria etiqueta "Ajuda" é gestionada pelo sistema e não pode ser personalizada com este comando.
- Os menus de ajuda personalizados não são compatíveis com submenus, marcas de verificação, estilos ou icones.
Em menuCol, passe uma coleção de objetos de menu que definam todos os elementos do menu de Ajuda personalizado. Cada objeto de menu pode conte as seguintes propriedades:
| Propriedade | Tipo | Descrição |
|---|---|---|
| title | Text | Nome do elemento de menu |
| method | Text | 4D.Function | Nome do método projeto ou objeto fórmula a executar quando selec ionar o elemento do menu. Quando usar esta propriedade, não deve passar a propriedade "action" (do contrário se ignora "method"). |
| worker | Text | Number | Nome do worker ou Número do processo que se encarregará da execução do código do "método". Várias configurações são compatíveis, dependendo do valor da propriedade "worker": se o nome de worker (Text), 4D utilizar ou criar este worker para executar o "método" (equivalente a CALL WORKER) se for um número de processo, 4D utiliza este processo se existir, em caso contrário, não faz nada (equivalente a CALL WORKER) se não estiver definido e a aplicação mostrar um diálogo atual (frontmost dialog), 4D utiliza o processo deste diálogo (equivalente a CALL FORM) se não estiver definido e a aplicação não mostrar um diálogo atual, 4D chama e utiliza o worker1 (4D remoto/mono usuario) ou o worker 4D_server_interface (4D Server) |
| action | Text | Ação estandarte a executar quando o elemento de menu for selecionado. Quando se utilizar esta propriedade, a propriedade "method" se ignora se for passada. |
| shortcutKey | Text | Tecla de acesso direto do elemento (para chamar com a tecla Ctrl/Comando) |
| shortcutShift | Boolean | True para adicionar a tecla Maiús ao acesso direto do elemento |
| shortcutAlt | Boolean | True para adicionar a tecla Alt/Opção ao acesso direto do elemento |
O menu Ajuda personalizado mostrará os elementos na mesma ordem que a coleção.
Para inserir uma linha separadora, passe null ou um objeto vazio na coleção.
Exemplo
Se quiser personalizar o menu Ajuda de sua aplicação:
var $col : Collection
$col:=New collection
$col.push(New object("title";"Knowledge base";"worker";"workerHlp";"method";"methodHlp";"shortcutAlt";True;"shortcutKey";"Y"))
$col.push(Null) //para adicionar uma linha de separação
$col.push(New object("title";"Tools";"action";ak msc;"shortcutShift";True;"shortcutKey";"Y"))
SET HELP MENU($col)
SET ABOUT("About this application";"m_about") //para substituir 'About 4D' en Windows
