RealTimeStylus.GetTabletContextIdFromTablet (Método)

Artículo
10/28/2008

Actualización: noviembre 2007

Devuelve el identificador de contexto de Tablet PC que está asociado a un objeto Tablet determinado.

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

Sintaxis

'Declaración
Public Function GetTabletContextIdFromTablet ( _
    tablet As Tablet _
) As Integer
'Uso
Dim instance As RealTimeStylus
Dim tablet As Tablet
Dim returnValue As Integer

returnValue = instance.GetTabletContextIdFromTablet(tablet)

public int GetTabletContextIdFromTablet(
    Tablet tablet
)

public:
int GetTabletContextIdFromTablet(
    Tablet^ tablet
)

public int GetTabletContextIdFromTablet(
    Tablet tablet
)

public function GetTabletContextIdFromTablet(
    tablet : Tablet
) : int

Parámetros

tablet
Tipo: Microsoft.Ink.Tablet
Objeto Tablet.

Valor devuelto

Tipo: System.Int32
Identificador de contexto de Tablet PC que está asociado al objeto Tablet.

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 produce una excepción cuando RealTimeStylus se deshabilita o se elimina, o cuando el parámetro tablet es null (Nothing en Visual Basic).

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 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.