Méthode ITextHost::TxActivate (textserv.h)
Avertit l’hôte de texte que le contrôle est actif.
Syntaxe
HRESULT TxActivate(
LONG *plOldState
);
Paramètres
plOldState
Type : LONG*
État d’activation précédent.
Valeur retournée
Type : HRESULT
Retournez S_OK si la méthode réussit.
Retourne le code d’erreur COM suivant si la méthode échoue. Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs dans COM.
| Code de retour | Description |
|---|---|
|
L’activation n’est pas possible pour le moment. |
Remarques
Il est légal pour l’hôte de refuser une demande d’activation ; par exemple, le contrôle peut être réduit au minimum et donc invisible.
L’appelant doit être en mesure de gérer correctement l’échec de l’activation.
Quel que soit le nombre de fois où cette méthode est appelée, un seul appel ITextHost::TxDeactivate est nécessaire pour désactiver le contrôle.
Cette fonction retourne un handle opaque dans plOldState. L’appelant (objet de services de texte) doit enregistrer ce handle et l’utiliser dans un appel suivant à ITextHost::TxDeactivate.
Configuration requise
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | textserv.h |
| DLL | Msftedit.dll |
Voir aussi
Conceptuel
Référence