Método IRealTimeStylus::GetStyluses (rtscom.h)

Recupera la colección de lápices que ha encontrado el objeto RealTimeStylus Class .

Sintaxis

HRESULT GetStyluses(
  [out, retval] IInkCursors **ppiInkCursors
);

Parámetros

[out, retval] ppiInkCursors

Cuando este método vuelve, contiene un puntero a la colección de lápices ópticos que ha encontrado el objeto RealTimeStylus Class .

Valor devuelto

Para obtener una descripción de los valores devueltos, vea RealTimeStylus Classes and Interfaces (Clases e interfaces de RealTimeStylus).

Comentarios

La colección RealTimeStylus Class incluye los lápices para los que se ha creado un contexto de tableta. La colección no incluye todos los lápices ópticos disponibles en el sistema de la colección stylus.

Si no se ha detectado ningún objeto de lápiz óptico en los objetos de tableta asociados al objeto Clase RealTimeStylus , este método devuelve una matriz vacía.

No se puede llamar a este método a menos que el objeto Clase RealTimeStylus esté conectado y habilitado RealTimeStylus Class.

Nota Se puede llamar a este método si la propiedad IRealTimeStylus::Enabled devuelve false siempre que el objeto Clase RealTimeStylus no haya terminado de procesar los datos de la cola. Se puede llamar a este método hasta que el último complemento asincrónico recibe IStylusPlugin::RealTimeStylusDisabled (Método).

 

Ejemplos

El siguiente código de ejemplo de C++ obtiene una matriz de los objetos Stylus que ha encontrado el objeto Clase RealTimeStylus desde que se ha habilitado por última vez. A continuación, recorre en iteración la matriz que notifica el identificador de cada lápiz óptico en la salida de depuración.

IInkCursors *piInkCursors;

if (SUCCEEDED(g_pRealTimeStylus->GetStyluses(&piInkCursors)))
{
    long lCursorCount;
    
    if (SUCCEEDED(piInkCursors->get_Count(&lCursorCount)))
    {
        for (long l = 0; l < lCursorCount; l++)
        {
            LONG sid;
            IInkCursor *piInkCursor;
            IInkCursor *piInkCursorForId;

            piInkCursors->Item(l, &piInkCursor);
            piInkCursor->get_Id(&sid);

            if (SUCCEEDED(g_pRealTimeStylus->GetStylusForId((STYLUS_ID)sid, &piInkCursorForId)))
            {
                TRACE("Got stylus with ID %d\n", sid);
            }
        }
    }
}

Requisitos

Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	rtscom.h
Archivo DLL	RTSCom.dll

Consulte también

IRealTimeStylus

IRealTimeStylus::GetStylusForId (Método)

RealTimeStylus (clase)