RealTimeStylus.AddCustomStylusDataToQueue (Método)

Artículo
11/26/2008

Actualización: noviembre 2007

Agrega datos personalizados a una cola del objeto RealTimeStylus.

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

Sintaxis

'Declaración
Public Sub AddCustomStylusDataToQueue ( _
    queue As StylusQueues, _
    guid As Guid, _
    data As Object _
)
'Uso
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
)

Parámetros

queue
Tipo: Microsoft.StylusInput.StylusQueues
Uno de los valores StylusQueues que especifica la cola y la ubicación de la cola en la que se agregan los datos personalizados.

guid
Tipo: System.Guid
Identificador único global (GUID) que identifica el tipo de datos personalizados que se agregan.

data
Tipo: System.Object
Datos personalizados que se agregan a la cola.

Comentarios

Este método permite extender la funcionalidad del objeto RealTimeStylus al agregar información personalizada a la cola del objeto RealTimeStylus. Esa información se agrega como un objeto CustomStylusData. Este método es una manera de implementar la selección y el borrado en un objeto RealTimeStylus mediante la creación de datos personalizados para entrar y salir de los modos de selección y borrado.

Los datos de lápiz personalizados se pueden agregar a las colas del objeto RealTimeStylus, StylusQueues, en uno de tres lugares.

Cuando el parámetro queue se establece en Input, los datos personalizados se agregan a la cola de entrada del objeto RealTimeStylus y se envían a la colección de complementos sincrónicos antes que los nuevos datos de la secuencia de datos del lápiz de Tablet PC.

Cuando el parámetro queue se establece en Output, los datos personalizados se agregan a la cola de salida del objeto RealTimeStylus después de los datos que la colección de complementos sincrónicos procesa actualmente.

Cuando el parámetro queue se establece en OutputImmediate, los datos personalizados se agregan a la cola de salida del objeto RealTimeStylus antes de los datos que la colección de complementos sincrónicos procesa actualmente.

En cada uno de los casos mencionados, los datos agregados por los complementos posteriores de la colección de complementos sincrónicos se agregan después de los datos agregados por los complementos anteriores.

Los datos de lápiz personalizados se agregan a la cola como un objeto CustomStylusData y los complementos reciben estos datos a través de su método IStylusSyncPlugin.CustomStylusDataAdded o IStylusAsyncPlugin.CustomStylusDataAdded.

Cuando un objeto que no está en el subproceso del objeto RealTimeStylus llama al método AddCustomStylusDataToQueue, la relación de los datos personalizados en las colas de los paquetes que procesa el objeto RealTimeStylus es indeterminada.

Advertencia

Al agregar datos personalizados a la cola de entrada como respuesta a los datos personalizados recibidos por un objeto que implementa la interfaz IStylusSyncPlugin se puede crear un bucle sin fin en el subproceso del objeto RealTimeStylus.

Para obtener más información sobre el orden en el que se agregan los datos a las colas, así como ilustraciones, consulte los temas conceptuales incluidos en Accessing and Manipulating Stylus Input.

La lista siguiente describe las condiciones en las que este método produce una excepción.

El objeto RealTimeStylus se desecha.
El parámetro data es nulo (Nothing en Visual Basic .NET).
El objeto RealTimeStylus no está habilitado.
Ningún complemento adecuado está asociado al objeto RealTimeStylus para recibir información de la cola especificada.
El parámetro guid está establecido en el GUID asociado a la clase GestureRecognizer o DynamicRenderer.

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.