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

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.

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

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

Confira também

ACTIVATEFLAGS

IOleInPlaceObjectWindowless

IOleInPlaceSite::OnInPlaceActivate

Ioleinplacesiteex

Ioleinplacesitewindowless