Método IOleInPlaceSiteEx::OnInPlaceActivateEx (ocidl.h)

Artigo
03/05/2024

Chamado pelo objeto inserido para determinar se ele precisa se redesenhar após a ativação.

Sintaxe

HRESULT OnInPlaceActivateEx(
  [out] BOOL  *pfNoRedraw,
  [in]  DWORD dwFlags
);

Parâmetros

[out] pfNoRedraw

Um ponteiro para uma variável que recebe o status de redesenho atual. O status será TRUE se o objeto não precisar se redesenhar após a ativação e false caso contrário. Objetos sem janelas geralmente não precisam do valor retornado por esse parâmetro e podem passar um ponteiro NULL para salvar o contêiner da carga de computação desse valor.

[in] dwFlags

Indica se o objeto é ativado como um objeto sem janelas. Esse parâmetro usa valores da enumeração ACTIVATEFLAGS . Consulte IOleInPlaceSiteWindowless para obter mais informações sobre objetos sem janelas.

Retornar valor

Esse método retornará S_OK se o contêiner permitir a ativação in-loco. Outros valores retornados possíveis incluem o seguinte.

Código de retorno	Descrição
E_UNEXPECTED	Ocorreu um erro inesperado.

Comentários

Esse método substitui IOleInPlaceSite::OnInPlaceActivate. Se o método mais antigo for usado, o objeto deverá sempre se redesenhar na ativação.

Objetos sem janelas são necessários para usar esse método em vez de IOleInPlaceSite::OnInPlaceActivate para notificar o contêiner de se eles estão ativando sem janelas ou não.

Observações aos implementadores

O contêiner deve marcar cuidadosamente a status de invalidação do objeto, sua ordem z, recorte e quaisquer outros parâmetros relevantes para determinar o valor apropriado a ser retornado em pfNoRedraw.

Um contêiner pode armazenar em cache o valor da enumeração ACTIVATEFLAGS em vez de chamar o método GetWindow na interface IOleInPlaceObjectWindowless repetidamente.

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