SetWindowPos, fonction (winuser.h)

Modifie la taille, la position et l’ordre Z d’une fenêtre enfant, contextuelle ou de niveau supérieur. Ces fenêtres sont triées en fonction de leur apparence à l’écran. La fenêtre la plus haute reçoit le rang le plus élevé et est la première fenêtre dans l’ordre Z.

Syntaxe

BOOL SetWindowPos(
  [in]           HWND hWnd,
  [in, optional] HWND hWndInsertAfter,
  [in]           int  X,
  [in]           int  Y,
  [in]           int  cx,
  [in]           int  cy,
  [in]           UINT uFlags
);

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre.

[in, optional] hWndInsertAfter

Type : HWND

Handle à la fenêtre pour faire précéder la fenêtre positionnée dans l’ordre Z. Ce paramètre doit être un handle de fenêtre ou l’une des valeurs suivantes.

Valeur Signification
HWND_BOTTOM
(HWND)1
Places la fenêtre située en bas de l’ordre Z. Si le paramètre hWnd identifie une fenêtre la plus haute, la fenêtre perd sa status supérieure et est placée au bas de toutes les autres fenêtres.
HWND_NOTOPMOST
(HWND)-2
Places la fenêtre au-dessus de toutes les fenêtres non supérieures (c’est-à-dire derrière toutes les fenêtres les plus haut). Cet indicateur n’a aucun effet si la fenêtre est déjà une fenêtre non supérieure.
HWND_TOP
(HWND)0
Places la fenêtre située en haut de l’ordre Z.
HWND_TOPMOST
(HWND)-1
Places la fenêtre au-dessus de toutes les fenêtres non supérieures. La fenêtre conserve sa position la plus haute, même lorsqu’elle est désactivée.
 

Pour plus d’informations sur l’utilisation de ce paramètre, consultez la section Remarques suivante.

[in] X

Type : int

Nouvelle position du côté gauche de la fenêtre, dans les coordonnées du client.

[in] Y

Type : int

Nouvelle position du haut de la fenêtre, dans les coordonnées du client.

[in] cx

Type : int

Nouvelle largeur de la fenêtre, en pixels.

[in] cy

Type : int

Nouvelle hauteur de la fenêtre, en pixels.

[in] uFlags

Type : UINT

Indicateurs de dimensionnement et de positionnement de la fenêtre. Ce paramètre peut être une combinaison des valeurs suivantes.

Valeur Signification
SWP_ASYNCWINDOWPOS
0x4000
Si le thread appelant et le thread propriétaire de la fenêtre sont attachés à différentes files d’attente d’entrée, le système publie la demande sur le thread propriétaire de la fenêtre. Cela empêche le thread appelant de bloquer son exécution pendant que d’autres threads traitent la requête.
SWP_DEFERERASE
0x2000
Empêche la génération du message WM_SYNCPAINT .
SWP_DRAWFRAME
0x0020
Dessine un cadre (défini dans la description de classe de la fenêtre) autour de la fenêtre.
SWP_FRAMECHANGED
0x0020
Applique les nouveaux styles d’image définis à l’aide de la fonction SetWindowLong . Envoie un message WM_NCCALCSIZE à la fenêtre, même si la taille de la fenêtre n’est pas modifiée. Si cet indicateur n’est pas spécifié, WM_NCCALCSIZE est envoyé uniquement lorsque la taille de la fenêtre est modifiée.
SWP_HIDEWINDOW
0x0080
Masque la fenêtre.
SWP_NOACTIVATE
0x0010
N’active pas la fenêtre. Si cet indicateur n’est pas défini, la fenêtre est activée et déplacée en haut du groupe le plus élevé ou non supérieur (selon le paramètre hWndInsertAfter ).
SWP_NOCOPYBITS
0x0100
Ignore tout le contenu de la zone cliente. Si cet indicateur n’est pas spécifié, le contenu valide de la zone client est enregistré et copié dans la zone cliente une fois la fenêtre dimensionnée ou repositionnée.
SWP_NOMOVE
0x0002
Conserve la position actuelle (ignore les paramètres X et Y ).
SWP_NOOWNERZORDER
0x0200
Ne modifie pas la position de la fenêtre propriétaire dans l’ordre Z.
SWP_NOREDRAW
0x0008
Ne redessine pas les modifications. Si cet indicateur est défini, aucun repeint de quelque type que ce soit ne se produit. Cela s’applique à la zone cliente, à la zone non cliente (y compris la barre de titre et les barres de défilement) et à toute partie de la fenêtre parente découverte suite au déplacement de la fenêtre. Lorsque cet indicateur est défini, l’application doit invalider ou redessiner explicitement toutes les parties de la fenêtre et de la fenêtre parente qui doivent être redessinées.
SWP_NOREPOSITION
0x0200
Identique à l’indicateur SWP_NOOWNERZORDER .
SWP_NOSENDCHANGING
0x0400
Empêche la fenêtre de recevoir le message WM_WINDOWPOSCHANGING .
SWP_NOSIZE
0x0001
Conserve la taille actuelle (ignore les paramètres cx et cy ).
SWP_NOZORDER
0x0004
Conserve l’ordre Z actuel (ignore le paramètre hWndInsertAfter ).
SWP_SHOWWINDOW
0x0040
Affiche la fenêtre.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Dans le cadre de la re-architecture Vista, tous les services ont été déplacés du bureau interactif dans la session 0. Les opérations hwnd et window manager ne sont efficaces qu’à l’intérieur d’une session et les tentatives entre sessions de manipulation du hwnd échouent. Pour plus d’informations, consultez The Windows Vista Developer Story : Application Compatibility Cookbook.

