共用方式為


ITextStoreACP2::QueryInsert 方法 (textstor.h)

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

語法

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
acpTestStartacpTestEnd 參數無效。

備註

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

規格需求

需求
最低支援的用戶端 Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 textstor.h
Dll Msctf.dll

另請參閱

ITextStoreACP2