Funzione GetBrushOrgEx (wingdi.h)
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 |