Freigeben über


CMiniFrameWnd-Klasse

Stellt ein Rahmenfenster mit halber Höhe dar, das in der Regel um unverankerte Symbolleisten sichtbar ist.

Syntax

class CMiniFrameWnd : public CFrameWnd

Member

Öffentliche Konstruktoren

Name Beschreibung
CMiniFrameWnd::CMiniFrameWnd Erstellt ein CMiniFrameWnd-Objekt.

Öffentliche Methoden

Name Beschreibung
CMiniFrameWnd::Create Erstellt nach der Konstruktion ein CMiniFrameWnd Objekt.
CMiniFrameWnd::CreateEx Erstellt nach der Konstruktion ein CMiniFrameWnd Objekt (mit zusätzlichen Optionen).

Hinweise

Diese Miniframefenster verhalten sich wie normale Rahmenfenster, mit der Ausnahme, dass sie keine Mini-/Maximierungsschaltflächen oder Menüs haben, und Sie müssen nur mit einem Klick auf das Systemmenü klicken, um sie zu schließen.

Um ein CMiniFrameWnd Objekt zu verwenden, definieren Sie zuerst das Objekt. Rufen Sie dann die Create-Memberfunktion auf, um das Miniframefenster anzuzeigen.

Weitere Informationen zur Verwendung von CMiniFrameWnd Objekten finden Sie im Artikel "Andocken" und "Unverankerte Symbolleisten".

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CFrameWnd

CMiniFrameWnd

Anforderungen

Header: afxwin.h

CMiniFrameWnd::CMiniFrameWnd

Erstellt ein CMiniFrameWnd Objekt, erstellt aber nicht das Fenster.

CMiniFrameWnd();

Hinweise

Rufen Sie zum Erstellen des Fensters CMiniFrameWnd::Create auf.

CMiniFrameWnd::Create

Erstellt das Windows-Miniframefenster und fügt es an das CMiniFrameWnd Objekt an.

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

Parameter

lpClassName
Verweist auf eine mit Null beendete Zeichenfolge, die die Windows-Klasse benennt. Der Klassenname kann ein beliebiger Name sein, der mit der globalen AfxRegisterWndClass-Funktion registriert ist. Wenn NULL, wird die Fensterklasse für Sie vom Framework registriert. MFC gibt der Standardklasse die folgenden Stile und Attribute:

  • Legt Formatvorlagenbit CS_DBLCLKS fest, die Doppelklicknachrichten an die Fensterprozedur sendet, wenn der Benutzer auf die Maus doppelklickt.

  • Legt Formatvorlagenbits CS_HREDRAW und CS_VREDRAW fest, wodurch der Inhalt des Clientbereichs neu gezeichnet wird, wenn das Fenster die Größe ändert.

  • Legt den Klassencursor auf den Windows-Standard-IDC_ARROW fest.

  • Legt den Hintergrundpinsel der Klasse auf NULL fest, sodass das Fenster den Hintergrund nicht löscht.

  • Legt das Klassensymbol auf das standardmäßige Windows-Logosymbol mit waving-Flag fest.

  • Legt das Fenster auf die Standardgröße und -position fest, wie von Windows angegeben.

lpWindowName
Verweist auf eine mit Null beendete Zeichenfolge, die den Fensternamen enthält.

dwStyle
Gibt die Attribute der Fensterformatvorlage an. Dazu können Standardfensterstile und mindestens eine der folgenden speziellen Formatvorlagen gehören:

  • MFS_MOVEFRAME Ermöglicht das Verschieben des Minirahmenfensters durch Klicken auf einen beliebigen Rand des Fensters, nicht nur durch Klicken auf die Beschriftung.

  • MFS_4THICKFRAME Deaktiviert die Größenänderung des Miniframefensters.

  • MFS_SYNCACTIVE Synchronisiert die Aktivierung des Miniframefensters mit der Aktivierung des übergeordneten Fensters.

  • MFS_THICKFRAME Lässt die Größe des Miniframefensters so klein zu, wie der Inhalt des Clientbereichs zulässig ist.

  • MFS_BLOCKSYSMENU Deaktiviert den Zugriff auf das Systemmenü und das Steuerelementmenü und konvertiert sie in einen Teil der Beschriftung (Titelleiste).

