SB_SETTEXT メッセージ
ステータス ウィンドウの指定した部分のテキストを設定します。
パラメーター
-
wParam
-
下位ワードの LOBYTE は、設定するパーツの 0 から始まるインデックスを指定します。 LOBYTE が SB_SIMPLEID に設定されている場合、ステータス ウィンドウは単純モードのステータス バーであると見なされます。つまり、1 つの部分のみを持つステータス バーです。
下位ワードの HIBYTE は、描画操作の種類を指定します。 このパラメーターには、次の値のいずれかを指定できます。
wParam の上位ワードは無視されます。
値 意味 - 0
テキストは、ウィンドウの平面よりも下に表示される罫線で描画されます。 - SBT_NOBORDERS
テキストは罫線なしで描画されます。 - SBT_OWNERDRAW
テキストは親ウィンドウによって描画されます。 [!注]
簡易モードのステータス バーでは、所有者の描画はサポートされていません。- SBT_POPOUT
テキストは、ウィンドウの平面よりも高く表示されるように罫線で描画されます。 - SBT_RTLREADING
テキストは、親ウィンドウのテキストとは反対の方向に表示されます。 - SBT_NOTABPARSING
タブ文字は無視されます。 -
lParam
-
設定するテキストを指定する null で終わる文字列へのポインター。 wParam がSBT_OWNERDRAWの場合、このパラメーターは 32 ビットのデータを表します。 親ウィンドウは、データを解釈し、 WM_DRAWITEM メッセージを受信したときにテキストを描画する必要があります。
戻り値
成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。
注釈
このメッセージは、変更されたウィンドウの部分を無効にし、ウィンドウが次に WM_PAINT メッセージを受信したときに新しいテキストを表示します。
通常のウィンドウには、テキストが左から右 (LTR) に表示されます。 Windowsミラーリングして、ヘブライ語やアラビア語などの右から左 (RTL) を読み取る言語を表示できます。 SBT_RTLREADINGが設定されている場合、 lParam 文字列は親ウィンドウのテキストとは逆方向に読み取られます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| Header |
|
| Unicode 名と ANSI 名 |
SB_SETTEXTW (Unicode) と SB_SETTEXTA (ANSI) |