Metodo RealTimeStylus.GetTabletContextIdFromTablet

Articolo
10/29/2008

Aggiornamento: novembre 2007

Restituisce l'identificatore di contesto della tavoletta associato a un oggetto Tablet specificato.

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

Sintassi

'Dichiarazione
Public Function GetTabletContextIdFromTablet ( _
    tablet As Tablet _
) As Integer
'Utilizzo
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

Parametri

tablet
Tipo: Microsoft.Ink.Tablet
Oggetto Tablet.

Valore restituito

Tipo: System.Int32
Identificatore di contesto della tavoletta associato all'oggetto Tablet specificato.

Note

Nota

Un identificatore di contesto della tavoletta è specifico dell'oggetto RealTimeStylus; tuttavia due oggetti RealTimeStylus possono disporre di identificatori di contesto diversi per lo stesso oggetto Tablet. Inoltre, un identificatore di contesto della tavoletta è valido solo mentre è abilitato un oggetto RealTimeStylus. Se un oggetto RealTimeStylus viene disabilitato, quindi nuovamente abilitato, l'identificatore di contesto della tavoletta per ogni oggetto Tablet può disporre di un valore diverso rispetto al momento in cui l'oggetto RealTimeStylus era stato abilitato per la prima volta.

Questo metodo genera un'eccezione quando RealTimeStylus viene disabilitato o eliminato o quando il parametro tablet è null (Nothing in Visual Basic).

Nota

Se chiamata all'interno di alcuni gestori di messaggi è possibile che questa funzione venga reimmessa, provocando risultati imprevisti. Prestare attenzione per evitare una chiamata rientrante durante la gestione di uno dei messaggi seguenti: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT, WM_SYSCOMMAND se wParam è impostato su SC_HOTKEY o SC_TASKLIST e WM_SYSKEYDOWN (durante l'elaborazione delle combinazioni di tasti ALT-TAB o ALT-ESC). Questo problema è relativo alle applicazioni con modello di apartment a thread singolo.

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.