SB_GETTEXTLENGTH メッセージ

  • [アーティクル]

状態ウィンドウの指定した部分からテキストの長さを文字数で取得します。

パラメーター

wParam

テキストの取得元となるパーツの 0 から始まるインデックス。

lParam

ゼロを指定してください。

戻り値

2 つの 16 ビット値で構成される 32 ビット値を返します。 低い単語は、テキストの長さを文字数で指定します。 高い単語は、テキストの描画に使用される操作の種類を指定します。 型には、次のいずれかの値を指定できます。

リターン コード 説明
0
 テキストは、ウィンドウの平面よりも低く表示される罫線で描画されます。
SBT_NOBORDERS
 テキストは罫線なしで描画されます。
SBT_OWNERDRAW
 テキストは親ウィンドウによって描画されます。
SBT_POPOUT
 テキストは、ウィンドウの平面よりも高く表示される罫線で描画されます。
SBT_RTLREADING
 テキストは、親ウィンドウのテキストとは反対の方向に表示されます。

解説

通常のウィンドウには、テキストが左から右 (LTR) で表示されます。 Windows は、右から左に読み取るヘブライ語やアラビア語 (RTL) などの言語を表示するために ミラー化 できます。 SBT_RTLREADINGが設定されている場合、指定されたステータス ウィンドウのテキストは、親ウィンドウのテキストとは反対の方向に読み取られます。

このメッセージは、最大 65,535 文字の文字列長を返します。 実際のテキスト文字列がそれより長い場合は、 SB_GETTEXT メッセージによって切り捨てられます。

必要条件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー
Commctrl.h
Unicode 名と ANSI 名
 SB_GETTEXTLENGTHW (Unicode) と SB_GETTEXTLENGTHA (ANSI)