RealTimeStylus.GetTabletFromTabletContextId (Método)

Artículo
11/26/2008

Actualización: noviembre 2007

Devuelve el objeto Tablet que está asociado 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 GetTabletFromTabletContextId ( _
    tabletContextId As Integer _
) As Tablet
'Uso
Dim instance As RealTimeStylus
Dim tabletContextId As Integer
Dim returnValue As Tablet

returnValue = instance.GetTabletFromTabletContextId(tabletContextId)

public Tablet GetTabletFromTabletContextId(
    int tabletContextId
)

public:
Tablet^ GetTabletFromTabletContextId(
    int tabletContextId
)

public Tablet GetTabletFromTabletContextId(
    int tabletContextId
)

public function GetTabletFromTabletContextId(
    tabletContextId : int
) : Tablet

Parámetros

tabletContextId
Tipo: System.Int32
Identificador de contexto de Tablet PC para el que desea el objeto Tablet asociado.

Valor devuelto

Tipo: Microsoft.Ink.Tablet
Objeto Tablet que está asociado a un identificador de contexto de Tablet PC dado.

Comentarios

Nota

Un identificador de contexto de Tablet PC es específico de un objeto RealTimeStylus, pero dos objetos RealTimeStylus pueden tener identificadores de contexto diferentes para el mismo objeto Tablet. Además, un identificador de contexto de Tablet PC sólo es válido mientras un objeto RealTimeStylus está habilitado. Si un objeto RealTimeStylus se deshabilita y se vuelve a habilitar, el identificador de contexto de Tablet PC de cada objeto Tablet puede tener un valor diferente al que tenía cuando el objeto RealTimeStylus se habilitó por primera vez.

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

Nota

Esta función puede ser reentrante cuando se llama en determinados controladores de mensajes, lo que produce resultados inesperados. Procure evitar que se produzca una llamada reentrante al controlar cualquiera de los siguientes mensajes: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam se establece en SC_HOTKEY o SC_TASKLIST; y WM_SYSKEYDOWN (al procesar las combinaciones de teclas Alt-Tab o Alt-Esc). Este problema se produce con las aplicaciones del modelo de contenedor uniproceso.

Ejemplos

Este ejemplo de C# es un fragmento de código de la implementación del método RealTimeStylusEnabled de la interfaz IStylusAsyncPlugin. El formulario que implementa la interfaz IStylusAsyncPlugin contiene un objeto TextBox, theTextBox. El método RealTimeStylusEnabled muestra información sobre los Tablet PC que están disponibles en el momento en que se habilita el objeto RealTimeStylus.

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 the RealTimeStylus is enabled, or when the plug-in is added to
// a RealTimeStylus that is already enabled.
public void RealTimeStylusEnabled(RealTimeStylus sender,
    RealTimeStylusEnabledData data)
{
    // Display the list of available tablets.
    this.theTextBox.Text = string.Format(
        "RealTimeStylus enabled ({0} tablets attached):" + Environment.NewLine,
        data.Count);
    foreach (int theContextId in data)
    {
        Tablet theTablet =
            this.thePrimaryRealTimeStylus.GetTabletFromTabletContextId(theContextId);

        this.theTextBox.Text += string.Format(
            "  ContextId = {0}, Tablet.Name = {1}" + Environment.NewLine,
            theContextId, theTablet.Name);

        this.theTextBox.Text += "   Available packet properties:" + Environment.NewLine;

        foreach(TabletPropertyDescription theTabletPropertyDescription in
            this.thePrimaryRealTimeStylus.GetTabletPropertyDescriptionCollection(theContextId))
        {
            this.theTextBox.Text += string.Format("    {0}" + Environment.NewLine,
                this.GetPacketPropertyNameFromGuid(theTabletPropertyDescription.PacketPropertyId));
        }
    }
}

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.