Tabela ControlEvent
A tabela ControlEvent permite que o autor especifique os Eventos de Controle iniciados quando um usuário interage com um controle PushButton, CheckBox ou SelectionTree. Esses são os únicos controles que os usuários podem usar para iniciar eventos de controle. Cada controle pode publicar vários eventos de controle. O instalador inicia cada evento na ordem especificada na coluna Ordering. Por exemplo, um controle de botão de ação pode publicar eventos para iniciar uma transição para outra caixa de diálogo, sair da sequência da caixa de diálogo e iniciar a instalação do arquivo.
A exceção a ser observada é que cada controle pode publicar mais um evento NewDialog ou SpawnDialog. Se você precisar criar vários eventos de controle NewDialog e SpawnDialog nessa tabela, inclua também instruções condicionais nos campos Condition que garantam que, no máximo, um evento seja publicado. Se vários eventos de controle NewDialog e SpawnDialog forem selecionados para o mesmo controle, somente o evento com o maior valor na coluna Ordering será publicado quando o controle for ativado.
A tabela ControlEvent tem as colunas a seguir.
| Coluna | Tipo | Chave | Nullable |
|---|---|---|---|
| Dialog_ | Identificador | S | N |
| Control_ | Identificador | S | N |
| Evento | Formatted | S | N |
| Argumento | Formatted | S | N |
| Condição | Condição | S | S |
| Ordenando | Inteiro | N | S |
Colunas
-
Dialog_
-
Uma chave externa para a primeira coluna da tabela Dialog. A combinação desse campo com o campo Control_ identifica um controle exclusivo.
-
Control_
-
Uma chave externa para a segunda coluna da tabela Control. A combinação desse campo com o campo Dialog_ identifica um controle exclusivo.
-
Event
-
Um identificador que especifica o tipo de evento que deve ocorrer quando o usuário interage com o controle especificado por Dialog_ e Control_. Para ver a lista de possíveis valores, confira Visão geral de ControlEvent.
Para definir uma propriedade com um controle, coloque [Property_Name] nesse campo e o novo valor no campo de argumento. Coloque { } no campo de argumento para inserir o valor nulo.
-
Argument
-
Um valor usado como modificador ao disparar um evento específico.
Por exemplo, o argumento do NewDialog ControlEvent ou do SpawnDialog ControlEvent é o nome da caixa de diálogo e o argumento da ação Install é um número que define o nível de instalação.
-
Condition
-
Uma instrução condicional que determina se o instalador ativa o evento na coluna Event. O instalador vai disparar o evento se a instrução condicional no campo Condition for avaliada como True. Portanto, coloque um 1 nessa coluna para garantir que o instalador dispare o evento. O instalador não vai disparar o evento se o campo Condition contiver uma instrução avaliada como False. O instalador não dispara um evento com um branco no campo Condition, a menos que nenhum outro evento do controle seja avaliado como True. Se nenhum dos campos Condition do controle nomeado no campo Control_ for avaliado como True, o instalador vai disparar o único evento com um campo Condition em branco e, se mais de um campo Condition estiver em branco, ele vai disparar um evento desses com o maior valor no campo Ordering. Confira Sintaxe de instruções condicionais.
-
Ordering
-
Um inteiro usado para ordenar vários eventos vinculados ao mesmo controle. Precisa ser um número não negativo. Esse campo pode ser deixado em branco.
Comentários
A tabela EventMapping lista os controles que assinam algum evento de controle e lista o atributo de controle a ser alterado quando esse evento for publicado pelo outro controle ou pelo instalador.
No Windows XP ou em sistemas operacionais anteriores, os usuários podem publicar um evento de controle apenas interagindo com um controle Checkbox ou Pushbutton. Com o Windows Server 2003, os usuários podem publicar um evento de controle apenas interagindo com um controle Checkbox, SelectionTree e Pushbutton. A listagem de outros controles no campo Control_ não tem nenhum efeito.
Validação