Weitere Informationen finden Sie unter CWnd::Create for a description of possible window style values. Die typische Kombination für Minirahmenfenster ist WS_POPUP|WS_CAPTION|WS_SYSMENU.

rect
Eine RECT Struktur, die die gewünschten Dimensionen des Fensters angibt.

pParentWnd
Verweist auf das übergeordnete Fenster. Verwenden Sie NULL für Fenster der obersten Ebene.

Nid
Wenn das Miniframefenster als untergeordnetes Fenster erstellt wird, ist dies der Bezeichner des untergeordneten Steuerelements; andernfalls 0.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Create initialisiert den Klassennamen und den Fensternamen des Fensters und registriert Standardwerte für die Formatvorlage und das übergeordnete Element des Fensters.

CMiniFrameWnd::CreateEx

Erstellt ein CMiniFrameWnd-Objekt.

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

Parameter

dwExStyle
Gibt die erweiterte Formatvorlage für die CMiniFrameWnd Erstellung an. Wenden Sie eine der erweiterten Fensterformatvorlagen auf das Fenster an.

lpClassName
Verweist auf eine mit Null beendete Zeichenfolge, die die Windows-Klasse (eine WNDCLASS-Struktur ) benennt. Der Klassenname kann ein beliebiger Name sein, der mit der globalen AfxRegisterWndClass-Funktion oder einem der vordefinierten Steuerelementklassennamen registriert ist. Er darf nicht NULL sein.

lpWindowName
Verweist auf eine mit Null beendete Zeichenfolge, die den Fensternamen enthält.

dwStyle
Gibt die Attribute der Fensterformatvorlage an. Eine Beschreibung der möglichen Werte finden Sie unter "Fensterarten" und "CWnd::Create ".

rect
Die Größe und Position des Fensters in Clientkoordinaten von pParentWnd.

pParentWnd
Verweist auf das übergeordnete Fensterobjekt.

Nid
Der Bezeichner des untergeordneten Fensters.

Rückgabewert

Gibt WAHR für Erfolg, FALSE bei Fehler zurück.

Hinweise

Die CreateEx Parameter geben die WNDCLASS-, Fensterformat- und (optional) Anfangsposition und -größe des Fensters an. CreateEx gibt außerdem das übergeordnete Element des Fensters (sofern vorhanden) und die ID an.

Bei CreateEx Ausführung sendet Windows die WM_GETMINMAXINFO-, WM_NCCREATE-, WM_NCCALCSIZE- und WM_CREATE-Nachrichten an das Fenster.

Um die Standardnachrichtenbehandlung zu erweitern, leiten Sie eine Klasse ab CMiniFrameWnd, fügen Sie der neuen Klasse eine Nachrichtenzuordnung hinzu, und stellen Sie Memberfunktionen für die obigen Nachrichten bereit. Überschreiben OnCreateSie z. B. die erforderliche Initialisierung für eine neue Klasse.

Überschreiben Sie weitere OnNachrichtennachrichtenhandler , um Ihrer abgeleiteten Klasse weitere Funktionen hinzuzufügen.

Wenn die WS_VISIBLE Formatvorlage angegeben ist, sendet Windows das Fenster alle nachrichten, die zum Aktivieren und Anzeigen des Fensters erforderlich sind. Wenn die Fensterformatvorlage eine Titelleiste angibt, wird der fenstertitel, auf den der parameter lpszWindowName verweist, in der Titelleiste angezeigt.

Der dwStyle-Parameter kann eine beliebige Kombination aus Fensterformatvorlagen sein.

Die Fenster der Paletten-Toolbox im alten Stil werden nicht mehr unterstützt. Der alte Stil, der nicht über eine Schaltfläche "X" "Schließen" verfügte, wurde unterstützt, wenn eine MFC-Anwendung in früheren Versionen von Windows ausgeführt wird, aber in Visual C++.NET nicht mehr unterstützt wird. Nur die neue WS_EX_TOOLWINDOW-Formatvorlage wird jetzt unterstützt; eine Beschreibung dieser Formatvorlage finden Sie unter "Erweiterte Fensterarten".

Siehe auch

CFrameWnd-Klasse
Hierarchiediagramm
CFrameWnd-Klasse