RealTimeStylus.GetTabletFromTabletContextId, méthode

Article
11/05/2008

Mise à jour : November 2007

Retourne l'objet Tablet associé à un identificateur de contexte de la tablette donné.

Espace de noms : Microsoft.StylusInput
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Function GetTabletFromTabletContextId ( _
    tabletContextId As Integer _
) As Tablet
'Utilisation
Dim instance As RealTimeStylus
Dim tabletContextId As Integer
Dim returnValue As Tablet

returnValue = instance.GetTabletFromTabletContextId(tabletContextId)

public Tablet GetTabletFromTabletContextId(
    int tabletContextId
)

public:
Tablet^ GetTabletFromTabletContextId(
    int tabletContextId
)

public Tablet GetTabletFromTabletContextId(
    int tabletContextId
)

public function GetTabletFromTabletContextId(
    tabletContextId : int
) : Tablet

Paramètres

tabletContextId
Type : System.Int32
Identificateur de contexte de la tablette pour lequel vous souhaitez l'objet Tablet associé.

Valeur de retour

Type : Microsoft.Ink.Tablet
Objet Tablet associé à un identificateur de contexte de la tablette donné.

Notes

Remarque :
Un identificateur de contexte de la tablette est spécifique à un objet RealTimeStylus. Toutefois, deux objets RealTimeStylus peuvent avoir un identificateur de contexte différent pour le même objet Tablet. De plus, un identificateur de contexte de la tablette n'est valide que lorsqu'un objet RealTimeStylus est activé. Si un objet RealTimeStylus est désactivé puis réactivé, pour chaque objet Tablet, l'identificateur de contexte de la tablette peut changer entre la première et la seconde activation de l'objet RealTimeStylus.

Un identificateur de contexte de la tablette est spécifique à un objet RealTimeStylus. Toutefois, deux objets RealTimeStylus peuvent avoir un identificateur de contexte différent pour le même objet Tablet. De plus, un identificateur de contexte de la tablette n'est valide que lorsqu'un objet RealTimeStylus est activé. Si un objet RealTimeStylus est désactivé puis réactivé, pour chaque objet Tablet, l'identificateur de contexte de la tablette peut changer entre la première et la seconde activation de l'objet RealTimeStylus.

Cette méthode lève une exception lorsque le RealTimeStylus est désactivé ou supprimé.

Remarque :
Cette fonction peut être exécutée à nouveau lorsqu'elle est appelée dans certains gestionnaires de messages et provoquer des résultats inattendus. Prenez soin d'éviter un appel réentrant lors de la gestion de l'un des messages suivants : WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam a la valeur SC_HOTKEY ou SC_TASKLIST, et WM_SYSKEYDOWN (lors de l'utilisation des raccourcis clavier Alt+Tab ou Alt+Echap). Cette opération pose problème dans les applications de modèle de thread unique cloisonné.

Cette fonction peut être exécutée à nouveau lorsqu'elle est appelée dans certains gestionnaires de messages et provoquer des résultats inattendus. Prenez soin d'éviter un appel réentrant lors de la gestion de l'un des messages suivants : WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam a la valeur SC_HOTKEY ou SC_TASKLIST, et WM_SYSKEYDOWN (lors de l'utilisation des raccourcis clavier Alt+Tab ou Alt+Echap). Cette opération pose problème dans les applications de modèle de thread unique cloisonné.

Exemples

Cet exemple C# est un extrait de code de l'implémentation de la méthode RealTimeStylusEnabled de l'interface IStylusAsyncPlugin. Le formulaire qui implémente l'interface IStylusAsyncPlugin contient un objet TextBox (page pouvant être en anglais), theTextBox. La méthode RealTimeStylusEnabled affiche des informations concernant les tablettes disponibles lorsque l'objet RealTimeStylus est activé.

using Microsoft.Ink;
using Microsoft.StylusInput;
using Microsoft.StylusInput.PluginData;

// ...

// Declare the RealTimeStylus objects, the GestureRecognizer plugin,
// and the DynamicRenderer plug-in.
private Microsoft.StylusInput.RealTimeStylus thePrimaryRealTimeStylus = null;
private Microsoft.StylusInput.RealTimeStylus theSecondaryRealTimeStylus = null;
private Microsoft.StylusInput.GestureRecognizer theGestureRecognizer = null;
private Microsoft.StylusInput.DynamicRenderer theDynamicRenderer = null;

// ...

// Called when the RealTimeStylus is enabled, or when the plug-in is added to
// a RealTimeStylus that is already enabled.
public void RealTimeStylusEnabled(RealTimeStylus sender,
    RealTimeStylusEnabledData data)
{
    // Display the list of available tablets.
    this.theTextBox.Text = string.Format(
        "RealTimeStylus enabled ({0} tablets attached):" + Environment.NewLine,
        data.Count);
    foreach (int theContextId in data)
    {
        Tablet theTablet =
            this.thePrimaryRealTimeStylus.GetTabletFromTabletContextId(theContextId);

        this.theTextBox.Text += string.Format(
            "  ContextId = {0}, Tablet.Name = {1}" + Environment.NewLine,
            theContextId, theTablet.Name);

        this.theTextBox.Text += "   Available packet properties:" + Environment.NewLine;

        foreach(TabletPropertyDescription theTabletPropertyDescription in
            this.thePrimaryRealTimeStylus.GetTabletPropertyDescriptionCollection(theContextId))
        {
            this.theTextBox.Text += string.Format("    {0}" + Environment.NewLine,
                this.GetPacketPropertyNameFromGuid(theTabletPropertyDescription.PacketPropertyId));
        }
    }
}

Plateformes

Windows Vista, Windows XP SP2, Windows Server 2003

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.