ITextServices::TxQueryHitPoint メソッド (textserv.h)

  • [アーティクル]

指定したポイントがテキスト サービス オブジェクトの四角形内にあるかどうかをテストします。

構文

HRESULT TxQueryHitPoint(
  [in]  DWORD          dwDrawAspect,
        LONG           lindex,
  [in]  void           *pvAspect,
  [in]  DVTARGETDEVICE *ptd,
  [in]  HDC            hdcDraw,
  [in]  HDC            hicTargetDev,
  [in]  LPCRECT        lprcClient,
  [in]  INT            x,
  [in]  INT            y,
  [out] DWORD          *pHitResult
);

パラメーター

[in] dwDrawAspect

型: DWORD

描画の縦横比には、次のいずれかの値を指定できます。

値 説明
DVASPECT_CONTENT
 テキスト コンテンツの画面イメージを hdcDraw デバイス コンテキストにレンダリングします。

hicTargetDev パラメーターと ptd パラメーターは、ターゲット デバイス コンテキスト (通常はプリンター) がある場合に情報を提供します。
DVASPECT_DOCPRINT
 プリンターに印刷されたかのように、 hdcDraw デバイス コンテキストにオブジェクトをレンダリングします。 したがって、テキスト サービス オブジェクトはプリンター用に最適化できます (たとえば、白の場合は背景色を塗りません)。 また、特定の画面固有の要素 (選択範囲など) をレンダリングしないでください。

ITextServices::TxGetNaturalSize は、現在のスクロール位置から始まる lprcClient 四角形をレンダリングする必要があります。

lindex

型: LONG

サポートされていません。

[in] pvAspect

型: void*

描画の最適化に関する情報。

[in] ptd

種類: DVTARGETDEVICE*

ターゲット デバイスに関する情報。

[in] hdcDraw

種類: HDC

デバイス コンテキストのレンダリング。

[in] hicTargetDev

種類: HDC

ターゲット情報コンテキスト。

[in] lprcClient

型: LPCRECT

ヒット テストが行われるビューのクライアント (デバイス) 座標内のコントロールのクライアント四角形。

[in] x

型: INT

x 座標は、ヒット テストが行われるビューのクライアント座標でチェックします。

[in] y

型: INT

y 座標は、ヒット テストが行われるビューのクライアント座標でチェックします。

[out] pHitResult

型: DWORD*

ヒット テストの結果。 次の TXTHITRESULT 列挙値のいずれかを指定できます。

値 説明
TXTHITRESULT_CLOSE
 ポイントはクライアントの四角形にあり、非親領域に近い位置にあります。
TXTHITRESULT_HIT
 ポイントはクライアントの四角形内にあり、テキストまたは背景の上が透明ではありません。
TXTHITRESULT_NOHIT
 ポイントは、クライアントの四角形の外側にあります。
TXTHITRESULT_TRANSPARENT
 ポイントはクライアントの四角形内にあり、テキストの上にないか、背景が透明でした。

戻り値

型: HRESULT

戻り値は HRESULT コードです。

解説

このメソッドを使用すると、ホストはテキストに対して透過的なヒット テストを実装できます。

詳細については、「ITextServices::TxDraw」および「ITextServices::OnTxSetCursor」の「解説」セクションを参照してください。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー textserv.h
[DLL] Msftedit.dll

関連項目

概念

ITextServices

OnTxSetCursor

リファレンス

TxDraw

ウィンドウレスリッチエディットコントロール