Tabela ControlEvent
A tabela ControlEvent permite que o autor especifique os Eventos de Controle iniciados quando um usuário interage com um de Controle PushButton, de Controle CheckBox ou de Controle 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 Pedido. Por exemplo, um controle de botã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 NewDialog ou um evento SpawnDialog. Se você precisar criar vários eventos de controle NewDialog e SpawnDialog nesta 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 Ordenação será publicado quando o controle for ativado.
A tabela ControlEvent tem as seguintes colunas.
| Coluna | Tipo | Chave | Nulo |
|---|---|---|---|
| Dialog_ | Identificador | Y | N |
| Controlo_ | Identificador | Y | N |
| Evento | Formatado | Y | N |
| Argumento | Formatado | Y | N |
| Condição | Condição | Y | Y |
| Encomendar | inteiro | N | Y |
Colunas
-
Dialog_
-
Uma chave externa para a primeira coluna da tabela Dialog. A combinação deste campo com o campo Control_ identifica um controle exclusivo.
-
Control_
-
Uma chave externa para a segunda coluna da tabela Control. A combinação deste campo com o campo Dialog_ identifica um controle exclusivo.
-
Evento
-
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 obter uma lista de valores possíveis, consulte Visão geral do ControlEvent.
Para definir uma propriedade com um controle, coloque [Property_Name] neste campo e o novo valor no campo de argumento. Coloque { } no campo de argumento para inserir o valor nulo.
-
Argumento
-
Um valor usado como um modificador ao acionar 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.
-
Condição
-
Uma instrução condicional que determina se o instalador ativa o evento na coluna Evento. O instalador aciona o evento se a instrução condicional no campo Condition for avaliada como True. Portanto, coloque um 1 nesta coluna para garantir que o instalador acione o evento. O instalador não acionará o evento se o campo Condition contiver uma instrução avaliada como False. O instalador não aciona um evento com um espaço em branco no campo Condição, a menos que nenhum outro evento do controle seja avaliado como True. Se nenhum dos campos Condição do controle nomeado no campo Control_ avaliar como Verdadeiro, o instalador acionará um evento com um campo Condição em branco e, se mais de um campo Condição estiver em branco, acionará o único evento desses com o maior valor no campo Ordenação. Consulte Sintaxe da declaração condicional.
-
Encomendar
-
Um inteiro usado para ordenar vários eventos vinculados ao mesmo controle. Este deve ser um número não negativo. Este 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 é publicado por outro controle ou instalador.
No Windows XP ou em sistemas operacionais anteriores, os usuários podem publicar um evento de controle somente interagindo com um de Controle de Caixa de Seleção ou Controle por Botão. Com o Windows Server 2003, os usuários podem publicar um evento de controle somente interagindo com um de Controle de Caixa de Seleção, de Controle SelectionTree e de Controle de Botão . A listagem de outros controles no campo Control_ não tem efeito.
Validação