ITextStoreACP：：FindNextAttrTransition 方法 (textstor.h)

  • 發行項

ITextStoreACP：：FindNextAttrTransition方法會決定在屬性值中發生轉換的字元位置。 要檢查的指定屬性與應用程式相依。

語法

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
 指定的字元位置超出檔中的文字。

備註

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

需求

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

另請參閱

ITextStoreACP

TS_ATTRID

TS_ATTR_* 常數