Compartilhar via


ControlEvent DoAction

O ControlEvent DoAction notifica o instalador para executar uma ação personalizada. Esse evento pode ser publicado por um controle PushButton, um controle CheckBox ou um controle SelectionTree. Esse evento deve ser criado na tabela ControlEvent.

Observe que as ações personalizadas iniciadas por um ControlEvent DoAction podem enviar uma mensagem com o método Message, mas não podem enviar uma mensagem com MsiProcessMessage. Nos sistemas anteriores ao Windows Server 2003, as ações personalizadas iniciadas por um ControlEvent DoAction não podem enviar mensagens com MsiProcessMessage ou o método Message. Para obter mais informações confira Enviando mensagens para o Windows Installer usando MsiProcessMessage.

Esse ControlEvent requer que a interface do usuário seja executada no nível completo da interface do usuário. Esse evento não funcionará com uma interface do usuário reduzida ou uma interface do usuário básica. Para obter mais informações, consulte os Níveis da interface do usuário.

Publicada por

Esse ControlEvent é publicado pelo instalador.

Argumento

Uma cadeia de caracteres, o nome da ação personalizada a ser executada.

Ação sobre assinantes

Esse ControlEvent não executa uma ação nos assinantes.

Usos comum

Um controle PushButton em uma caixa de diálogo está vinculado a esse evento na tabela ControlEvent para chamar uma ação personalizada.