SBM_GETSCROLLINFO メッセージ

スクロール バーのパラメーターを取得するために、SBM_GETSCROLLINFO メッセージが送信されます。

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

パラメーター

wParam

このパラメーターは使用されません。

lParam

SCROLLINFO 構造体へのポインター。 GetScrollInfo を呼び出す前に、構造体の cbSize メンバーを sizeof(SCROLLINFO) に設定し、取得するスクロール バー パラメーターを指定するように fMask メンバーを設定します。 メッセージが返される前に、指定したパラメーターが構造体の適切なメンバーにコピーされます。

fMask メンバーには、次の値のうち 1 つ以上を指定できます。

値	意味
SIF_ALL	SIF_PAGE、SIF_POS、SIF_RANGE、SIF_TRACKPOSの組み合わせ。
SIF_PAGE	スクロール ページを nPage メンバーにコピーします。
SIF_POS	スクロール位置を nPos メンバーにコピーします。
SIF_RANGE	スクロール範囲を nMin メンバーと nMax メンバーにコピーします。
SIF_TRACKPOS	現在のスクロール ボックス追跡位置を nTrackPos メンバーにコピーします。

戻り値

メッセージが値を取得した場合、戻り値は TRUE です。それ以外の場合は FALSE です。

注釈

スクロール バーの位置、 WM_HSCROLL 、 WM_VSCROLLを示すメッセージでは、16 ビットの位置データのみが提供されます。 ただし、SBM_GETSCROLLINFO、SBM_SETSCROLLINFO、GetScrollInfo、および SetScrollInfo によって使用される SCROLLINFO 構造体は、32 ビットのスクロール バー位置データを提供します。 これらのメッセージと関数は、 WM_HSCROLL または WM_VSCROLL メッセージの処理中に使用して、32 ビットのスクロール バー位置データを取得できます。

WM_HSCROLLまたはWM_VSCROLL メッセージのSB_THUMBTRACK要求コード中にスクロール ボックス (thumb) の 32 ビット位置を取得するには、SCROLLINFO 構造体の fMask メンバーのSIF_TRACKPOS値を使用してSBM_GETSCROLLINFOを送信します。 このメッセージは、SCROLLINFO 構造体の nTrackPos メンバー内のスクロール ボックスの追跡位置を返します。 これにより、ユーザーがスクロール ボックスを移動するときに、スクロール ボックスの位置を取得できます。 または、 GetScrollInfo 関数を使用して同じ情報を取得することもできます。

必要条件

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

関連項目

参照

GetScrollInfo

SBM_SETSCROLLINFO

SCROLLINFO

SetScrollInfo