RealTimeStylus.GetTabletPropertyDescriptionCollection (Método)

Artículo
10/28/2008

Actualización: noviembre 2007

Devuelve la colección TabletPropertyDescriptionCollection que está asociada a un identificador de contexto de Tablet PC dado.

Espacio de nombres: Microsoft.StylusInput
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Function GetTabletPropertyDescriptionCollection ( _
    tabletContextId As Integer _
) As TabletPropertyDescriptionCollection
'Uso
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

Parámetros

tabletContextId
Tipo: System.Int32
Identificador de contexto de Tablet PC correspondiente al objeto Tablet para el que desea las descripciones de las propiedades del paquete.

Valor devuelto

Tipo: Microsoft.Ink.TabletPropertyDescriptionCollection
Colección TabletPropertyDescriptionCollection asociada a un identificador de contexto de Tablet PC determinado.

Comentarios

Este método inicia una excepción cuando RealTimeStylus se deshabilita o se elimina.

Ejemplos

Este ejemplo de C# es un fragmento de código de la implementación del método TabletAdded de la interfaz IStylusAsyncPlugin. El formulario que implementa la interfaz IStylusAsyncPlugin contiene un objeto TextBox, theTextBox. El método TabletAdded muestra información sobre el Tablet PC que se agregó, llama el método GetTabletContextIdFromTablet para obtener el identificador de contexto de Tablet PC y llama al método GetTabletPropertyDescriptionCollection para obtener la lista de propiedades de paquete admitidas por el 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)
    {
        // ...
    }
}

Plataformas

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.