iTextStoreAnchor::QueryInsert 方法 (textstor.h)
ITextStoreAnchor::QueryInsert 方法會判斷指定的開始和結束錨點是否有效。 執行編輯之前,請使用此方法來調整檔的編輯。 方法不得傳回檔範圍以外的值。
語法
HRESULT QueryInsert(
[in] IAnchor *paTestStart,
[in] IAnchor *paTestEnd,
[in] ULONG cch,
[out] IAnchor **ppaResultStart,
[out] IAnchor **ppaResultEnd
);
參數
[in] paTestStart
接收插入文字之開始錨點的指標。
[in] paTestEnd
接收插入文字之結束錨點的指標。 如果文字插入點而不是取代選取的文字,則這與 paTestStart 相同。
[in] cch
取代文字的長度。
[out] ppaResultStart
插入文字起始位置之新錨點物件的指標。 如果此參數的值是 NULL,則文字無法插入指定的位置。 此錨點不能位於檔外部。
[out] ppaResultEnd
插入文字結尾位置之新錨點物件的指標。 如果此參數的值是 NULL,則文字無法插入指定的位置。 此錨點不能位於檔外部。
傳回值
這個方法可以傳回下列其中一個值。
值 | 描述 |
---|---|
|
此方法成功。 |
|
發生未指定的錯誤。 |
|
paTestStart 或 paTestEnd 參數無效。 |
|
嘗試具現化 ppaResultStart 和/或 ppaResultEnd 錨點失敗。 |
備註
ppaResultStart 和 ppaResultEnd 的值取決於應用程式如何將文字插入檔中。 如果 ppaResultStart 和 ppaResultEnd 與 paTestStart 相同,則游標會在插入後的文字開頭。 如果 ppaResultStart 和 ppaResultEnd 與 paTextEnd 相同,則游標會在插入後的文字結尾。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | textstor.h |
Dll | Msctf.dll |
可轉散發套件 | Windows 2000 專業版上的 TSF 1.0 |