Fonction BeginDeferWindowPos (winuser.h)

Alloue de la mémoire pour une structure à plusieurs positions de fenêtre et retourne le handle à la structure.

Syntaxe

HDWP BeginDeferWindowPos(
  [in] int nNumWindows
);

Paramètres

[in] nNumWindows

Type : int

Nombre initial de fenêtres pour lesquelles stocker des informations de position. La fonction DeferWindowPos augmente la taille de la structure, si nécessaire.

Valeur retournée

Type : HDWP

Si la fonction réussit, la valeur de retour identifie la structure à plusieurs positions de fenêtres. Si des ressources système insuffisantes sont disponibles pour allouer la structure, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La structure à plusieurs positions de fenêtre est une structure interne ; une application ne peut pas y accéder directement.

DeferWindowPos remplit la structure à plusieurs positions de fenêtres avec des informations sur la position cible d’une ou plusieurs fenêtres sur le point d’être déplacées. La fonction EndDeferWindowPos accepte le handle de cette structure et repositionne les fenêtres à l’aide des informations stockées dans la structure.

Si le système doit augmenter la taille de la structure à plusieurs fenêtres au-delà de la taille initiale spécifiée par le paramètre nNumWindows , mais ne peut pas allouer suffisamment de mémoire pour ce faire, le système échoue à l’ensemble de la séquence de positionnement de fenêtre (BeginDeferWindowPos, DeferWindowPos et EndDeferWindowPos). En spécifiant la taille maximale nécessaire, une application peut détecter et traiter les défaillances au début du processus.

Configuration requise

Voir aussi

Conceptuel

DeferWindowPos

EndDeferWindowPos

Référence

SetWindowPos

Windows