Méthode IRealTimeStylus::GetStyluses (rtscom.h)

  • Article

Récupère la collection de stylets rencontrés par l’objet Classe RealTimeStylus .

Syntaxe

HRESULT GetStyluses(
  [out, retval] IInkCursors **ppiInkCursors
);

Paramètres

[out, retval] ppiInkCursors

Lorsque cette méthode retourne, contient un pointeur vers la collection de stylets rencontrés par l’objet Classe RealTimeStylus .

Valeur retournée

Pour obtenir une description des valeurs de retour, consultez Classes et interfaces RealTimeStylus.

Notes

La collection RealTimeStylus Class inclut les stylets pour lesquels un contexte de tablette a été créé. La collection n’inclut pas tous les stylets disponibles dans le système dans la collection de stylets.

Si aucun objet de stylet n’a été détecté sur les objets tablette associés à l’objet Classe RealTimeStylus , cette méthode retourne un tableau vide.

Cette méthode ne peut pas être appelée, sauf si l’objet De classe RealTimeStylus est connecté et activé , classe RealTimeStylus.

Note Cette méthode peut être appelée si la propriété IRealTimeStylus::Enabled retourne false tant que l’objet Classe RealTimeStylus n’a pas terminé de traiter les données dans la file d’attente. Cette méthode peut être appelée jusqu’à ce que le dernier plug-in asynchrone reçoive la méthode IStylusPlugin::RealTimeStylusDisabled.
 

Exemples

L’exemple de code C++ suivant obtient un tableau des objets Stylus que l’objet classe RealTimeStylus a rencontrés depuis sa dernière activation. Il itère ensuite dans le tableau en rapportant l’ID de chaque stylet dans la sortie de débogage.

IInkCursors *piInkCursors;

if (SUCCEEDED(g_pRealTimeStylus->GetStyluses(&piInkCursors)))
{
    long lCursorCount;
    
    if (SUCCEEDED(piInkCursors->get_Count(&lCursorCount)))
    {
        for (long l = 0; l < lCursorCount; l++)
        {
            LONG sid;
            IInkCursor *piInkCursor;
            IInkCursor *piInkCursorForId;

            piInkCursors->Item(l, &piInkCursor);
            piInkCursor->get_Id(&sid);

            if (SUCCEEDED(g_pRealTimeStylus->GetStylusForId((STYLUS_ID)sid, &piInkCursorForId)))
            {
                TRACE("Got stylus with ID %d\n", sid);
            }
        }
    }
}

Spécifications

   
Client minimal pris en charge Windows XP Édition Tablet PC [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête rtscom.h
DLL RTSCom.dll

Voir aussi

IRealTimeStylus

IRealTimeStylus::GetStylusForId, méthode

Classe RealTimeStylus