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

  • [アーティクル]

カーソルを設定するようにテキスト サービス オブジェクトに通知します。

構文

HRESULT OnTxSetCursor(
  [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
);

パラメーター

[in] dwDrawAspect

種類: DWORD

描画の縦横比は、次のいずれかの値になります。

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

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

lindex

型: LONG

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

[in] pvAspect

型: void*

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

[in] ptd

種類: DVTARGETDEVICE*

ターゲット デバイス。

[in] hdcDraw

種類: HDC

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

[in] hicTargetDev

種類: HDC

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

[in] lprcClient

種類: LPCRECT

コントロールのクライアント四角形。 四角形の座標は、含まれているウィンドウのクライアント座標内にあります。 NULL は有効な値です。

[in] x

型: INT

カーソルの x 位置(含むウィンドウのクライアント座標内)。

[in] y

型: INT

カーソルの y 位置(格納しているウィンドウのクライアント座標内)。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値は S_OK。

メソッドが失敗した場合、戻り値は次の HRESULT コードです。 COM エラー コードの詳細については、「COM でのエラー処理」を参照してください。

リターン コード 説明
E_INVALIDARG
 1 つ以上の無効なパラメーター。

注釈

テキスト サービス オブジェクトは、この呼び出しの結果として、正しいカーソルを特定するために再測定される場合があります。 正しいカーソルは TxSetCursor によって設定されます。

lprcClient パラメーターは、マウス カーソルが配置されているコントロールのビューのクライアント四角形です。 lprcClient パラメーターは、WM_SIZE メッセージと同じ方法で、含まれるウィンドウのデバイス座標にあります。 これは、最後にレンダリングされたビューではない可能性があります。 さらに、コントロールがインプレース アクティブの場合、これは現在アクティブなビューではない可能性があります。 その結果、テキスト サービス オブジェクトは、現在のキャッシュの値に対してこの四角形をチェックし、行の再計算が必要かどうかを判断する必要があります。 ズーム係数は、この計算に含める必要があります。 ズーム係数の詳細については、「 TxGetExtent」を参照してください。

このメソッドは、コントロールの画面ビューに対してのみ呼び出す必要があります。 そのため、デバイス コンテキスト (DC) は渡されませんが、画面 DC と見なす必要があります。

詳細については、「 ITextServices::TxDraw の備考」を参照してください。

要件

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

関連項目

概念

ITextServices

その他のリソース

リファレンス

TxDraw

TxGetExtent

TxSetCursor

Wm_size

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