RealTimeStylus.AddCustomStylusDataToQueue-Methode

Artikel
11/26/2008

Fügt einer Warteschlange des RealTimeStylus-Objekts benutzerdefinierte Daten hinzu.

Namespace: Microsoft.StylusInput
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Sub AddCustomStylusDataToQueue ( _
    queue As StylusQueues, _
    guid As Guid, _
    data As Object _
)
'Usage
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
)

Parameter

queue
Typ: Microsoft.StylusInput.StylusQueues
Einer der StylusQueues-Werte, die die Warteschlange und die Position in der Warteschlange angeben, an der die benutzerdefinierten Daten einzugeben sind.

guid
Typ: System.Guid
Die GUID (Globally Unique Identifier), die den Typ der hinzugefügten benutzerdefinierten Daten identifiziert.

data
Typ: System.Object
Die der Warteschlange hinzuzufügenden benutzerdefinierten Daten.

Hinweise

Mithilfe dieser Methode können Sie die Funktionen des RealTimeStylus-Objekts erweitern, indem Sie der Warteschlange des RealTimeStylus-Objekts benutzerdefinierte Informationen hinzufügen. Solche Informationen werden als CustomStylusData-Objekt hinzugefügt. Diese Methode stellt eine Möglichkeit dar, um Auswahl und Löschung auf Ihrem RealTimeStylus-Objekt zu implementieren, indem benutzerdefinierte Daten zum Öffnen und Schließen des Auswahl- bzw. Löschmodus erstellt werden.

Sie können den Warteschlangen des RealTimeStylus-Objekts, StylusQueues, benutzerdefinierte Tablettstiftdaten an einer von drei Positionen hinzufügen.

Wenn der queue-Parameter auf Input festgelegt ist, werden die benutzerdefinierten Daten der Eingabewarteschlange des RealTimeStylus-Objekts hinzugefügt, und sie werden noch vor den neuen Daten vom Tablettstiftdatenstream an die Auflistung der synchronen Plug-Ins übermittelt.

Wenn der queue-Parameter auf Output festgelegt ist, werden die benutzerdefinierten Daten der Ausgabewarteschlange des RealTimeStylus-Objekts im Anschluss an die Daten hinzugefügt, die momentan durch die Auflistung der synchronen Plug-Ins verarbeitet werden.

Wenn der queue-Parameter auf OutputImmediate festgelegt ist, werden die benutzerdefinierten Daten der Ausgabewarteschlange des RealTimeStylus-Objekts vor den Daten hinzugefügt, die momentan durch die Auflistung der synchronen Plug-Ins verarbeitet werden.

In jedem der vorherigen Fälle werden Daten, die durch die nachfolgenden Plug-Ins in der Auflistung der synchronen Plug-Ins hinzugefügt wurden, im Anschluss an die durch vorherigen Plug-Ins hinzugefügten Daten hinzugefügt.

Benutzerdefinierte Tablettstiftdaten werden der Warteschlange als ein CustomStylusData-Objekt hinzugefügt, und Plug-Ins erhalten diese Daten über ihre IStylusSyncPlugin.CustomStylusDataAdded- oder IStylusAsyncPlugin.CustomStylusDataAdded-Methode.

Ruft ein Objekt, das sich nicht auf dem Thread des RealTimeStylus-Objekts befindet, die AddCustomStylusDataToQueue-Methode auf, ist die Beziehung der benutzerdefinierten Daten in der Warteschlange zu den Paketen, die durch das RealTimeStylus-Objekt verarbeitet werden, unbestimmt.

Warnung

Durch Hinzufügen von benutzerdefinierten Daten in die Eingabewarteschlange als Reaktion auf die benutzerdefinierten Daten, die durch ein die IStylusSyncPlugin-Schnittstelle implementierendes Objekt erhalten werden, kann auf dem Thread des RealTimeStylus-Objekts eine Endlosschleife verursacht werden.

Weitere Informationen zur Reihenfolge, in der Daten den Warteschlangen hinzugefügt werden, sowie Abbildungen finden Sie in den konzeptionellen Themen unter Accessing and Manipulating Stylus Input.

In der folgenden Liste werden die Bedingungen geschildert, unter denen diese Methode eine Ausnahme auslöst.

Das RealTimeStylus-Objekt ist freigegeben.
Der data-Parameter ist NULL (Nothing in Visual Basic .NET).
Das RealTimeStylus-Objekt ist nicht aktiviert.
Es sind keine geeigneten Plug-Ins an das RealTimeStylus-Objekt angefügt, um Informationen von der angegebenen Warteschlange zu erhalten.
Der guid-Parameter ist auf die mit der DynamicRenderer- oder der GestureRecognizer-Klasse zugeordnete GUID festgelegt.

Plattformen

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.