Partager via


CMiniFrameWnd, classe

Représente une fenêtre frame de demi-hauteur généralement visible autour de barres d'outils flottantes.

Syntaxe

class CMiniFrameWnd : public CFrameWnd

Membres

Constructeurs publics

Nom Description
CMiniFrameWnd ::CMiniFrameWnd Construit un objet CMiniFrameWnd.

Méthodes publiques

Nom Description
CMiniFrameWnd ::Create Crée un CMiniFrameWnd objet après la construction.
CMiniFrameWnd ::CreateEx Crée un CMiniFrameWnd objet (avec des options supplémentaires) après la construction.

Notes

Ces fenêtres mini-frame se comportent comme des fenêtres d’images normales, sauf qu’elles n’ont pas de boutons ou de menus réduits/agrandissant et que vous n’avez qu’à cliquer sur le menu système pour les ignorer.

Pour utiliser un CMiniFrameWnd objet, définissez d’abord l’objet. Appelez ensuite la fonction Créer un membre pour afficher la fenêtre mini-frame.

Pour plus d’informations sur l’utilisation d’objets CMiniFrameWnd , consultez l’article Docking et Les barres d’outils flottantes.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CFrameWnd

CMiniFrameWnd

Spécifications

En-tête : afxwin.h

CMiniFrameWnd ::CMiniFrameWnd

Construit un CMiniFrameWnd objet, mais ne crée pas la fenêtre.

CMiniFrameWnd();

Notes

Pour créer la fenêtre, appelez CMiniFrameWnd ::Create.

CMiniFrameWnd ::Create

Crée la fenêtre mini-frame Windows et l’attache à l’objet CMiniFrameWnd .

virtual BOOL Create(
    LPCTSTR lpClassName,
    LPCTSTR lpWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd = NULL,
    UINT nID = 0);

Paramètres

lpClassName
Pointe vers une chaîne de caractères terminée par null qui nomme la classe Windows. Le nom de classe peut être n’importe quel nom inscrit auprès de la fonction AfxRegisterWndClass globale. Si la valeur est NULL, la classe de fenêtre est inscrite pour vous par l’infrastructure. MFC donne à la classe par défaut les styles et attributs suivants :

  • Définit le bit de style CS_DBLCLKS, qui envoie des messages en double-clic à la procédure de fenêtre lorsque l’utilisateur double-clique sur la souris.

  • Définit les bits de style CS_HREDRAW et CS_VREDRAW, qui dirigent le contenu de la zone cliente à redessiner lorsque la fenêtre change de taille.

  • Définit le curseur de classe sur le IDC_ARROW standard Windows.

  • Définit le pinceau d’arrière-plan de classe sur NULL, de sorte que la fenêtre n’efface pas son arrière-plan.

  • Définit l’icône de classe sur l’icône de logo Windows standard avec indicateur.

  • Définit la fenêtre sur la taille et la position par défaut, comme indiqué par Windows.

lpWindowName
Pointe vers une chaîne de caractères terminée par null qui contient le nom de la fenêtre.

dwStyle
Spécifie les attributs de style de fenêtre. Ceux-ci peuvent inclure des styles de fenêtre standard et un ou plusieurs des styles spéciaux suivants :

  • MFS_MOVEFRAME Permet de déplacer la fenêtre mini-frame en cliquant sur n’importe quel bord de la fenêtre, pas seulement sur la légende.

  • MFS_4THICKFRAME Désactive le redimensionnement de la fenêtre mini-frame.

  • MFS_SYNCACTIVE Synchronise l’activation de la fenêtre mini-frame à l’activation de sa fenêtre parente.

  • MFS_THICKFRAME Permet à la fenêtre mini-frame d’être dimensionnée aussi petite que le contenu de la zone cliente.

  • MFS_BLOCKSYSMENU Désactive l’accès au menu système et au menu de contrôle, puis les convertit en partie de la légende (barre de titre).

