Evento de controle SetTargetPath

O evento SetTargetPath notifica o instalador para verificar e definir o caminho selecionado. Se o caminho não for válido para gravação, o instalador bloqueará outros ControlEvents associados ao controle.

Esse evento pode ser publicado por um controle PushButton ou um controle SelectionTree. Esse evento deve ser criado na tabela ControlEvent.

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 informações, consulte Níveis de interface do usuário.

Publicado por

Esse ControlEvent é publicado pelo instalador.

Argumento

O nome da propriedade que contém o caminho. Se a propriedade for indireta, o nome da propriedade será colocado entre colchetes.

Ação sobre assinantes

Nenhum.

Usos comum

Um controle PushButton em uma caixa de diálogo de navegação está vinculado a esse evento na tabela ControlEvent para verificar o caminho selecionado antes de retornar à caixa de diálogo de seleção.

Comentários

Não tente configurar o caminho de destino se os componentes que usam esses caminhos já estiverem instalados para o usuário atual ou para um usuário diferente. Verifique a propriedade ProductState antes de publicar o SetTargetPath ControlEvent para determinar se o produto que contém o componente está instalado.