Share via

ITextStoreACP2：：FindNextAttrTransition 方法 (textstor.h)

  • 發行項

決定轉換發生在屬性值中的字元位置。 要檢查的指定屬性與應用程式相關。

語法

HRESULT FindNextAttrTransition(
  [in]  LONG            acpStart,
  [in]  LONG            acpHalt,
  [in]  ULONG           cFilterAttrs,
  [in]  const TS_ATTRID *paFilterAttrs,
  [in]  DWORD           dwFlags,
  [out] LONG            *pacpNext,
  [out] BOOL            *pfFound,
  [out] LONG            *plFoundOffset
);

參數

[in] acpStart

指定要開始搜尋屬性轉換的字元位置。

[in] acpHalt

指定要結束屬性轉換搜尋的字元位置。

[in] cFilterAttrs

指定要檢查的屬性數目。

[in] paFilterAttrs

指定要檢查之屬性 的TS_ATTRID 資料類型指標。

[in] dwFlags

指定搜尋屬性轉換的方向。 根據預設，方法會向前搜尋。

值 意義
TS_ATTR_FIND_BACKWARDS
 方法會向後搜尋。
TS_ATTR_FIND_WANT_OFFSET
 plFoundOffset參數會從acpStart接收屬性轉換的字元位移。

[out] pacpNext

接收下一個字元位置，以檢查屬性轉換。

[out] pfFound

如果找到屬性轉換，則會收到 TRUE 的布林值，否則會傳回FALSE。

[out] plFoundOffset

接收屬性轉換的字元位置， (不是 ACP 位置) 。 如果TS_ATTR_FIND_WANT_OFFSET旗標是在 dwFlags中設定，則會從 acpStart接收屬性轉換的字元位移。

傳回值

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

值 描述
S_OK
 此方法成功。
TS_E_INVALIDPOS
 指定的字元位置超出檔中的文字。

備註

注意 如果應用程式未實作 FindNextAttrTransition， ITfReadOnlyProperty：：EnumRanges 會因為 E_FAIL而失敗。
 

需求

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

另請參閱

ITextStoreACP2

TS_ATTRID

TS_ATTR_* 常數