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

  • [アーティクル]

コントロールのコンテンツが適切に収まるように、コントロールのサイズを変更できるようにします。

構文

HRESULT TxGetNaturalSize(
            DWORD          dwAspect,
            HDC            hdcDraw,
            HDC            hicTargetDev,
            DVTARGETDEVICE *ptd,
            DWORD          dwMode,
            const SIZEL    *psizelExtent,
  [in, out] LONG           *pwidth,
  [in, out] LONG           *pheight
);

パラメーター

dwAspect

種類: DWORD

図面の側面。 DVASPECT 列挙の値のいずれかを指定できます。

hdcDraw

種類: HDC

描画が行われるデバイス コンテキスト。

hicTargetDev

種類: HDC

テキストを書式設定する必要があるデバイス コンテキスト (WYSIWYG の場合)。

ptd

種類: DVTARGETDEVICE*

ターゲット デバイスの詳細。

dwMode

種類: DWORD

要求された継手の種類。 次のいずれかになります。

値 意味
TXTNS_EMU
 このメソッドのパラメーターの測定単位として、ピクセルではなく英語のメートル法単位 (EMU) を使用します。
TXTNS_FITTOCONTENT
 渡される幅にテキストを書式設定して、テキスト全体に合わせてコントロールのサイズを変更します。 text services オブジェクトは、テキスト全体の高さと最も広い行の幅を返します。

たとえば、ユーザーがコントロールのハンドルの 1 つをダブルクリックすると、これを行う必要があります。
TXTNS_FITTOCONTENT2
 インデントされたコンテンツに合わせてコントロールのサイズを変更します。
TXTNS_FITTOCONTENT3
 インデントされたコンテンツと末尾の空白文字に収まるようにコントロールのサイズを変更します。
TXTNS_FITTOCONTENTWSP
 コントロールのサイズを変更して、格納されていないコンテンツと末尾の空白文字に収まるようにします。
TXTNS_INCLUDELASTLINE
 プレーンテキスト コントロールの場合は、サイズを計算するときに、最終的な復帰の高さを含めます。
TXTNS_ROUNDTOLINE
 整数の行数を表示するようにコントロールのサイズを変更します (行はクリップされません)。 渡される幅と高さを埋めるのに十分なテキストを書式設定し、最も近い行境界に丸められた高さを返します。
メモ 渡された幅と戻り値の幅と高さは、ビューの四角形に対応します。 ホストは、必要に応じてクライアントの四角形に戻す必要があります。 これらの値はテキスト オブジェクトの範囲を表しているため、HIMETRIC 座標 (各 HIMETRIC 単位は .01 ミリメートル) で入力および出力され、測定にはズーム係数は含まれません。 ズーム係数の詳細については、「 TxGetExtent」を参照してください。
 

psizelExtent

型: const SIZEL*

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

[in, out] pwidth

型: LONG*

dwMode によって定義される継手の幅。

[in, out] pheight

型: LONG*

dwMode によって定義される継手の高さ。

戻り値

種類: HRESULT

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

テキスト サービスでオブジェクトをアクティブにできなかった場合、戻り値は次のいずれかの HRESULT コードになります。 COM エラー コードの詳細については、「COM でのエラー処理」を参照してください。

リターン コード 説明
E_FAIL
 正しいサイズを判断できません。
E_INVALIDARG
 1 つ以上の引数が無効です。
E_OUTOFMEMORY
 メモリ不足です。

注釈

最初の 4 つのパラメーターは 、ITextServices::TxDraw の同等のパラメーターに似ていて、同じ情報を提供します。 行を再計算する必要がある場合は、 ITextServices::TxDraw と同じ方法でこれらの値を使用する必要があります。

pwidth パラメーターと pheight パラメーターは、入力/出力パラメーターです。 ホストは、テキスト オブジェクトの自然な範囲の仮の幅と高さを渡します。 テキスト サービス オブジェクトは、これらの値を現在のキャッシュ状態と比較し、異なる場合は行を再計算します。 次に、 dwMode で指定された自然なサイズを計算して返します。

要件

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

関連項目

概念

DVTARGETDEVICE

ITextServices

その他のリソース

リファレンス

TxDraw

TxGetExtent

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