Share via

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，則文字無法插入指定的位置。 此錨點不能位於檔外部。

傳回值

這個方法可以傳回下列其中一個值。

值 描述
S_OK
 此方法成功。
E_FAIL
 發生未指定的錯誤。
E_INVALIDARG
 paTestStart 或 paTestEnd 參數無效。
E_OUTOFMEMORY
 嘗試具現化 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