RealTimeStylus.GetTabletPropertyDescriptionCollection-Methode

Artikel
10/28/2008

Gibt die einem angegebenen Tablettkontextbezeichner zugeordnete TabletPropertyDescriptionCollection-Auflistung zurück.

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

Syntax

'Declaration
Public Function GetTabletPropertyDescriptionCollection ( _
    tabletContextId As Integer _
) As TabletPropertyDescriptionCollection
'Usage
Dim instance As RealTimeStylus
Dim tabletContextId As Integer
Dim returnValue As TabletPropertyDescriptionCollection

returnValue = instance.GetTabletPropertyDescriptionCollection(tabletContextId)

public TabletPropertyDescriptionCollection GetTabletPropertyDescriptionCollection(
    int tabletContextId
)

public:
TabletPropertyDescriptionCollection^ GetTabletPropertyDescriptionCollection(
    int tabletContextId
)

public TabletPropertyDescriptionCollection GetTabletPropertyDescriptionCollection(
    int tabletContextId
)

public function GetTabletPropertyDescriptionCollection(
    tabletContextId : int
) : TabletPropertyDescriptionCollection

Parameter

tabletContextId
Typ: System.Int32
Der Tablettkontextbezeichner für das Tablet-Objekt, für das Sie die Beschreibung der Paketdaten fordern.

Rückgabewert

Typ: Microsoft.Ink.TabletPropertyDescriptionCollection
Die einem angegebenen Tablettkontextbezeichner zugeordnete TabletPropertyDescriptionCollection-Auflistung.

Hinweise

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

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.