Método IDCompositionSurface::Scroll (dcomp.h)
Rola uma área retangular de uma superfície lógica do Microsoft DirectComposition.
Sintaxe
HRESULT Scroll(
[in] const RECT *scrollRect,
[in, optional] const RECT *clipRect,
[in] int offsetX,
[in] int offsetY
);
Parâmetros
[in] scrollRect
A área retangular da superfície a ser rolada, em relação ao canto superior esquerdo da superfície. Se esse parâmetro for NULL, toda a superfície será rolada.
[in, optional] clipRect
O clipRect corta o destino (scrollRect após deslocamento) da rolagem. O único conteúdo de bitmap que será rolado são aqueles que permanecem dentro do retângulo de clipe após a conclusão da rolagem.
[in] offsetX
A quantidade de rolagem horizontal, em pixels. Use valores positivos para rolar para a direita e valores negativos para rolar para a esquerda.
[in] offsetY
A quantidade de rolagem vertical, em pixels. Use valores positivos para rolar para baixo e valores negativos para rolar para cima.
Valor retornado
Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. Consulte Códigos de Erro do DirectComposition para obter uma lista de códigos de erro.
Comentários
Esse método permite que um aplicativo copie/blt um subtângulo de um objeto de superfície DirectComposition. Isso evita a renderização do conteúdo que já está disponível.
O retângulo scrollRect deve estar contido nos limites da superfície. Se o retângulo scrollRect ficar fora dos limites da superfície, esse método falhará.
Os bits copiados pela operação de rolagem (origem) são definidos pela interseção dos retângulos scrollRect e clipRect .
Os bits mostrados na tela (destino) são definidos pela interseção do retângulo de origem de deslocamento e clipRect.
As operações de rolagem só podem ser chamadas antes de chamar BeginDraw ou depois de chamar EndDraw. Superfícies suspensas ou retomadas não são candidatas à rolagem porque ainda estão sendo atualizadas.
O aplicativo é responsável por garantir que a área rolável para um IDCompositionVirtualSurface seja limitada a pixels válidos. O comportamento de pixels inválidos no scrollRect é indefinido.
Áreas subctangulares de superfície virtual que foram descartadas por um corte ou uma operação de redimensionamento não podem ser roladas mesmo se o corte ou redimensionamento for aplicado no mesmo lote. Corte e Redimensionamento são aplicados imediatamente.
Requisitos
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | dcomp.h |
| Biblioteca | Dcomp.lib |
| DLL | Dcomp.dll |