InkDisp 類別

代表筆跡空間內所收集的筆墨筆劃。

InkDisp 具有下列類型的成員：

• 事件
• 介面
• 方法
• 屬性

事件

InkDisp類別具有這些事件。

事件	描述
InkAdded	發生于筆劃新增至 InkDisp 物件時。
InkDeleted	發生于從 InkDisp 物件中刪除筆劃時。

介面

InkDisp類別會定義這些介面。

介面	描述
IInkDisp	這個物件會實作 IInkDisp COM 介面。

方法

InkDisp類別具有這些方法。

方法	Description
AddStrokesAtRectangle	將筆劃集合插入到指定矩形的 InkDisp 物件中。
CanPaste	指出 IDataObject 是否可以轉換成 InkDisp 物件。
裁剪	移除矩形外部的筆劃或筆劃集合部分。
剪貼簿Copy	將 InkStrokes 集合複製到剪貼簿。
ClipboardCopyWithRectangle	將已知矩形內含的 IInkStrokeDisp 物件複製到剪貼簿。
剪貼簿Paste	將 IDataObject 從剪貼簿複製到 InkDisp 物件。
複製	建立重複的 InkDisp 物件。
CreateStroke	從點或封包資料建立筆劃。
CreateStrokes	建立此InkDisp物件的InkStrokes集合。
DeleteStroke	從 InkDisp 物件刪除筆劃。
DeleteStrokes	從 InkDisp 物件刪除筆劃。
ExtractStrokes 方法	從 InkDisp 物件擷取筆劃，並傳回包含所擷取筆劃的新 InkDisp 物件。
ExtractWithRectangle 方法	使用已知的矩形來判斷要擷取的筆劃，從現有的 InkDisp 類別 物件剪下或複製筆劃，並貼到新的 InkDisp Class 物件中。
GetBoundingBox	擷取 InkDisp 物件中所有筆劃的周框方塊。
HitTestCircle	擷取完全位於已知圓形內部或交集的 InkStrokes 集合。
HitTestWithLasso	擷取多邊形選取區域內的筆劃。
HitTestWithRectangle	擷取包含在指定矩形內的筆劃。
載入	使用已知的二進位資料填入新的 InkDisp 物件。
NearestPoint	擷取InkDisp物件內最接近已知點的IInkStrokeDisp，選擇性地提供其他資訊。
儲存	將筆跡轉換成指定的格式，並傳回二進位資料。

屬性

InkDisp類別具有這些屬性。

屬性	存取類型	Description
CustomStrokes	唯讀	取得要與筆跡一起保存的 IInkCustomStrokes 集合。
髒	讀取/寫入	取得或設定值，這個值表示自上次儲存筆跡以來， InkDisp 物件是否已修改。
ExtendedProperties	唯讀	取得應用程式定義資料的集合。
中風	唯讀	取得InkDisp物件中包含的InkStrokes集合。

備註

此物件可以藉由在 C++ 中呼叫 CoCreateInstance 方法來具現化。

注意

此物件的第一個具現化也會讓 GDI+ 具現化。 副作用是，如果您在迴圈中使用單一筆跡物件並在迴圈內建立並終結它，您將會導致 GDI+ 在迴圈中具現化。 這可能會導致應用程式中的效能降低。 若要避免這種情況，請在您的應用程式使用筆跡時隨時保留筆跡物件的單一實例。

InkDisp物件是筆劃 (點) 資料的容器。 筆劃資料或手寫筆所收集的點會放入 InkDisp 物件中。 Strokes屬性包含InkDisp物件內所有筆劃的資料。

InkCollector物件InkOverlay物件和InkPicture控制項會收集輸入裝置中的點，並將其放入InkDisp物件中。 這些物件基本上會做為將筆跡散發至一或多個不同 InkDisp 物件的來源，以作為保存分散式筆跡的容器。

筆跡空間是平板電腦內容對應的虛擬座標空間。 此空間固定為 HIMETRIC 座標系統。 在筆跡空間座標中，從 0 移至 1 等於 1 HIMETRIC 單位。 此對應可讓您輕鬆地建立多個 InkDisp 物件的關聯。

InkRenderer物件會管理筆跡與顯示視窗之間的對應。

規格需求

需求	值
最低支援的用戶端	Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器	都不支援
標頭	Msinkaut.h (也需要 Msinkaut_i.c)
程式庫	InkObj.dll

另請參閱

IInkStrokeDisp 介面

InkStrokes 集合

IInkTablet 介面