CreateMDIWindowA-Funktion (winuser.h)
Erstellt ein untergeordnetes MDI-Fenster (Multiple-Document Interface).
Syntax
HWND CreateMDIWindowA(
[in] LPCSTR lpClassName,
[in] LPCSTR lpWindowName,
[in] DWORD dwStyle,
[in] int X,
[in] int Y,
[in] int nWidth,
[in] int nHeight,
[in, optional] HWND hWndParent,
[in, optional] HINSTANCE hInstance,
[in] LPARAM lParam
);
Parameter
[in] lpClassName
Typ: LPCTSTR-
Die Fensterklasse des untergeordneten MDI-Fensters. Der Klassenname muss durch einen Aufruf der RegisterClassEx--Funktion registriert worden sein.
[in] lpWindowName
Typ: LPCTSTR-
Der Fenstername. Das System zeigt den Namen in der Titelleiste des untergeordneten Fensters an.
[in] dwStyle
Typ: DWORD-
Die Formatvorlage des untergeordneten MDI-Fensters. Wenn das MDI-Clientfenster mit der MDIS_ALLCHILDSTYLES Fensterformatvorlage erstellt wird, kann dieser Parameter eine beliebige Kombination der Fensterformatvorlagen sein, die auf der Seite Fensterformatvorlagen aufgeführt sind. Andernfalls ist dieser Parameter auf mindestens einen der folgenden Werte beschränkt.
[in] X
Typ: int
Die anfängliche horizontale Position in Clientkoordinaten des untergeordneten MDI-Fensters. Wenn dieser Parameter CW_USEDEFAULT ((int)0x80000000 ist), wird dem untergeordneten MDI-Fenster die horizontale Standardposition zugewiesen.
[in] Y
Typ: int
Die vertikale Anfangsposition in Clientkoordinaten des untergeordneten MDI-Fensters. Wenn dieser Parameter CW_USEDEFAULTist, wird dem untergeordneten MDI-Fenster die vertikale Standardposition zugewiesen.
[in] nWidth
Typ: int
Die anfängliche Breite des untergeordneten MDI-Fensters in Geräteeinheiten. Wenn dieser Parameter CW_USEDEFAULTist, wird dem untergeordneten MDI-Fenster die Standardbreite zugewiesen.
[in] nHeight
Typ: int
Die anfängliche Höhe des untergeordneten MDI-Fensters in Geräteeinheiten. Wenn dieser Parameter auf CW_USEDEFAULTfestgelegt ist, wird dem untergeordneten MDI-Fenster die Standardhöhe zugewiesen.
[in, optional] hWndParent
Typ: HWND-
Ein Handle für das MDI-Clientfenster, das das übergeordnete Element des neuen untergeordneten MDI-Fensters ist.
[in, optional] hInstance
Typ: HINSTANCE-
Ein Handle für die Instanz der Anwendung, die das untergeordnete MDI-Fenster erstellt.
[in] lParam
Typ: LPARAM-
Ein anwendungsdefinierter Wert.
Rückgabewert
Typ: HWND-
Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Handle für das erstellte Fenster.
Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Anmerkung
Der winuser.h-Header definiert CreateMDIWindow als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform- | Fenster |
Header- | winuser.h (enthalten Windows.h) |
Library | User32.lib |
DLL- | User32.dll |
Siehe auch
Konzeptionelle
mehrere Dokumentschnittstellen-
Referenz-