Método IOleInPlaceSiteEx::RequestUIActivate (ocidl.h)
Notifica o contêiner de que o objeto está prestes a entrar no estado ativo da interface do usuário.
Sintaxe
HRESULT RequestUIActivate();
Retornar valor
Esse método retornará S_OK se o objeto puder continuar o processo de ativação e chamar IOleInPlaceSite::OnUIActivate. Outros valores retornados possíveis incluem o seguinte.
| Código de retorno | Descrição |
|---|---|
|
O objeto não pode inserir o estado ativo da interface do usuário. O objeto deve chamar IOleInPlaceSite::OnUIDeactivate para que o contêiner possa executar o processamento necessário para restaurar o foco. |
|
Falha na operação. |
Comentários
Um objeto chama esse método para determinar se ele pode inserir o estado ativo da interface do usuário e notificar o contêiner de que ele está prestes a fazer essa transição. O contêiner pode retornar S_FALSE para negar essa solicitação, por exemplo, se o usuário final cancelou a operação ou se o objeto ativo atualmente não abrirá mão de seu estado ativo.
Se o objeto não chamar IOleInPlaceSiteEx::RequestUIActivate, o contêiner manipulará a validação de dados e disparará eventos Enter e Exit de IOleInPlaceSite::OnUIActivate.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | ocidl.h |