Funzione GetBrushOrgEx (wingdi.h)

Articolo
03/09/2024

La funzione GetBrushOrgEx recupera l'origine del pennello corrente per il contesto di dispositivo specificato. Questa funzione sostituisce la funzione GetBrushOrg .

Sintassi

BOOL GetBrushOrgEx(
  [in]  HDC     hdc,
  [out] LPPOINT lppt
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[out] lppt

Puntatore a una struttura POINT che riceve l'origine del pennello, nelle coordinate del dispositivo.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Un pennello è una bitmap usata dal sistema per disegnare gli interni di forme piene.

L'origine del pennello è un set di coordinate con valori compresi tra 0 e 7, specificando la posizione di un pixel nella bitmap. Le coordinate di origine del pennello predefinite sono (0,0). Per le coordinate orizzontali, il valore 0 corrisponde alla colonna più a sinistra di pixel; il valore 7 corrisponde alla colonna più a destra. Per le coordinate verticali, il valore 0 corrisponde alla riga più alta di pixel; il valore 7 corrisponde alla riga più bassa. Quando il sistema posiziona il pennello all'inizio di qualsiasi operazione di disegno, esegue il mapping dell'origine del pennello alla posizione nell'area client della finestra specificata dall'origine del pennello. Ad esempio, se l'origine è impostata su (2,3), il sistema esegue il mapping dell'origine del pennello (0,0) alla posizione (2,3) nell'area client della finestra.

Se un'applicazione usa un pennello per riempire gli sfondi di una finestra padre e figlio con colori corrispondenti, potrebbe essere necessario impostare l'origine pennello dopo aver dipinto la finestra padre, ma prima di disegnare la finestra figlio.

Il sistema tiene automaticamente traccia dell'origine di tutti i contesti di dispositivo gestiti da finestre e ne regola i pennelli in base alle esigenze per mantenere un allineamento dei modelli sulla superficie.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll