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 [デスクトップ アプリのみ] |
| ヘッダー |
|