Funzione ScrollDC (winuser.h)

Articolo
03/13/2024

La funzione ScrollDC scorre un rettangolo di bit orizzontalmente e verticalmente.

Sintassi

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
);

Parametri

[in] hDC

Tipo: HDC

Gestire il contesto del dispositivo che contiene i bit da scorrere.

[in] dx

Tipo: int

Specifica la quantità, nelle unità di dispositivo, dello scorrimento orizzontale. Questo parametro deve essere un valore negativo per scorrere verso sinistra.

[in] dy

Tipo: int

Specifica la quantità, nelle unità del dispositivo, dello scorrimento verticale. Questo parametro deve essere un valore negativo per scorrere verso l'alto.

[in] lprcScroll

Tipo: const RECT*

Puntatore a una struttura RECT contenente le coordinate dei bit da scorrere. Gli unici bit interessati dall'operazione di scorrimento sono bit nell'intersezione di questo rettangolo e il rettangolo specificato da lprcClip. Se lprcScroll è NULL, viene usata l'intera area client.

[in] lprcClip

Tipo: const RECT*

Puntatore a una struttura RECT contenente le coordinate del rettangolo di ritaglio. Gli unici bit che verranno dipinti sono i bit che rimangono all'interno di questo rettangolo dopo il completamento dell'operazione di scorrimento. Se lprcClip è NULL, viene usata l'intera area client.

[in] hrgnUpdate

Tipo: HRGN

Gestire l'area individuata dal processo di scorrimento. ScrollDC definisce questa area; non è necessariamente un rettangolo.

[out] lprcUpdate

Tipo: LPRECT

Puntatore a una struttura RECT che riceve le coordinate del rettangolo che delimita l'area di aggiornamento di scorrimento. Questa è l'area rettangolare più grande che richiede il ripainting. Quando la funzione restituisce, i valori della struttura si trovano in coordinate client, indipendentemente dalla modalità di mapping per il contesto del dispositivo specificato. Ciò consente alle applicazioni di usare l'area di aggiornamento in una chiamata alla funzione InvalidateRgn , se necessario.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Se il parametro lprcUpdate è NULL, il sistema non calcola il rettangolo di aggiornamento. Se i parametri hrgnUpdate e lprcUpdate sono NULL, il sistema non calcola l'area di aggiornamento. Se hrgnUpdate non è NULL, il sistema procede come se contiene un handle valido per l'area individuata dal processo di scorrimento (definito da ScrollDC).

Quando è necessario scorrere l'intera area client di una finestra, usare la funzione ScrollWindowEx .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-misc-l1-5-0 (introdotta in Windows 10, versione 10.0.10240)

Vedi anche

InvalidateRgn

Altre risorse

RECT

Riferimento

ScrollWindowEx

Condividi tramite