ITextServices::OnTxPropertyBitsChange メソッド (textserv.h)
コントロールのプロパティ (ビットで表される) を設定します。
構文
HRESULT OnTxPropertyBitsChange(
[in] DWORD dwMask,
[in] DWORD dwBits
);
パラメーター
[in] dwMask
型: DWORD
変更するプロパティを表すビット。 使用可能なビット値については、 dwBits のTXTBIT_* 値の一覧を参照してください。
[in] dwBits
型: DWORD
ビット プロパティの新しい値。 以下の任意の組み合わせが可能である。
| 値 | 意味 |
|---|---|
|
TRUE の場合、ビープ音が有効になります。 |
|
TRUE の場合、AutoWordSelect 機能が有効になります。 |
|
TRUE の場合、バックスタイルが変更されます。 TxGetBackStyle に関するページを参照してください。 |
|
TRUE の場合、文字形式が変更されます。 |
|
TRUE の場合、クライアントの四角形が変更されます。 |
|
TRUE の場合、ドラッグは無効になります。 |
|
GDI/Uniscribe ではなく、このインスタンスに Direct2D/DirectWrite を使用します。 |
|
最も近いピクセル位置にグリフをレンダリングします。 D2DDWRITEが設定されている場合にのみ有効です。 |
|
サブピクセル精度で線を描画します。 2 番目のテキスト フロー方向 (通常は垂直) では、テキストの線、下線、取り消し線をピクセル スナップしないでください。 D2DDWRITEが設定されていて、D2DPIXELSNAPPEDが設定されていない場合にのみ有効です。 |
|
単純な文字体裁を使用してテキストをレンダリングします (グリフ レンダリングなし)。 この値は、TXTBIT_D2DDWRITEも指定されている場合にのみ有効です。 |
|
TRUE の場合、クライアントの四角形のサイズが変更されます。 |
|
TRUE の場合、コントロールが非アクティブな場合、テキスト サービス オブジェクトは選択範囲を非表示にする必要があります。 FALSE の場合、コントロールが非アクティブな場合に選択内容が表示されます。
これは、 TXTBIT_SAVESELECTION が TRUE であることを意味します。 |
|
TRUE の場合、コントロール内のテキストの最大長が変更されます。 |
|
TRUE の場合、テキスト サービス オブジェクトは複数行モードで動作する必要があります。 TXTBIT_WORDWRAP値を使用して、ビューの四角形に線を折り返すかクリップするかを決定します。
FALSE の場合、テキスト サービス オブジェクトは ENTER キーからの復帰/改行を処理せず、最初の改行の直前に改行を含む受信テキストを切り捨てる必要があります。 また、 ITextServices::TxSetText で設定されたテキストを切り捨てることも可能です。これは、複数行フィールドにバインドされるときに、ホストが 1 行のコントロールを使用しないようにする必要があるためです。 |
|
このインスタンスの代わりに TLS データを参照しないでください。 |
|
TRUE の場合、段落の書式が変更されます。 |
|
TRUE の場合、テキスト サービス オブジェクトは、ユーザー インターフェイスによる編集の変更を受け入れないようにする必要があります。 ただし、 EM_SETTEXTEX、 EM_REPLACESEL、 ITextServices::TxSetText を使用したプログラムによる変更は引き続き受け入れる必要があります。 また、ユーザーは、カーソルを移動したり、テキストを選択したり、コンテンツを変更しない他の操作 (コピーなど) を実行したりできます。 |
|
TRUE の場合、テキスト サービス オブジェクトはリッチ テキスト モードである必要があります。
FALSE の場合、プレーンテキスト モードになります。 これは、編集コマンドの適用方法に影響します。 たとえば、プレーンエディット コントロールのテキストの一部に太字を適用すると、テキスト全体が太字になります。 ただし、リッチ エディット コントロールの場合、選択したテキストのみが太字になります。 |
|
TRUE の場合、コントロールが非アクティブな場合は、選択範囲の境界を保存する必要があります。
FALSE の場合、コントロールが再びアクティブになると、選択範囲の境界をリセットして開始 = 0、長さ = 0 にすることができます。 |
|
TRUE の場合、スクロール バーは変更されています。 |
|
TRUE の場合、選択バーの幅が変更されました |
|
設定すると、アクセラレータ文字に下線が付く必要があります。
これは、TxGetAcceleratorPos を呼び出すために設定する必要があります。 |
|
パスワード文字列を表示します。 |
|
サポートされていません。 |
|
TRUE の場合は、TxGetPasswordChar によって取得されたパスワード文字を使用してテキストを表示します。
このプロパティの通知は、パスワード文字が変更されたか、パスワード文字が以前に使用されなかったが、現在使用されていることを意味します (またはその逆も同様です)。 |
|
サポートされていません。 |
|
TRUE の場合、インセットが変更されます。 |
|
TRUE とTXTBIT_MULTILINEも TRUE の場合、複数行コントロールは、ビューの四角形に線を折り返す必要があります。 このプロパティが FALSE で 、TXTBIT_MULTILINE が TRUE の場合は、行をラップするのではなく、クリップする必要があります。 ビューの四角形の右側は無視する必要があります。
TXTBIT_MULTILINEが FALSE の場合、このプロパティは無効です。 |
戻り値
型: HRESULT
メソッドが成功した場合、戻り値は S_OK。
メソッドが失敗した場合、戻り値は次の HRESULT コードです。 COM エラー コードの詳細については、「COM でのエラー処理」を参照してください。
| リターン コード | 説明 |
|---|---|
|
実装されていません。 |
注釈
クライアントの四角形は、テキスト サービス オブジェクトが描画と管理を担当する四角形です。 ホストは、その領域を描画するためにテキスト サービス オブジェクトに依存します。 テキスト サービス オブジェクトは、その四角形の外側の領域を塗りつぶしたり、無効にしたりしてはなりません。 さらに、カーソルがこの四角形の上にある場合、ホストはテキスト サービス オブジェクトにマウス メッセージを転送します。 この四角形は、含まれているウィンドウのクライアント座標で表されます。
ビューのインセットは、クライアントの四角形とビューの四角形の間の両側の領域の量です。 ビューの四角形 (書式設定の四角形とも呼ばれます) は、テキストを書式設定する四角形です。 詳細については、「 TxGetViewInset」を参照してください。
backstyle は、クライアント四角形の背景のスタイルです。 TXTBACK_TRANSPARENTまたはTXTBACK_SOLIDを指定できます。 TXTBACKSTYLE に関するページを参照してください。
スクロール バー プロパティは、スクロール バーに対する変更を示します。スクロール バーが存在するかどうか、スクロールが不可能な場合にスクロール バーを非表示にするか無効にするか、挿入ポイントがクライアントの四角形から外れたときに自動スクロールが有効になっている場合も示します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | textserv.h |
| [DLL] | Msftedit.dll |
関連項目
概念
その他のリソース
リファレンス
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示