Metodo RealTimeStylus.AddCustomStylusDataToQueue

Articolo
10/29/2008

Aggiornamento: novembre 2007

Aggiunge dati personalizzati a una coda dell'oggetto RealTimeStylus.

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

Sintassi

'Dichiarazione
Public Sub AddCustomStylusDataToQueue ( _
    queue As StylusQueues, _
    guid As Guid, _
    data As Object _
)
'Utilizzo
Dim instance As RealTimeStylus
Dim queue As StylusQueues
Dim guid As Guid
Dim data As Object

instance.AddCustomStylusDataToQueue(queue, _
    guid, data)

public void AddCustomStylusDataToQueue(
    StylusQueues queue,
    Guid guid,
    Object data
)

public:
void AddCustomStylusDataToQueue(
    StylusQueues queue, 
    Guid guid, 
    Object^ data
)

public void AddCustomStylusDataToQueue(
    StylusQueues queue,
    Guid guid,
    Object data
)

public function AddCustomStylusDataToQueue(
    queue : StylusQueues, 
    guid : Guid, 
    data : Object
)

Parametri

queue
Tipo: Microsoft.StylusInput.StylusQueues
Uno dei valori StylusQueues che specifica la coda e la posizione all'interno della coda nella quale aggiungere i dati personalizzati.

guid
Tipo: System.Guid
GUID che identifica il tipo di dati personalizzati aggiunti.

data
Tipo: System.Object
Dati personalizzati da aggiungere alla coda.

Note

Questo metodo consente di estendere la funzionalità dell'oggetto RealTimeStylus aggiungendo informazioni personalizzate alla coda dell'oggetto RealTimeStylus. Tali informazioni vengono aggiunte come un oggetto CustomStylusData. Questo metodo rappresenta un modo per implementare la selezione e la cancellazione nell'oggetto RealTimeStylus creando dati personalizzati per l'attivazione e la disattivazione delle modalità di selezione e cancellazione.

È possibile aggiungere dati dello stilo personalizzati alle code dell'oggetto RealTimeStylus, StylusQueues, in uno dei tre punti.

Quando il parametro queue è impostato su Input, i dati personalizzati vengono aggiunti alla coda di input dell'oggetto RealTimeStylus e inviati all'insieme di plug-in sincroni prima dei nuovi dati del flusso di dati della penna del Tablet PC.

Quando il parametro queue è impostato su Output, i dati personalizzati vengono aggiunti alla coda di output dell'oggetto RealTimeStylus dopo i dati attualmente elaborati dall'insieme di plug-in sincroni.

Quando il parametro queue è impostato su OutputImmediate, i dati personalizzati vengono aggiunti alla coda di output dell'oggetto RealTimeStylus prima dei dati attualmente elaborati dall'insieme di plug-in sincroni.

In ognuno dei casi precedenti, i dati aggiunti dai plug-in successivi nell'insieme di plug-in sincroni vengono aggiunti dopo i dati aggiunti dai plug-in precedenti.

I dati dello stilo personalizzati vengono aggiunti alla coda come un oggetto CustomStylusData e i plug-in ricevono questi dati tramite il relativo metodo IStylusSyncPlugin.CustomStylusDataAdded o IStylusAsyncPlugin.CustomStylusDataAdded.

Quando un oggetto che non si trova sul thread dell'oggetto RealTimeStylus chiama il metodo AddCustomStylusDataToQueue, la relazione dei dati personalizzati nelle code rispetto ai pacchetti che l'oggetto RealTimeStylus elabora è indeterminata.

Avviso

L'aggiunta di dati personalizzati alla coda di input in risposta a dati personalizzati ricevuti da un oggetto che implementa l'interfaccia IStylusSyncPlugin può creare un ciclo infinito nel thread dell'oggetto RealTimeStylus.

Per ulteriori informazioni sull'ordine in cui i dati vengono aggiunti alle code, incluse le illustrazioni, vedere gli argomenti concettuali contenuti in Accessing and Manipulating Stylus Input.

Nell'elenco seguente vengono descritte le condizioni in cui questo metodo genera un'eccezione.

L'oggetto RealTimeStylus viene eliminato.
Il parametro data è null (Nothing in Visual Basic .NET).
L'oggetto RealTimeStylus non è abilitato.
All'oggetto RealTimeStylus non sono associati plug-in adatti a ricevere informazioni dalla coda specificata.
Il parametro guid è impostato sul GUID associato alla classe DynamicRenderer o GestureRecognizer.

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.