次の方法で共有

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

  • [アーティクル]

コントロールのプロパティ (ビットで表される) を設定します。

構文

HRESULT OnTxPropertyBitsChange(
  [in] DWORD dwMask,
  [in] DWORD dwBits
);

パラメーター

[in] dwMask

型: DWORD

変更するプロパティを表すビット。 使用可能なビット値については、 dwBits のTXTBIT_* 値の一覧を参照してください。

[in] dwBits

型: DWORD

ビット プロパティの新しい値。 以下の任意の組み合わせが可能である。

値 意味
TXTBIT_ALLOWBEEP
 TRUE の場合、ビープ音が有効になります。
TXTBIT_AUTOWORDSEL
 TRUE の場合、AutoWordSelect 機能が有効になります。
TXTBIT_BACKSTYLECHANGE
 TRUE の場合、バックスタイルが変更されます。 TxGetBackStyle に関するページを参照してください。
TXTBIT_CHARFORMATCHANGE
 TRUE の場合、文字形式が変更されます。
TXTBIT_CLIENTRECTCHANGE
 TRUE の場合、クライアントの四角形が変更されます。
TXTBIT_DISABLEDRAG
 TRUE の場合、ドラッグは無効になります。
TXTBIT_D2DDWRITE
 GDI/Uniscribe ではなく、このインスタンスに Direct2D/DirectWrite を使用します。
TXTBIT_D2DPIXELSNAPPED
 最も近いピクセル位置にグリフをレンダリングします。 D2DDWRITEが設定されている場合にのみ有効です。
TXTBIT_D2DSUBPIXELLINES
 サブピクセル精度で線を描画します。 2 番目のテキスト フロー方向 (通常は垂直) では、テキストの線、下線、取り消し線をピクセル スナップしないでください。 D2DDWRITEが設定されていて、D2DPIXELSNAPPEDが設定されていない場合にのみ有効です。
TXTBIT_D2DSIMPLETYPOGRAPHY
 単純な文字体裁を使用してテキストをレンダリングします (グリフ レンダリングなし)。 この値は、TXTBIT_D2DDWRITEも指定されている場合にのみ有効です。
TXTBIT_EXTENTCHANGE
 TRUE の場合、クライアントの四角形のサイズが変更されます。
TXTBIT_HIDESELECTION
 TRUE の場合、コントロールが非アクティブな場合、テキスト サービス オブジェクトは選択範囲を非表示にする必要があります。 FALSE の場合、コントロールが非アクティブな場合に選択内容が表示されます。

これは、 TXTBIT_SAVESELECTION が TRUE であることを意味します。
TXTBIT_MAXLENGTHCHANGE
 TRUE の場合、コントロール内のテキストの最大長が変更されます。
TXTBIT_MULTILINE
 TRUE の場合、テキスト サービス オブジェクトは複数行モードで動作する必要があります。 TXTBIT_WORDWRAP値を使用して、ビューの四角形に線を折り返すかクリップするかを決定します。

FALSE の場合、テキスト サービス オブジェクトは ENTER キーからの復帰/改行を処理せず、最初の改行の直前に改行を含む受信テキストを切り捨てる必要があります。 また、 ITextServices::TxSetText で設定されたテキストを切り捨てることも可能です。これは、複数行フィールドにバインドされるときに、ホストが 1 行のコントロールを使用しないようにする必要があるためです。
TXTBIT_NOTHREADREFCOUNT
 このインスタンスの代わりに TLS データを参照しないでください。
TXTBIT_PARAFORMATCHANGE
 TRUE の場合、段落の書式が変更されます。
TXTBIT_READONLY
 TRUE の場合、テキスト サービス オブジェクトは、ユーザー インターフェイスによる編集の変更を受け入れないようにする必要があります。 ただし、 EM_SETTEXTEX、 EM_REPLACESEL、 ITextServices::TxSetText を使用したプログラムによる変更は引き続き受け入れる必要があります。 また、ユーザーは、カーソルを移動したり、テキストを選択したり、コンテンツを変更しない他の操作 (コピーなど) を実行したりできます。
