Metodo RealTimeStylus.GetTabletPropertyDescriptionCollection

Articolo
10/29/2008

Aggiornamento: novembre 2007

Restituisce l'insieme TabletPropertyDescriptionCollection associato a un identificatore di contesto della tavoletta specificato.

Spazio dei nomi: Microsoft.StylusInput
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Function GetTabletPropertyDescriptionCollection ( _
    tabletContextId As Integer _
) As TabletPropertyDescriptionCollection
'Utilizzo
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

Parametri

tabletContextId
Tipo: System.Int32
Identificatore di contesto della tavoletta per l'oggetto Tablet per il quale si desiderano le descrizioni delle proprietà dei pacchetti.

Valore restituito

Tipo: Microsoft.Ink.TabletPropertyDescriptionCollection
Insieme TabletPropertyDescriptionCollection associato a un identificatore di contesto della tavoletta specificato.

Note

Il metodo genera un'eccezione quando RealTimeStylus viene disabilitato o eliminato.

Esempi

Questo esempio C# è un frammento tratto dall'implementazione del metodo TabletAdded dell'interfaccia IStylusAsyncPlugin. Il form che implementa l'interfaccia IStylusAsyncPlugin contiene un oggetto TextBox, theTextBox. Nel metodo TabletAdded vengono visualizzate informazioni sulla tavoletta aggiunta, viene chiamato il metodo GetTabletContextIdFromTablet per ottenere l'identificatore di contesto della tavoletta e viene chiamato il metodo GetTabletPropertyDescriptionCollection per ottenere l'elenco delle proprietà dei pacchetti supportate dalla tavoletta.

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

Piattaforme

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.