IRealTimeStylus：：GetStyluses 方法 (rtscom.h)

擷取 RealTimeStylus Class 物件的手寫筆集合。

語法

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

參數

[out, retval] ppiInkCursors

當這個方法傳回時，會包含 RealTimeStylus Class 物件所遇到手寫筆集合的指標。

傳回值

如需傳回值的描述，請參閱 RealTimeStylus 類別和介面。

備註

RealTimeStylus 類別集合包含已建立平板電腦內容的手寫筆。 集合不包含手寫筆集合中系統中可用的所有手寫筆。

如果在與 RealTimeStylus Class 物件相關聯的平板電腦物件上未偵測到手寫筆物件，這個方法會傳回空陣列。

除非 RealTimeStylus Class 物件已連接並啟用 RealTimeStylus 類別，否則無法呼叫這個方法。

注意 如果 IRealTimeStylus：：Enabled 屬性 傳回 false，只要 RealTimeStylus Class 物件尚未完成佇列中的資料處理，就可以呼叫這個方法。 在最後一個非同步外掛程式收到 IStylusPlugin：：RealTimeStylusDisabled 方法之前，可以呼叫這個方法。

 

範例

下列 C++ 範例程式碼會取得自上次啟用以來， RealTimeStylus Class 物件所遇到的 Stylus 物件陣列。 然後，它會逐一查看陣列，報告偵錯輸出中每個手寫筆的識別碼。

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
標頭	rtscom.h
Dll	RTSCom.dll

另請參閱

IRealTimeStylus

IRealTimeStylus：：GetStylusForId 方法

RealTimeStylus 類別