TXTBIT_RICHTEXT
 TRUE の場合、テキスト サービス オブジェクトはリッチ テキスト モードである必要があります。

FALSE の場合、プレーンテキスト モードになります。

これは、編集コマンドの適用方法に影響します。 たとえば、プレーンエディット コントロールのテキストの一部に太字を適用すると、テキスト全体が太字になります。 ただし、リッチ エディット コントロールの場合、選択したテキストのみが太字になります。
TXTBIT_SAVESELECTION
 TRUE の場合、コントロールが非アクティブな場合は、選択範囲の境界を保存する必要があります。

FALSE の場合、コントロールが再びアクティブになると、選択範囲の境界をリセットして開始 = 0、長さ = 0 にすることができます。
TXTBIT_SCROLLBARCHANGE
 TRUE の場合、スクロール バーは変更されています。
TXTBIT_SELBARCHANGE
 TRUE の場合、選択バーの幅が変更されました
TXTBIT_SHOWACCELERATOR
 設定すると、アクセラレータ文字に下線が付く必要があります。

これは、TxGetAcceleratorPos を呼び出すために設定する必要があります。
TXTBIT_SHOWPASSWORD
 パスワード文字列を表示します。
TXTBIT_USECURRENTBKG
 サポートされていません。
TXTBIT_USEPASSWORD
 TRUE の場合は、TxGetPasswordChar によって取得されたパスワード文字を使用してテキストを表示します。

このプロパティの通知は、パスワード文字が変更されたか、パスワード文字が以前に使用されなかったが、現在使用されていることを意味します (またはその逆も同様です)。
TXTBIT_VERTICAL
 サポートされていません。
TXTBIT_VIEWINSETCHANGE
 TRUE の場合、インセットが変更されます。
TXTBIT_WORDWRAP
 TRUE とTXTBIT_MULTILINEも TRUE の場合、複数行コントロールは、ビューの四角形に線を折り返す必要があります。 このプロパティが FALSE で 、TXTBIT_MULTILINE が TRUE の場合は、行をラップするのではなく、クリップする必要があります。 ビューの四角形の右側は無視する必要があります。

TXTBIT_MULTILINEが FALSE の場合、このプロパティは無効です。

戻り値

型: HRESULT

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

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

リターン コード 説明
E_NOTIMPL
 実装されていません。

注釈

クライアントの四角形は、テキスト サービス オブジェクトが描画と管理を担当する四角形です。 ホストは、その領域を描画するためにテキスト サービス オブジェクトに依存します。 テキスト サービス オブジェクトは、その四角形の外側の領域を塗りつぶしたり、無効にしたりしてはなりません。 さらに、カーソルがこの四角形の上にある場合、ホストはテキスト サービス オブジェクトにマウス メッセージを転送します。 この四角形は、含まれているウィンドウのクライアント座標で表されます。

ビューのインセットは、クライアントの四角形とビューの四角形の間の両側の領域の量です。 ビューの四角形 (書式設定の四角形とも呼ばれます) は、テキストを書式設定する四角形です。 詳細については、「 TxGetViewInset」を参照してください。

backstyle は、クライアント四角形の背景のスタイルです。 TXTBACK_TRANSPARENTまたはTXTBACK_SOLIDを指定できます。 TXTBACKSTYLE に関するページを参照してください。

スクロール バー プロパティは、スクロール バーに対する変更を示します。スクロール バーが存在するかどうか、スクロールが不可能な場合にスクロール バーを非表示にするか無効にするか、挿入ポイントがクライアントの四角形から外れたときに自動スクロールが有効になっている場合も示します。

要件

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

関連項目

概念

ITextServices

その他のリソース

Rect

リファレンス

TxGetAcceleratorPos

TxGetBackStyle

TxGetClientRect

TxGetPasswordChar

TxSetText

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