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

Article
02/29/2024

Appelé par l’objet incorporé pour déterminer s’il doit se redessiner lors de l’activation.

Syntaxe

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

Paramètres

[out] pfNoRedraw

Pointeur vers une variable qui reçoit le redessinage actuel status. La status a la valeur TRUE si l’objet n’a pas besoin de se redessiner lors de l’activation et FALSE dans le cas contraire. Les objets sans fenêtre n’ont généralement pas besoin de la valeur retournée par ce paramètre et peuvent passer un pointeur NULL pour éviter au conteneur la charge de calcul de cette valeur.

[in] dwFlags

Indique si l’objet est activé en tant qu’objet sans fenêtre. Ce paramètre prend des valeurs de l’énumération ACTIVATEFLAGS . Pour plus d’informations sur les objets sans fenêtre, consultez IOleInPlaceSiteWindowless .

Valeur retournée

Cette méthode retourne S_OK si le conteneur autorise l’activation sur place. Les autres valeurs de retour possibles sont les suivantes.

Code de retour	Description
E_UNEXPECTED	Une erreur inattendue s’est produite.

Remarques

Cette méthode remplace IOleInPlaceSite ::OnInPlaceActivate. Si l’ancienne méthode est utilisée, l’objet doit toujours se redessiner lors de l’activation.

Les objets sans fenêtre doivent utiliser cette méthode à la place de IOleInPlaceSite ::OnInPlaceActivate pour informer le conteneur de l’activation ou non d’une fenêtre.

Remarques aux implémenteurs

Le conteneur doit soigneusement case activée la status d’invalidation de l’objet, son ordre de plan, son découpage et tout autre paramètre pertinent pour déterminer la valeur appropriée à retourner dans pfNoRedraw.

Un conteneur peut mettre en cache la valeur de l’énumération ACTIVATEFLAGS au lieu d’appeler à plusieurs reprises la méthode GetWindow dans l’interface IOleInPlaceObjectWindowless .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ocidl.h