Metodo IDCompositionSurface::Scroll (dcomp.h)

Scorre un'area rettangolare di una superficie logica Microsoft DirectComposition.

Sintassi

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

Parametri

[in] scrollRect

Area rettangolare della superficie da scorrere, rispetto all'angolo superiore sinistro della superficie. Se questo parametro è NULL, l'intera superficie viene scorrevole.

[in, optional] clipRect

ClipRect cliprect la destinazione (scrollRect dopo offset) dello scorrimento. L'unico contenuto bitmap che verrà scorrevole è quelli che rimangono all'interno del rettangolo di clip dopo il completamento dello scorrimento.

[in] offsetX

Quantità di scorrimento orizzontale, in pixel. Usare i valori positivi per scorrere a destra e i valori negativi per scorrere a sinistra.

[in] offsetY

Quantità di scorrimento verticale, in pixel. Usare valori positivi per scorrere verso il basso e i valori negativi per scorrere verso l'alto.

Valore restituito

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore DirectComposition .

Commenti

Questo metodo consente a un'applicazione di copiare o copiare un sotto rettangolo di un oggetto surface DirectComposition. Ciò consente di evitare il re-rendering del contenuto già disponibile.

Il rettangolo scrollRect deve essere contenuto nei limiti della superficie. Se il rettangolo scrollRect supera i limiti della superficie, questo metodo ha esito negativo.

I bit copiati dall'operazione di scorrimento (origine) sono definiti dall'intersezione dei rettangoli scrollRect e clipRect .

I bit visualizzati sullo schermo (destinazione) sono definiti dall'intersezione del rettangolo di origine offset e clipRect.

Le operazioni di scorrimento possono essere chiamate solo prima di chiamare BeginDraw o dopo aver chiamato EndDraw. Le superfici sospese o riprese non sono candidati per lo scorrimento perché vengono ancora aggiornate.

L'applicazione è responsabile della garanzia che l'area scorrevole per un IDCompositionVirtualSurface sia limitata a pixel validi. Il comportamento per i pixel non validi nello scrollRect non è definito.

Le aree secondarie della superficie virtuale rimosse da un taglio o un'operazione di ridimensionamento non possono essere scorrevoli anche se il taglio o il ridimensionamento viene applicato nello stesso batch. Tagliare e Ridimensionare vengono applicati immediatamente.

Requisiti

Vedi anche

IDCompositionSurface