mEste é um comando muito poderoso e é usado para adicionar um novo item ao menu ou para modificar um item existente. Ele determina qual o comando que é executado quando é activado o item do menu, qual o ícone que é apresentado no menu e qual o atalho de teclado que é usado. Cada item do menu poderá estar desactivado ou escondido, poderá ter um id único e também poderá estar associado a um grupo do menu.
Normalmente não precisa deste comando dentro de um programa do Kwave!
comando: | Um comando de texto (incluindo os parâmetros) ou uma lista de comandos que será executado quando o item do menu for activado. Se um item de menu não tiver um comando correspondente (por exemplo, se for um sub-menu e não um item individual), deverá usar o comando ignore(). |
localização: | A localização dentro do menu, usando um “/” como separador. A última parte da localização poderá ser um sub-comando que modifica uma dada propriedade do item do menu (ver abaixo). A última parte da localização (que não seja um sub-comando) produz um item do menu, enquanto as partes anteriores produzem o item de menu principal ou os sub-menus que conduzem até ele. Os itens do menu principal ou os sub-menus são criados automaticamente quando criar um item do menu, pelo que não precisa de os criar manualmente. |
atalho: | Uma máscara de 'bits' que consiste numa combinação de teclas e modificadores predefinidos, concatenados 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 aceite pela classe do Qt “QKeySequence”, incluindo os nomes das teclas das acções predefinidas (como por exemplo “::Copy”). Os modificadores típicos são o “SHIFT”, “ALT” e “CTRL”. |
id: | Um ID único que possa ser usado a nível interno para identificar este item do menu, sub-menu ou menu. Só deverão ser usadas letras maiúsculas, números e o “_” e deverá começar por “ID_”. É da sua responsabilidade garantir que o mesmo ID não é usado duas vezes. |
| #checkable: | Torna um item de menu capaz de ser marcado, para que possa ser activado ou desactivado. |
| #disabled: | Permite ao item de menu ou menu/sub-menu ser desactivado. |
| #enabled: | Permite ao item de menu ou menu/sub-menu ser activado de novo, após ter sido desactivado anteriormente. |
#exclusive(grupo): | Faz com que um item menu faça parte de um grup exclusivo (selecção única entre várias opções). O grupo que é passado como parâmetro não deverá ser usado para mais nenhum outro fim. Só poderá estar seleccionado um item dentro desse grupo de cada vez. |
#group(lista): | Adiciona o item do menu ou sub-menu/menu a um ou mais grupos, de modo que a aplicação possa activar/desactivar um conjunto de itens de menu, sem ter de saber todos os seus ID's. Poderá passar vários grupos como uma lista, usando um “
|
| #hidden: | Esconde o item de menu ou menu/sub-menu. |
#icon(nome): | Atribui um ícone a um item do menu. O nome do ícone deverá corresponder a um ficheiro de ícone (sem localização ou extensão do ficheiro) que é instalado com o KDE ou com o Kwave. |
#listmenu(id,comando): | Insere um item de substituição para uma lista de itens de menu para um sub-menu. O id único indicado neste sub-comando é usado para adicionar/remover ou limpar a lista de itens do menu. O parâmetro comando tem de “%1” como parâmetro, o qual será substituído pelo texto do item de menu, quando for activado. (Este sub-comando é usado internamente pela lista de ficheiros recentes, pela lista de faixas e pela lista de janelas). |
| #separator: | Insere um separador num sub-menu. |
Mostra uma janela de mensagem com um dado texto e os dois botões “” (devolve sem código de erro) e “” (devolve um código de erro). Poderá usar este comando para dar ao utilizador a possibilidade de interromper um programa em execução.