Méthode IOleInPlaceSiteEx ::RequestUIActivate (ocidl.h)
Informe le conteneur que l'objet va passer à l'état Interface utilisateur actif.
Syntaxe
HRESULT RequestUIActivate();
Valeur de retour
Cette méthode retourne S_OK si l’objet peut poursuivre le processus d’activation et appeler IOleInPlaceSite ::OnUIActivate. Les autres valeurs de retour possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
L’objet ne peut pas entrer l’état actif de l’interface utilisateur. L’objet doit appeler IOleInPlaceSite ::OnUIDeactivate afin que le conteneur puisse effectuer le traitement nécessaire pour restaurer le focus. |
|
L'opération a échoué. |
Remarques
Un objet appelle cette méthode pour déterminer s’il peut entrer dans l’état actif de l’interface utilisateur et pour informer le conteneur qu’il est sur le point d’effectuer cette transition. Le conteneur peut retourner S_FALSE pour refuser cette demande, par exemple si l’utilisateur final a annulé l’opération ou si l’objet actuellement actif ne abandonne pas son état actif.
Si l’objet n’appelle pas IOleInPlaceSiteEx ::RequestUIActivate, le conteneur gère la validation des données et déclenche les événements Enter et Exit à partir de IOleInPlaceSite ::OnUIActivate.
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 |
Voir aussi
IOleInPlaceSite ::OnUIActivate