ITextStoreACP2::RequestAttrsAtPosition メソッド (textstor.h)

  • [アーティクル]

指定した文字位置にあるテキスト属性を取得します。

構文

HRESULT RequestAttrsAtPosition(
  [in] LONG            acpPos,
  [in] ULONG           cFilterAttrs,
  [in] const TS_ATTRID *paFilterAttrs,
  [in] DWORD           dwFlags
);

パラメーター

[in] acpPos

ドキュメント内のアプリケーション文字の位置を指定します。

[in] cFilterAttrs

取得する属性の数を指定します。

[in] paFilterAttrs

検証する属性を指定する TS_ATTRID データ型へのポインター。

[in] dwFlags

RetrieveRequestedAttrs メソッドの呼び出しの属性を指定します。 このパラメーターが設定されていない場合、メソッドは指定した位置から始まる属性を返します。 このパラメーターに使用できるその他の値は次のとおりです。

値 説明
TS_ATTR_FIND_WANT_END
 指定したアプリケーション文字位置で終わる属性を取得します。
TS_ATTR_FIND_WANT_VALUE
 属性に加えて、 属性の値を取得します。 属性値は、RetrieveRequestedAttrs メソッドの呼び出し中に、TS_ATTRVAL 構造体の varValue メンバーに格納されます。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 説明
S_OK
 メソッドは正常に実行されました。

解説

"This is italic text" という文では、italic 属性 は斜 体という単語の前から始まり、単語 テキストの後で終わります。

dwFlags でフラグ TS_ATTR_FIND_WANT_ENDが設定されている場合、アンカー位置に終了遷移があるため、メソッドはテキスト "斜体アンカー>標準" の斜体<属性を返します。

要件

   
サポートされている最小のクライアント Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー textstor.h
[DLL] Msctf.dll

関連項目

ITextStoreACP2

RetrieveRequestedAttrs

TS_ATTRID

TS_ATTRVAL

TS_ATTR_* 定数