Méthode IDirectManipulationContent ::GetTag (directmanipulation.h)
Récupère l’objet de balise défini sur ce contenu.
Syntaxe
HRESULT GetTag(
[in] REFIID riid,
[out, optional] void **object,
[out, optional] UINT32 *id
);
Paramètres
[in] riid
Référence à l’identificateur de l’interface à utiliser. L’objet tag implémente généralement cette interface.
[out, optional] object
Objet tag.
[out, optional] id
Partie ID de la balise.
Valeur retournée
Si la méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
GetTag et SetTag sont utiles pour associer un objet COM externe au contenu sans mappage externe entre les deux. Ils peuvent également être utilisés pour transmettre des informations aux rappels générés pour le contenu.
GetTag interroge la valeur de balise pour l’interface spécifiée et retourne un pointeur vers cette interface.
Une balise est un appairage d’un ID entier (id) avec un objet COM (Component Object Model). Il peut être utilisé par une application pour identifier un mouvement. Les paramètres sont facultatifs, afin que la méthode puisse retourner les deux parties de la balise, de la partie identificateur ou de l’objet balise.
Exemples
L’exemple suivant montre la syntaxe de cette méthode.
IUnknown* pObject;
UINT32 id;
HRESULT hr = pContent->GetTag(IID_PPV_ARGS(&pObject), &id);
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | directmanipulation.h |