Consultez CWnd ::Create pour obtenir une description des valeurs de style de fenêtre possibles. La combinaison classique utilisée pour les fenêtres mini-frame est WS_POPUP|WS_CAPTION|WS_SYSMENU.

rect
Structure RECT spécifiant les dimensions souhaitées de la fenêtre.

pParentWnd
Pointe vers la fenêtre parente. Utilisez NULL pour les fenêtres de niveau supérieur.

nID
Si la fenêtre mini-frame est créée en tant que fenêtre enfant, il s’agit de l’identificateur du contrôle enfant ; sinon 0.

Valeur de retour

Valeur différente de zéro cas de réussite ; sinon, 0.

Notes

Create initialise le nom de classe et le nom de la fenêtre de la fenêtre et inscrit les valeurs par défaut pour son style et son parent.

CMiniFrameWnd ::CreateEx

Crée un objet CMiniFrameWnd.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    LPCTSTR lpClassName,
    LPCTSTR lpWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd = NULL,
    UINT nID = 0);

Paramètres

dwExStyle
Spécifie le style étendu de la CMiniFrameWnd création en cours. Appliquez l’un des styles de fenêtre étendus à la fenêtre.

lpClassName
Pointe vers une chaîne de caractères terminée par null qui nomme la classe Windows (structure WNDCLASS ). Le nom de classe peut être n’importe quel nom inscrit auprès de la fonction AfxRegisterWndClass globale ou de l’un des noms de classe de contrôle prédéfinis. Elle ne doit pas être NULL.

lpWindowName
Pointe vers une chaîne de caractères terminée par null qui contient le nom de la fenêtre.

dwStyle
Spécifie les attributs de style de fenêtre. Consultez Styles de fenêtre et CWnd ::Create pour obtenir une description des valeurs possibles.

rect
Taille et position de la fenêtre, dans les coordonnées clientes de pParentWnd.

pParentWnd
Pointe vers l’objet de fenêtre parent.

nID
Identificateur de la fenêtre enfant.

Valeur de retour

Retourne TRUE en cas de réussite, FALSE en cas d’échec.

Notes

Les CreateEx paramètres spécifient la position et la taille initiales WNDCLASS, le style de fenêtre et (éventuellement) la taille et la position initiales de la fenêtre. CreateEx spécifie également le parent de la fenêtre (le cas échéant) et l’ID.

Quand CreateEx il s’exécute, Windows envoie les messages WM_GETMINMAXINFO, WM_NCCREATE, WM_NCCALCSIZE et WM_CREATE à la fenêtre.

Pour étendre la gestion des messages par défaut, dérivez une classe de CMiniFrameWnd, ajoutez un mappage de messages à la nouvelle classe et fournissez des fonctions membres pour les messages ci-dessus. Remplacez OnCreate, par exemple, l’initialisation nécessaire pour une nouvelle classe.

Remplacez d’autres Ongestionnaires de messages de message pour ajouter d’autres fonctionnalités à votre classe dérivée.

Si le style WS_VISIBLE est donné, Windows envoie la fenêtre tous les messages nécessaires à l’activation et à l’affichage de la fenêtre. Si le style de fenêtre spécifie une barre de titre, le titre de la fenêtre pointé par le paramètre lpszWindowName s’affiche dans la barre de titre.

Le paramètre dwStyle peut être n’importe quelle combinaison de styles de fenêtre.

Les fenêtres de boîte à outils Palette de styles anciennes ne sont plus prises en charge. L’ancien style, qui n’avait pas de bouton Fermer « X », a été pris en charge lors de l’exécution d’une application MFC sur les versions précédentes de Windows, mais n’est plus pris en charge dans Visual C++.NET. Seul le nouveau style de WS_EX_TOOLWINDOW est désormais pris en charge ; pour obtenir une description de ce style, consultez Styles de fenêtre étendus.

Voir aussi

CFrameWnd, classe
Graphique hiérarchique
CFrameWnd, classe