ITextStoreACP：：QueryInsert 方法 (textstor.h)

  • 發行項

ITextStoreACP：：QueryInsert 方法會決定指定的開始和結束字元位置是否有效。 使用此方法在執行編輯之前，先調整文件的編輯。 方法不得傳回檔範圍以外的值。

語法

HRESULT QueryInsert(
  [in]  LONG  acpTestStart,
  [in]  LONG  acpTestEnd,
  [in]  ULONG cch,
  [out] LONG  *pacpResultStart,
  [out] LONG  *pacpResultEnd
);

參數

[in] acpTestStart

開始插入文字的應用程式字元位置。

[in] acpTestEnd

插入文字的結束應用程式字元位置。 如果文字插入點而不是取代選取的文字，這個值就會等於 acpTextStart 。

[in] cch

取代文字的長度。

[out] pacpResultStart

傳回插入文字的新起始應用程式字元位置。 如果此參數為 NULL，則文字無法插入指定的位置。 此值不能超出檔範圍。

[out] pacpResultEnd

傳回插入文字的新結束應用程式字元位置。 如果此參數為 NULL， 則 pacpResultStart 會設定為 NULL ，而且無法在指定的位置插入文字。 此值不能超出檔範圍。

傳回值

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

值 描述
S_OK
 此方法成功。
E_FAIL
 發生未指定的錯誤。
E_INVALIDARG
 acpTestStart 或 acpTestEnd 參數無效。

備註

pacpResultStart 和 pacpResultEnd 的值取決於應用程式如何將文字插入檔中。 如果 pacpResultStart 和 pacpResultEnd 與 acpTextStart 相同，則游標會在插入後的文字開頭。 如果 pacpResultStart 和 pacpResultEnd 與 acpTextEnd 相同，則游標會在插入後的文字結尾。 如果 pacpResultStart 與 pacpResultEnd 之間的差異等於插入的文字長度，插入的文字會在插入之後反白顯示。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 textstor.h
Dll Msctf.dll
可轉散發套件 Windows 2000 專業版上的 TSF 1.0