Cadeias de ação

As ações que o produto executa quando você seleciona uma ferramenta, selecione um item de menu ou pressione uma tecla de função são definidas pela cadeia de ação associada a esse objeto. A princípio, é mais simples pensar numa cadeia de ação como um comando ou série de comandos. Por exemplo, a cadeia de ação associada com a ferramenta Inserir SmartLine é o comando PLACE SMARTLINE. O efeito verdadeiro de selecionar a ferramenta Inserir SmartLine é a ativação do comando PLACE SMARTLINE.

Tipos de ação

Diversos tipos de ações podem ser especificados nas cadeias de ação e ser associados com as ferramentas, os controles de visualização, os itens de menu e as teclas de função.

Tipo de ação	Sintaxe	Descrição
Entrada de comando	`E, <key-in>`	Simula um comando. O comando especificado por uma entrada de comando está sempre ativado, apesar do estado do estado do comando ativo. Por exemplo, supõe isso PLACE CIRCLE RADIUS é o comando ativo e está pedindo o raio. Se você pressiona uma tecla de função definida no menu da tecla de função para ter o tipo de ação `E` isso ativa o comando PLACE LINE CONSTRAINED, então PLACE LINE CONSTRAINED se torna o comando ativo.
Comando terminado	`T,<key-in>`	Simula um comando. Um comando terminado é usado normalmente para obter dados pedidos por alertas, tais como o raio de um círculo, texto, ou uma resposta a uma pergunta de sim ou não.
Comando não terminado	`K,<digitar>`	Insere uma cadeia de caracteres não terminada e aguarda você terminar o texto.
Imprimir mensagem	`M,<mensagem>`	Imprime uma mensagem em um dos campos da barra de status.

Nota: Se nenhum especificador de tipo (um único caractere separado do resto do texto com uma vírgula) existe, o produto supõe que o tipo da ação é uma entrada do comando de entrada (e).

Nota: Para exemplos das cadeias de ação, examine o arquivo DGN do menu da mesa de amostra fornecido no Bentley Communities.

Opções do tipo de ação

Essas opções podem ser usadas imediatamente seguidas pelos tipos de ação E, T, ou K ou em qualquer lugar numa cadeia de ação múltipla seguido por um ponto-e-vírgula.

`/<caractere>`	Se há um corte (`/`) em uma cadeia de ação, o produto pausa para a entrada do usuário. Se a barra for seguida por `d`, `k`, ou nenhum caractere, o produto faz o seguinte: `/d` — aguarda um ponto de dados. `/k` — aguarda um comando. Nenhum caractere — procede após qualquer entrada.
`%<caractere>`	Um por cento (`%`) caractere em uma cadeia de ação é idêntico ao corte, salvo que o produto não exibe alguns de seus alertas normais. É útil exibir alertas feitos sob encomenda a partir de um menu. As ações `%d` e `%k` funcionam analogamente a `/d` e `/k`.

Entrando cadeias de ação múltiplas

Cada cadeia de ação pode conter diversas ações (separadas por ponto-e-vírgula).

Por exemplo, esta cadeia de ação coloca um círculo azul de duas polegadas em um ponto especificado pelo usuário: co=blue;E,PLACE CIRCLE RADIUS;T,2;M,cfPlace 2 Inch Circle;%d;null

As ações são como segue:

Ação/Comando	Descrição
`co=blue`	Um comando de entrada (desde que nenhum tipo é especificado) que define a Cor Ativa para azul. O produto ativa o comando COR ATIVA mesmo que ele aguarde uma inserção de dados.
`E,PLACE CIRCLE RADIUS`	O comando PLACE CIRCLE RADIUS.
`T,2`	Um comando terminado que insere um raio de 2.
`M,cfPlace 2 Inch Circle`	Mostra a mensagem "Inserir círculo de 2 polegadas" na barra de status.
`%d`	Aguarda um ponto de dados sem mostrar os alertas normais (preservando o alerta mostrado pela ação anterior).
`null`	Depois que o círculo é colocado, execute NULL digite de modo que nenhuma ferramenta ou controle de visualização seja selecionado.