Compartilhar via

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

  • Artigo

Recupera a coleção de canetas que o objeto Classe RealTimeStylus encontrou.

Sintaxe

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

Parâmetros

[out, retval] ppiInkCursors

Quando esse método retorna, contém um ponteiro para a coleção de canetas que o objeto Classe RealTimeStylus encontrou.

Valor retornado

Para obter uma descrição dos valores retornados, consulte Classes e interfaces RealTimeStylus.

Comentários

A coleção Classe RealTimeStylus inclui as canetas para as quais um contexto de tablet foi criado. A coleção não inclui todas as canetas disponíveis no sistema na coleção stylus.

Se nenhum objeto stylus tiver sido detectado nos objetos tablet associados ao objeto Classe RealTimeStylus , esse método retornará uma matriz vazia.

Esse método não pode ser chamado a menos que o objeto Classe RealTimeStylus esteja conectado e habilitado classe RealTimeStylus.

Nota Esse método poderá ser chamado se A Propriedade IRealTimeStylus::Enabled retornar false, desde que o objeto Classe RealTimeStylus não tenha terminado de processar dados na fila. Esse método pode ser chamado até que o último plug-in assíncrono receba o Método IStylusPlugin::RealTimeStylusDisabled.
 

Exemplos

O código de exemplo C++ a seguir obtém uma matriz dos objetos Stylus que o objeto Classe RealTimeStylus encontrou desde que foi habilitado pela última vez. Em seguida, itera por meio da matriz relatando a ID de cada caneta na saída de depuração.

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 com suporte Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho rtscom.h
DLL RTSCom.dll

Confira também

IRealTimeStylus

Método IRealTimeStylus::GetStylusForId

Classe RealTimeStylus