RealTimeStylus.GetTabletContextIdFromTablet-Methode

Artikel
10/28/2008

Gibt den Tablettkontextbezeichner zurück, der einem angegebenen Tablet-Objekt zugeordnet ist.

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

Syntax

'Declaration
Public Function GetTabletContextIdFromTablet ( _
    tablet As Tablet _
) As Integer
'Usage
Dim instance As RealTimeStylus
Dim tablet As Tablet
Dim returnValue As Integer

returnValue = instance.GetTabletContextIdFromTablet(tablet)

public int GetTabletContextIdFromTablet(
    Tablet tablet
)

public:
int GetTabletContextIdFromTablet(
    Tablet^ tablet
)

public int GetTabletContextIdFromTablet(
    Tablet tablet
)

public function GetTabletContextIdFromTablet(
    tablet : Tablet
) : int

Parameter

tablet
Typ: Microsoft.Ink.Tablet
Das Tablet-Objekt.

Rückgabewert

Typ: System.Int32
Der dem angegebenen Tablet-Objekt zugeordnete Tablettkontextbezeichner.

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 RealTimeStylus deaktiviert oder freigegeben wird bzw. der tablet-Parameter NULL ist (Nothing in Visual Basic).

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 TabletAdded-Methode der IStylusAsyncPlugin-Schnittstelle. Das Formular, das die IStylusAsyncPlugin-Schnittstelle implementiert, enthält das TextBox-Objekt theTextBox. Die TabletAdded-Methode zeigt Informationen über das hinzugefügte Tablett an, ruft die GetTabletContextIdFromTablet-Methode zum Abrufen des Kontextbezeichners des Tabletts auf und ruft die GetTabletPropertyDescriptionCollection-Methode auf, um die Liste der durch das Tablett unterstützten Paketeigenschaften abzurufen.

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 a tablet is added while the RealTimeStylus is enabled.
public void TabletAdded(RealTimeStylus sender, TabletAddedData data)
{
    // Display information about the tablet that was added.
    int theContextId =
        this.thePrimaryRealTimeStylus.GetTabletContextIdFromTablet(data.Tablet);

    this.theTextBox.Text = string.Format(
        "Tablet added, Name = {0}, ContextId={1}, available packet properties:"
        + Environment.NewLine, data.Tablet.Name, theContextId);

    TabletPropertyDescriptionCollection theTabletProperties =
        this.thePrimaryRealTimeStylus.GetTabletPropertyDescriptionCollection(theContextId);

    foreach(TabletPropertyDescription theTabletPropertyDescription in theTabletProperties)
    {
        // ...
    }
}

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.