Поделиться через

Метод IRealTimeStylus::GetStyluses (rtscom.h)

  • Статья

Извлекает коллекцию стилусов, с которым столкнулся объект Класса RealTimeStylus .

Синтаксис

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

Параметры

[out, retval] ppiInkCursors

При возврате этим методом содержит указатель на коллекцию стилусов, с которым столкнулся объект Класса RealTimeStylus .

Возвращаемое значение

Описание возвращаемых значений см. в разделе Классы и интерфейсы RealTimeStylus.

Комментарии

Коллекция Класса RealTimeStylus включает стилусы, для которых был создан контекст планшета. Коллекция не включает все стилусы, доступные в системе в коллекции пера.

Если объект пера не обнаружен в объектах планшета, связанных с объектом Класса RealTimeStylus , этот метод возвращает пустой массив.

Этот метод не может быть вызван, если только он не подключен к объекту Класса RealTimeStylus и не включен класс RealTimeStylus.

Примечание Этот метод можно вызвать, если свойство IRealTimeStylus::Enabled возвращает значение false, если объект Класса RealTimeStylus не завершил обработку данных в очереди. Этот метод можно вызывать до тех пор, пока последний асинхронный подключаемый модуль не получит метод IStylusPlugin::RealTimeStylusDisabled.
 

Примеры

В следующем примере кода C++ возвращается массив объектов Stylus, с которым объект RealTimeStylus Class столкнулся с момента последнего включения. Затем он выполняет итерацию по массиву, сообщая идентификатор каждого пера в выходных данных отладки.

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);
            }
        }
    }
}

Требования

   
Минимальная версия клиента Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header rtscom.h
DLL RTSCom.dll

См. также раздел

IRealTimeStylus

Метод IRealTimeStylus::GetStylusForId

Класс RealTimeStylus