EM_SETTABSTOPS メッセージ

EM_SETTABSTOPS メッセージは、複数行の編集コントロールでタブ位置を設定します。 テキストがコントロールにコピーされると、テキスト内の任意のタブ文字によって、次のタブ位置までスペースが生成されます。

このメッセージは、複数行の編集コントロールによってのみ処理されます。 このメッセージは、編集コントロールまたはリッチ エディット コントロールに送信できます。

パラメーター

wParam

配列に含まれるタブ位置の数。 このパラメーターが 0 の場合、 lParam パラメーターは無視され、既定のタブ位置は 32 個のダイアログ テンプレート単位ごとに設定されます。 このパラメーターが 1 の場合、タブ位置は n 個のダイアログ テンプレート単位ごとに設定されます。 ここで、n は lParam パラメーターが指す距離です。 このパラメーターが 1 より大きい場合、 lParam はタブ位置の配列へのポインターです。

lParam

ダイアログ テンプレート単位でタブ位置を指定する符号なし整数の配列へのポインター。 wParam パラメーターが 1 の場合、このパラメーターは、ダイアログ テンプレート単位ですべてのタブ位置間の距離を含む符号なし整数へのポインターです。

戻り値

すべてのタブが設定されている場合、戻り値は TRUE になります。

すべてのタブが設定されていない場合、戻り値は FALSE になります。

解説

EM_SETTABSTOPS メッセージは、編集コントロール ウィンドウを自動的に再描画しません。 アプリケーションが編集コントロールに既に含まれているテキストのタブ位置を変更する場合は、 InvalidateRect 関数を呼び出して編集コントロール ウィンドウを再描画する必要があります。

配列で指定された値はダイアログ テンプレート単位で、ダイアログ ボックス テンプレートで使用されるデバイスに依存しない単位です。 測定値をダイアログ テンプレート単位から画面単位 (ピクセル) に変換するには、 MapDialogRect 関数を使用します。

リッチエディット: Microsoft Rich Edit 3.0 以降でサポートされています。 リッチ エディット コントロールには、MAX_TAB_STOPSで指定されたタブ位置の最大数を指定できます。 リッチ エディット バージョンとさまざまなシステム バージョンの互換性については、「 Rich Edit Controls について」を参照してください。

必要条件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー	Winuser.h (Windows.h を含む)

関連項目

その他のリソース

InvalidateRect

MapDialogRect