CreateMDIWindowA-Funktion (winuser.h)

Artikel
08/27/2023

Erstellt ein untergeordnetes MDI-Fenster (MDI).

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 Funktion RegisterClassEx registriert worden sein.

[in] lpWindowName

Typ: LPCTSTR

Der Fenstername. Das System zeigt den Namen in der Titelleiste des untergeordneten Fensters an.

[in] dwStyle

Art: DWORD

Der Stil des untergeordneten MDI-Fensters. Wenn das MDI-Clientfenster mit der MDIS_ALLCHILDSTYLES Fensterformat erstellt wird, kann es sich bei diesem Parameter um eine beliebige Kombination der auf der Seite Fensterformatvorlagen aufgeführten Fensterstile handelt. Andernfalls ist dieser Parameter auf mindestens einen der folgenden Werte beschränkt.

Wert	Bedeutung
WS_MINIMIZE 0x200000000L	Erstellt ein untergeordnetes MDI-Fenster, das zunächst minimiert wird.
WS_MAXIMIZE 0x010000000L	Erstellt ein untergeordnetes MDI-Fenster, das zunächst maximiert wird.
WS_HSCROLL 0x00100000L	Erstellt ein untergeordnetes MDI-Fenster mit einer horizontalen Bildlaufleiste.
WS_VSCROLL 0x00200000L	Erstellt ein untergeordnetes MDI-Fenster mit einer vertikalen Bildlaufleiste.

[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 anfängliche vertikale Position in Clientkoordinaten des untergeordneten MDI-Fensters. Wenn dieser Parameter CW_USEDEFAULT ist, 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_USEDEFAULT ist, wird dem untergeordneten MDI-Fenster die Standardbreite zugewiesen.

[in] nHeight

Typ: int

Die Anfangshöhe des untergeordneten MDI-Fensters in Geräteeinheiten. Wenn dieser Parameter auf CW_USEDEFAULT festgelegt 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 instance 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 bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Hinweis

Der winuser.h-Header definiert CreateMDIWindow als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll