RealTimeStylus.GetTabletFromTabletContextId-Methode

Artikel
11/26/2008

Gibt das einem angegebenen Tablettkontextbezeichner zugeordnete Tablet-Objekt zurück.

Namespace: Microsoft.StylusInput
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Function GetTabletFromTabletContextId ( _
    tabletContextId As Integer _
) As Tablet
'Usage
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

Parameter

tabletContextId
Typ: System.Int32
Der Tablettkontextbezeichner, für den Sie das zugeordnete Tablet-Objekt anfordern.

Rückgabewert

Typ: Microsoft.Ink.Tablet
Das einem angegebenen Tablettkontextbezeichner zugeordnete Tablet-Objekt.

Hinweise

Hinweis

Ein Tablettkontextbezeichner ist spezifisch für das RealTimeStylus-Objekt. Zwei RealTimeStylus-Objekte verfügen jedoch u. U. über unterschiedliche Kontextbezeichner für dasselbe Tablet-Objekt. Außerdem ist ein Tablettkontextbezeichner nur gültig, solange ein RealTimeStylus-Objekt aktiviert ist. Wird ein RealTimeStylus-Objekt deaktiviert und dann erneut aktiviert, weist der Tablettkontextbezeichner für jedes Tablet-Objekt ggf. einen Wert auf, der sich von dem Wert seit der ersten Aktivierung des RealTimeStylus-Objekts unterscheidet.

Diese Methode löst eine Ausnahme aus, wenn der RealTimeStylus deaktiviert ist oder freigegeben wurde.

Hinweis

Diese Funktion kann rekursiv ausgeführt werden, wenn sie in bestimmten Meldungshandlern aufgerufen wird, und unerwartete Ergebnisse verursachen. Vermeiden Sie unbedingt den wieder eintretenden Aufruf, wenn Sie eine der folgenden Meldungen behandeln: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT sowie WM_SYSCOMMAND, wenn wParam auf SC_HOTKEY oder SC_TASKLIST festgelegt ist, und WM_SYSKEYDOWN (wenn die Tastenkombinationen ALT+TAB oder ALT+ESC verarbeitet werden). Dieses Problem tritt bei Anwendungen des Singlethread-Apartment-Modells auf.

Beispiele

Dieses C#-Beispiel ist ein Ausschnitt aus der Implementierung der RealTimeStylusEnabled-Methode der IStylusAsyncPlugin-Schnittstelle. Das Formular, das die IStylusAsyncPlugin-Schnittstelle implementiert, enthält das TextBox-Objekt theTextBox. Die RealTimeStylusEnabled-Methode zeigt Informationen über Tabletts an, die zum Zeitpunkt der Aktivierung des RealTimeStylus-Objekts verfügbar sind.

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));
        }
    }
}

Plattformen

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.