Fonction CascadeWindows (winuser.h)

Article
08/27/2023

Cascade les fenêtres enfants spécifiées de la fenêtre parente spécifiée.

Syntaxe

WORD CascadeWindows(
  [in, optional] HWND       hwndParent,
  [in]           UINT       wHow,
  [in, optional] const RECT *lpRect,
  [in]           UINT       cKids,
  [in, optional] const HWND *lpKids
);

Paramètres

[in, optional] hwndParent

Type : HWND

Handle de la fenêtre parente. Si ce paramètre a la valeur NULL, la fenêtre de bureau est supposée.

[in] wHow

Type : UINT

Indicateur de cascade. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.

Valeur	Signification
MDITILE_SKIPDISABLED 0x0002	Empêche la mise en cascade des fenêtres enfants MDI désactivées.
MDITILE_ZORDER 0x0004	Organise les fenêtres dans l’ordre Z. Si cette valeur n’est pas spécifiée, les fenêtres sont organisées à l’aide de l’ordre spécifié dans le tableau lpKids .

[in, optional] lpRect

Type : const RECT*

Pointeur vers une structure qui spécifie la zone rectangulaire, dans les coordonnées du client, dans laquelle les fenêtres sont organisées. Ce paramètre peut être NULL, auquel cas la zone cliente de la fenêtre parente est utilisée.

[in] cKids

Type : UINT

Nombre d’éléments dans le tableau spécifié par le paramètre lpKids . Ce paramètre est ignoré si lpKids a la valeur NULL.

[in, optional] lpKids

Type : const HWND*

Tableau de handles vers les fenêtres enfants à organiser. Si une fenêtre enfant spécifiée est une fenêtre de niveau supérieur avec le style WS_EX_TOPMOST ou WS_EX_TOOLWINDOW, la fenêtre enfant n’est pas organisée. Si ce paramètre a la valeur NULL, toutes les fenêtres enfants de la fenêtre parente spécifiée (ou de la fenêtre de bureau) sont organisées.

Valeur retournée

Type : WORD

Si la fonction réussit, la valeur de retour correspond au nombre de fenêtres organisées.

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

Par défaut, CascadeWindows organise les fenêtres dans l’ordre fourni par le tableau lpKids , mais conserve l’ordre Z. Si vous spécifiez l’indicateur MDITILE_ZORDER , CascadeWindows organise les fenêtres dans l’ordre Z.

L’appel de CascadeWindows entraîne la restauration de toutes les fenêtres agrandies à leur taille précédente.

Configuration requise


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

Voir aussi

Vue d’ensemble de Windows

Partager via