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
S_FALSE	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.
E_FAIL	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

Confira também

IOleInPlaceSite::OnUIActivate

IOleInPlaceSite::OnUIDeactivate

Ioleinplacesiteex