Share via

ScrollDC 函式 (winuser.h)

  • 發行項

ScrollDC 函式會水準和垂直捲動位的矩形。

語法

BOOL ScrollDC(
  [in]  HDC        hDC,
  [in]  int        dx,
  [in]  int        dy,
  [in]  const RECT *lprcScroll,
  [in]  const RECT *lprcClip,
  [in]  HRGN       hrgnUpdate,
  [out] LPRECT     lprcUpdate
);

參數

[in] hDC

類型： HDC

包含要捲動之位的裝置內容句柄。

[in] dx

類型： int

指定水平捲動的裝置單位數量。 此參數必須是負值，才能向左卷動。

[in] dy

類型： int

指定垂直捲動的裝置單位數量。 此參數必須是負值，才能向上捲動。

[in] lprcScroll

類型： const RECT*

RECT 結構的指標，其中包含要捲動之位的座標。 卷動作業所影響的唯一位是這個矩形與 lprcClip 所指定的矩形交集內的位。 如果 lprcScroll 為 NULL，則會使用整個工作區。

[in] lprcClip

類型： const RECT*

RECT 結構的指標，其中包含裁剪矩形的座標。 唯一要繪製的位是在卷動作業完成之後，保留在這個矩形內的位。 如果 lprcClip 為 NULL，則會使用整個工作區。

[in] hrgnUpdate

類型： HRGN

捲動程式所發現區域的句柄。 ScrollDC 會定義此區域;它不一定是矩形。

[out] lprcUpdate

類型： LPRECT

RECT 結構的指標，接收周框周框捲動更新區域的座標。 這是需要重繪的最大矩形區域。 當函式傳回時，結構中的值會位於用戶端座標中，而不論指定裝置內容的對應模式為何。 這可讓應用程式視需要使用 InvalidateRgn 函式呼叫中的更新區域。

傳回值

類型： BOOL

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

如果 lprcUpdate 參數為 NULL，則系統不會計算更新矩形。 如果 hrgnUpdate 和 lprcUpdate 參數都是 NULL，則系統不會計算更新區域。 如果 hrgnUpdate 不是 NULL，系統會繼續執行，因為它包含 ScrollDC 所定義之捲動程式所發現之區域的有效句柄 () 。

當您必須捲動視窗的整個工作區時，請使用 ScrollWindowEx 函 式。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 winuser.h (包含 Windows.h)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-misc-l1-5-0 (Windows 10 10.0.10240 版)

另請參閱

InvalidateRgn

其他資源

矩形

參考

ScrollWindowEx