Funzione SetWindowRgn (winuser.h)

Articolo
03/15/2023

La funzione SetWindowRgn imposta l'area della finestra di una finestra. L'area della finestra determina l'area all'interno della finestra in cui il sistema consente il disegno. Il sistema non visualizza alcuna parte di una finestra che si trova all'esterno dell'area della finestra

Sintassi

int SetWindowRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn,
  [in] BOOL bRedraw
);

Parametri

[in] hWnd

Handle nella finestra la cui area della finestra deve essere impostata.

[in] hRgn

Handle in un'area. La funzione imposta l'area della finestra su questa area.

Se hRgn è NULL, la funzione imposta l'area della finestra su NULL.

[in] bRedraw

Specifica se il sistema ridisegna la finestra dopo aver impostato l'area della finestra. Se bRedraw è TRUE, il sistema lo fa; in caso contrario, non lo fa.

In genere, si imposta bRedraw su TRUE se la finestra è visibile.

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

Quando questa funzione viene chiamata, il sistema invia il WM_WINDOWPOSCHANGING e WM_WINDOWPOSCHANGED messaggi alla finestra.

Le coordinate dell'area della finestra di una finestra sono relative all'angolo superiore sinistro della finestra, non all'area client della finestra.

Nota Se il layout della finestra è da destra a sinistra (RTL), le coordinate sono relative all'angolo superiore destro della finestra. Vedere Layout della finestra e mirroring.

Dopo una chiamata riuscita a SetWindowRgn, il sistema possiede l'area specificata dall'handle dell'area hRgn. Il sistema non esegue una copia dell'area. Pertanto, non è consigliabile effettuare ulteriori chiamate di funzione con questo handle di area. In particolare, non eliminare questo handle di area. Il sistema elimina l'handle dell'area quando non è più necessario.

Per ottenere l'area della finestra di una finestra, chiamare la funzione GetWindowRgn .

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [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-draw-l1-1-0 (introdotto in Windows 8)