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
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 OnCreate
Sie z. B. die erforderliche Initialisierung für eine neue Klasse.
Überschreiben Sie weitere On
Nachrichtennachrichtenhandler , 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".