mEste é um comando muito poderoso, que é usado para adicionar uma nova entrada ao menu ou para modificar uma entrada existente. Determina qual comando é executado quando a entrada do menu é ativada, qual ícone é mostrado no menu e qual tecla de atalho é usada. Cada entrada de menu pode ser desativada ou oculta, pode ser atribuída uma identificação única e também pode participar de um grupo de menus.
Você normalmente não precisa deste comando dentro de um script do Kwave!
comando: | Um comando de texto (incluindo parâmetros) ou uma lista de comandos que será executada quando a entrada do menu for ativada. Se uma entrada do menu não tiver um comando correspondente (por exemplo, se for um submenu e não uma entrada do menu), você deve usar o comando especial ignore (). |
caminho: | O caminho dentro do menu, usando um “/” como separador. A última parte do caminho poderá ser um sub-comando que modifica uma dada propriedade da entrada do menu (ver abaixo). A última parte do caminho (que não seja um sub-comando) produz uma entrada do menu, enquanto aspartes anteriores produzem a entrada de menu principal ou os sub-menus que conduzem até ela. As entradas do menu principal ou os sub-menus são criados automaticamente quando criar uma entrada de menu, você não precisa criá-las manualmente. |
atalho: | Uma máscara de bits que consiste em uma combinação predefinida de teclas e modificadores, em associação com um “+”. A tecla poderá ser um número, uma letra maiúscula, uma tecla de função (“F1” ... “F12”) ou qualquer outro nome de tecla compreendido pela classe Qt “QKeySequence”, incluindo nome de teclas das ações predefinidas (como por exemplo “::Copy”). Os modificadores típicos são “SHIFT”, “ALT” e “CTRL”. |
id: | Um id único que possa ser usado internamente para identificar esta entrada de menu ou menu / sub-menu. Só deverão ser usadas letras maiúsculas, números e o “_” e deverá iniciar com “ID_”. É de sua responsabilidade garantir que o mesmo id não seja usado duas vezes. |
| #checkable: | Torna a entrada do menu marcável, para que possa ser ativada ou desativada. |
| #disabled: | Desabilita o menu, o submenu ou a entrada de menu. |
| #enabled: | Habilita o menu, o submenu ou a entrada do menu. |
#exclusive(grupo): | Adiciona uma entrada de menu a um grupo exclusivo(uma das muitas opções). O grupo que é dado como parâmetro não deve ser usado para qualquer outra finalidade. Apenas uma entrada nesse grupo pode ser selecionada por vez. |
#group(lista): | Adiciona o menu, submenu ou entrada de menu a um ou mais grupos, para que o aplicativo possa habilitar/desabilitar várias entradas de menu sem precisar conhecer todas suas identidades únicas exclusivas. Vários grupos podem ser passados como uma lista com uma “
|
| #hidden: | Esconde o menu, sub-menu ou entrada de menu. |
#icon(nome): | Atribui um ícone a uma entrada de menu. O nome do ícone deverá corresponder a um arquivo de ícone (sem caminho e extensão de arquivo) que é instalado com o sistema ou com o Kwave. |
#listmenu(id,comando): | Insere um item de substituição para uma lista de entradas de menu para um sub-menu. O id único indicado neste sub-comando é usado para adicionar/remover ou limpar alista de itens do menu. O parâmetro comando tem de “%1” como parâmetro, o qual será substituído pelo texto da entrada de menu, quando for ativado. (Este sub-comando é usado internamente pela lista de arquivos recentes, pela lista de faixas e pela lista de janelas). |
| #separator: | Insere um separador em um submenu. |
Mostra uma caixa de mensagem com algum texto e dois botões (retorna sem código de erro) e (retorna com código de erro). Você pode usar este comando para dar ao usuário a possibilidade de interromper um script em execução.