SCROLLINFO 構造体 (winuser.h)

  • [アーティクル]

SCROLLINFO 構造体には、SetScrollInfo 関数 (またはSBM_SETSCROLLINFO メッセージ) によって設定されるスクロール バー パラメーター、または GetScrollInfo 関数 (またはメッセージSBM_GETSCROLLINFOによって取得されるスクロール バー パラメーターが含まれます。

構文

typedef struct tagSCROLLINFO {
  UINT cbSize;
  UINT fMask;
  int  nMin;
  int  nMax;
  UINT nPage;
  int  nPos;
  int  nTrackPos;
} SCROLLINFO, *LPSCROLLINFO;

メンバー

cbSize

型: UINT

この構造体のサイズをバイト単位で指定します。 呼び出し元はこれを sizeof(SCROLLINFO) に設定する必要があります。

fMask

型: UINT

設定または取得するスクロール バー パラメーターを指定します。 このメンバーには、次の値の組み合わせを指定できます。

値 説明
SIF_ALL
 SIF_PAGE、SIF_POS、SIF_RANGE、SIF_TRACKPOSの組み合わせ。
SIF_DISABLENOSCROLL
 この値は、スクロール バーのパラメーターを設定する場合にのみ使用されます。 スクロール バーの新しいパラメーターによってスクロール バーが不要になる場合は、スクロール バーを削除する代わりに無効にします。
SIF_PAGE
 nPage メンバーには、比例スクロール バーのページ サイズが含まれます。
SIF_POS
 nPos メンバーには、ユーザーがスクロール ボックスをドラッグしている間は更新されないスクロール ボックスの位置が含まれています。
SIF_RANGE
 nMin メンバーと nMax メンバーには、スクロール範囲の最小値と最大値が含まれます。
SIF_TRACKPOS
 nTrackPos メンバーには、ユーザーがドラッグしている間のスクロール ボックスの現在の位置が含まれます。

nMin

型: int

スクロールの最小位置を指定します。

nMax

型: int

最大スクロール位置を指定します。

nPage

型: UINT

ページ サイズをデバイス単位で指定します。 スクロール バーは、この値を使用して、比例スクロール ボックスの適切なサイズを決定します。

nPos

型: int

スクロール ボックスの位置を指定します。

nTrackPos

型: int

ユーザーがドラッグするスクロール ボックスの即時位置を指定します。 アプリケーションは、SB_THUMBTRACK要求コードの処理中にこの値を取得できます。 アプリケーションは、即時スクロール位置を設定できません。 SetScrollInfo 関数は、このメンバーを無視します。

要件

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

関連項目

GetScrollInfo

リファレンス

SBM_GETSCROLLINFO

SBM_SETSCROLLINFO

SetScrollInfo