IDCompositionSurface：：Scroll 方法 (dcomp.h)

捲動 Microsoft DirectComposition 邏輯介面的矩形區域。

語法

HRESULT Scroll(
  [in]           const RECT *scrollRect,
  [in, optional] const RECT *clipRect,
  [in]           int        offsetX,
  [in]           int        offsetY
);

參數

[in] scrollRect

要捲動之表面的矩形區域，相對於表面左上角。 如果此參數為 Null，則會捲動整個表面。

[in, optional] clipRect

clipRect在捲動的位移) 之後，裁剪目的地 (scrollRect。 唯一要捲動的點陣圖內容是捲動完成後保留在剪輯矩形內的點陣圖內容。

[in] offsetX

水準捲動的數量，以圖元為單位。 使用正值向右捲動，並使用負值向左捲動。

[in] offsetY

垂直捲動的數量，以圖元為單位。 使用正值向下捲動，並使用負值向上捲動。

傳回值

如果函式成功，它會傳回S_OK。 否則，它會傳回 HRESULT 錯誤碼。 如需錯誤碼的清單，請參閱 DirectComposition 錯誤 碼。

備註

此方法可讓應用程式使用 DirectComposition 介面物件的 blt/copy 子矩形。 這可避免重新轉譯已可用的內容。

scrollRect矩形必須包含在表面的界限中。 如果 scrollRect 矩形超出表面界限，這個方法就會失敗。

捲動作業所複製的位 (來源) 是由 scrollRect 和 clipRect 矩形的交集所定義。

畫面上顯示的位 (目的地) 是由位移來源矩形和 clipRect的交集所定義。

捲動作業只能在呼叫 BeginDraw 或呼叫 EndDraw之後呼叫。 暫停或繼續的介面不是捲動的候選項目，因為它們仍在更新中。

應用程式負責確保 IDCompositionVirtualSurface 的可捲動區域僅限於有效的圖元。 scrollRect中無效圖元的行為未定義。

即使修剪或調整大小作業在相同批次中套用修剪或調整大小，也無法捲動虛擬表面子矩形區域。 會 立即套用修剪和 調整大小 。

需求

另請參閱

IDCompositionSurface