Si vous avez modifié certaines données de fenêtre à l’aide de SetWindowLong, vous devez appeler SetWindowPos pour que les modifications prennent effet. Utilisez la combinaison suivante pour uFlags : SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER | SWP_FRAMECHANGED.

Vous pouvez faire d’une fenêtre la plus haute en définissant le paramètre hWndInsertAfter sur HWND_TOPMOST et en veillant à ce que l’indicateur SWP_NOZORDER n’est pas défini, soit en définissant la position d’une fenêtre dans l’ordre Z afin qu’elle soit au-dessus des fenêtres les plus supérieures existantes. Lorsqu’une fenêtre non supérieure est la plus haute, les fenêtres qui lui appartiennent sont également les plus haut. Ses propriétaires, cependant, ne sont pas modifiés.

Si ni l’indicateur SWP_NOACTIVATE ni SWP_NOZORDER n’est spécifié (autrement dit, lorsque l’application demande qu’une fenêtre soit activée simultanément et que sa position dans l’ordre de Z change), la valeur spécifiée dans hWndInsertAfter est utilisée uniquement dans les circonstances suivantes.

  • Ni l’indicateur HWND_TOPMOST ni HWND_NOTOPMOST n’est spécifié dans hWndInsertAfter.
  • La fenêtre identifiée par hWnd n’est pas la fenêtre active.
Une application ne peut pas activer une fenêtre inactive sans l’amener en haut de l’ordre Z. Les applications peuvent modifier la position d’une fenêtre activée dans l’ordre Z sans restrictions, ou elles peuvent activer une fenêtre, puis la déplacer vers le haut des fenêtres les plus en haut ou non supérieures.

Si une fenêtre la plus haute est repositionnée en bas (HWND_BOTTOM) de l’ordre Z ou après une fenêtre non supérieure, elle n’est plus la plus haute. Lorsqu’une fenêtre la plus haute est rendue non la plus haute, ses propriétaires et ses fenêtres propriétaires sont également faits de fenêtres non supérieures.

Une fenêtre non supérieure peut posséder une fenêtre la plus haute, mais l’inverse ne peut pas se produire. Toute fenêtre (par exemple, une boîte de dialogue) appartenant à une fenêtre la plus haute est elle-même une fenêtre la plus haute, pour garantir que toutes les fenêtres détenues restent au-dessus de leur propriétaire.

Si une application ne se trouve pas au premier plan et doit être au premier plan, elle doit appeler la fonction SetForegroundWindow .

Pour utiliser SetWindowPos pour placer une fenêtre en haut, le processus propriétaire de la fenêtre doit disposer de l’autorisation SetForegroundWindow .

Exemples

Pour obtenir un exemple, consultez Initialisation d’une boîte de dialogue.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Ensemble d’API ext-ms-win-ntuser-window-l1-1-0 (introduit dans Windows 8)

Voir aussi

Conceptuel

MoveWindow

Référence

SetActiveWindow

SetForegroundWindow

Windows