RealTimeStylus.GetTabletPropertyDescriptionCollection, méthode

Article
11/05/2008

Mise à jour : November 2007

Retourne la collection TabletPropertyDescriptionCollection associée à 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 GetTabletPropertyDescriptionCollection ( _
    tabletContextId As Integer _
) As TabletPropertyDescriptionCollection
'Utilisation
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

Paramètres

tabletContextId
Type : System.Int32
Identificateur de contexte de la tablette pour l'objet Tablet pour lequel vous souhaitez les descriptions de la propriété du paquet.

Valeur de retour

Type : Microsoft.Ink.TabletPropertyDescriptionCollection
Collection TabletPropertyDescriptionCollection associée à un identificateur de contexte de la tablette donné.

Notes

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

Exemples

Cet exemple C# est un extrait de code de l'implémentation de la méthode TabletAdded 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 TabletAdded affiche des informations concernant le Tablet PC ajouté, appelle la méthode GetTabletContextIdFromTablet pour obtenir l'identificateur de contexte de la tablette et appelle la méthode GetTabletPropertyDescriptionCollection pour obtenir la liste des propriétés de paquet prises en charge par le Tablet PC.

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)
    {
        // ...
    }
}

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.