SBM_SETPOS メッセージ

  • [アーティクル]

SBM_SETPOS メッセージが送信され、スクロール ボックスの位置 (thumb) が設定され、要求された場合は、スクロール ボックスの新しい位置を反映するようにスクロール バーを再描画します。

アプリケーションは、このメッセージを直接送信しないでください。 代わりに、 SetScrollPos 関数を使用する必要があります。 ウィンドウは、WindowProc 関数を介してこのメッセージを受け取ります。 カスタム スクロール バー コントロールを実装するアプリケーションは、 SetScrollPos 関数が正常に動作するために、これらのメッセージに応答する必要があります。

パラメーター

wParam

スクロール ボックスの新しい位置を指定します。 スクロール範囲内である必要があります。 このパラメーターがスクロール範囲外の場合、値は切り上げられたり、最も近い有効な値に切り捨てられます。

lParam

新しいスクロール ボックスの位置を反映するようにスクロール バーを再描画するかどうかを指定します。 このパラメーターが TRUE の場合、スクロール バーが再描画されます。 FALSE の場合、スクロール バーは再描画されません。

戻り値

バージョン 5.0ComCtl32.dll: スクロール ボックスの位置が変更された場合、戻り値はスクロール ボックスの前の位置になります。それ以外の場合は 0 です。

バージョン 6.0ComCtl32.dll: スクロール ボックスが変更されたかどうかに関係なく、スクロール ボックスの現在位置。

注釈

スクロール バー コントロールが他の関数の後続の呼び出しによって再描画される場合は、 lParam パラメーターを FALSE に設定すると便利です。

必要条件

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

関連項目

参照

SBM_GETPOS

SBM_GETRANGE

SBM_SETRANGE

SBM_SETRANGEREDRAW