Funzione SetBrushOrgEx (wingdi.h)

Articolo
03/08/2023

La funzione SetBrushOrgEx imposta l'origine del pennello che GDI assegna al pennello successivo che un'applicazione seleziona nel contesto del dispositivo specificato.

Sintassi

BOOL SetBrushOrgEx(
  [in]  HDC     hdc,
  [in]  int     x,
  [in]  int     y,
  [out] LPPOINT lppt
);

Parametri

[in] hdc

Handle nel contesto del dispositivo.

[in] x

Coordinata x, in unità dispositivo, della nuova origine del pennello. Se questo valore è maggiore della larghezza del pennello, il valore viene ridotto usando l'operatore modulo (nXOrgmod brush width).

[in] y

Coordinata y, in unità dispositivo, della nuova origine del pennello. Se questo valore è maggiore dell'altezza del pennello, il relativo valore viene ridotto usando l'operatore di modulo (altezza del pennello modnYOrg).

[out] lppt

Puntatore a una struttura POINT che riceve l'origine del pennello precedente.

Questo parametro può essere NULL se l'origine del pennello precedente non è necessaria.

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 dipingere gli interni delle forme riempite.

L'origine del pennello è una coppia di coordinate che specifica 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ù sinistra dei pixel; la larghezza corrisponde alla colonna più a destra. Per le coordinate verticali, il valore 0 corrisponde alla riga più superiore di pixel; l'altezza corrisponde alla riga più bassa.

Il sistema tiene automaticamente traccia dell'origine di tutti i contesti del dispositivo gestiti dalla finestra e regola i pennelli in base alle esigenze per mantenere un allineamento dei modelli sulla superficie. L'origine del pennello impostata con questa chiamata è relativa all'angolo superiore sinistro dell'area client.

Un'applicazione deve chiamare SetBrushOrgEx dopo aver impostato la modalità di estensione bitmap su HALFTONE usando SetStretchBltMode. Questa operazione deve essere eseguita per evitare il disallineamento del pennello.

Requisiti


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