OpenWindow

OpenWindow()

Syntax

Ergebnis = OpenWindow(#Window, x, y, InnereBreite, InnereHöhe, Titel$ [, Flags [, ParentWindowID]])

Beschreibung

Öffnet ein neues Fenster entsprechend den übergegebenen Parametern.

Das neue Fenster wird automatisch zum aktiven Fenster, d.h. es muss nicht erst der SetActiveWindow() Befehl verwendet werden (außer das Fenster wurde unsichtbar erstellt).

Parameter

#Window Eine Nummer, um das neue Fenster zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.

x, y Die anfängliche Position des Fensters, in Pixel (außer eines der Flags zum Zentrieren des Fensters wird verwendet). IWenn 'x' oder 'y' auf #PB_Ignore gesetzt wird, dann wird das OS eine Position für das Fenster auswählen.

InnereBreite, InnereHöhe Die benötigte innere Fenstergröße ("Client area"), in Pixel (ohne Ränder und andere Fensterdekorationen).

Titel$ Der Titel des neu erstellten Fensters.
Flags (optional)
Kann eine Kombination der folgenden Werte sein:
  #PB_Window_SystemMenu    : Schaltet das System-Menü in der Fenster-Titelzeile ein. (Standard)
  #PB_Window_MinimizeGadget: Fügt das Minimieren-Gadget der Fenster-Titelzeile hinzu.
                             #PB_Window_SystemMenu wird automatisch hinzugefügt.
  #PB_Window_MaximizeGadget: Fügt das Maximieren-Gadget der Fenster-Titelzeile hinzu.
                             #PB_Window_SystemMenu wird automatisch hinzugefügt.
                             (nur auf MacOS: #PB_Window_SizeGadget wird ebenfalls automatisch hinzugefügt)
  #PB_Window_SizeGadget    : Fügt das Größenänderungs-Gadget zum Fenster hinzu.
  #PB_Window_Invisible     : Erstellt ein Fenster, zeigt es aber nicht an.
  #PB_Window_TitleBar      : Erstellt ein Fenster mit einer Titelzeile.
  #PB_Window_Tool          : Erstellt ein Fenster mit einer schmaleren Titelzeile und ohne Taskleisten-Eintrag.
  #PB_Window_BorderLess    : Erstellt ein Fenster ohne jegliche Ränder.
  #PB_Window_ScreenCentered: Zentriert das Fenster in der Mitte des Bildschirms. Die Parameter x,y werden ignoriert.
  #PB_Window_WindowCentered: Zentriert das Fenster in der Mitte des übergeordneten Fensters ("parent window" - 
                             'ParentWindowID' muss dazu angegeben werden). Die Parameter x,y werden ignoriert.
  #PB_Window_Maximize      : Öffnet das Fenster maximiert. (Hinweis: Unter Linux unterstützen dies nicht alle
                             Window-Manager.)
  #PB_Window_Minimize      : Öffnet das Fenster minimiert.
  #PB_Window_NoGadgets     : Verhindert das Erstellen einer Gadgetliste. UseGadgetList() kann verwendet werden, um dies später zu tun.
  #PB_Window_NoActivate    : Aktiviert das Fenster nach dem Öffnen nicht.
ParentWindowID (optional) Die WindowID, zu der das neue Fenster gehört. Der 'ParentWindowID' Wert kann einfach mittels WindowID() ermittelt werden.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn das Fensters erfolgreich erstellt wurde, andernfalls Null. Falls #PB_Any als #Window Parameter verwendet wurde, wird bei Erfolg die generierte Nummer zurückgegeben.

Anmerkungen

Alle möglichen Ereignisse innerhalb eines Fensters werden mit den Befehlen WindowEvent() und WaitWindowEvent() abgefragt.

Nur Windows: Für spezielle Situationen werden Callbacks verwendet, siehe Beschreibung bei SetWindowCallback(). Auf Windows kann die Breite und Höhe eines Fensters mit Titelzeile nicht kleiner als etwa 100 Pixel sein. Zum Öffnen eines kleineren Fensters verwenden Sie das #PB_Window_BorderLess Flag (rahmenloses Fenster).

Ein Fenster sollte nicht in einem Thread geöffnet werden, da es hierfür einige Einschränkungen auf OS X und Linux gibt. Ein Debugger-Fehler wird ausgelöst.

Siehe auch

CloseWindow()

Unterstützte OS

Alle

<- IsWindow() - Window Inhaltsverzeichnis - PostEvent() ->

#Window	Eine Nummer, um das neue Fenster zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y	Die anfängliche Position des Fensters, in Pixel (außer eines der Flags zum Zentrieren des Fensters wird verwendet). IWenn 'x' oder 'y' auf #PB_Ignore gesetzt wird, dann wird das OS eine Position für das Fenster auswählen.
InnereBreite, InnereHöhe	Die benötigte innere Fenstergröße ("Client area"), in Pixel (ohne Ränder und andere Fensterdekorationen).
Titel$	Der Titel des neu erstellten Fensters.
Flags (optional)	Kann eine Kombination der folgenden Werte sein: #PB_Window_SystemMenu : Schaltet das System-Menü in der Fenster-Titelzeile ein. (Standard) #PB_Window_MinimizeGadget: Fügt das Minimieren-Gadget der Fenster-Titelzeile hinzu. #PB_Window_SystemMenu wird automatisch hinzugefügt. #PB_Window_MaximizeGadget: Fügt das Maximieren-Gadget der Fenster-Titelzeile hinzu. #PB_Window_SystemMenu wird automatisch hinzugefügt. (nur auf MacOS: #PB_Window_SizeGadget wird ebenfalls automatisch hinzugefügt) #PB_Window_SizeGadget : Fügt das Größenänderungs-Gadget zum Fenster hinzu. #PB_Window_Invisible : Erstellt ein Fenster, zeigt es aber nicht an. #PB_Window_TitleBar : Erstellt ein Fenster mit einer Titelzeile. #PB_Window_Tool : Erstellt ein Fenster mit einer schmaleren Titelzeile und ohne Taskleisten-Eintrag. #PB_Window_BorderLess : Erstellt ein Fenster ohne jegliche Ränder. #PB_Window_ScreenCentered: Zentriert das Fenster in der Mitte des Bildschirms. Die Parameter x,y werden ignoriert. #PB_Window_WindowCentered: Zentriert das Fenster in der Mitte des übergeordneten Fensters ("parent window" - 'ParentWindowID' muss dazu angegeben werden). Die Parameter x,y werden ignoriert. #PB_Window_Maximize : Öffnet das Fenster maximiert. (Hinweis: Unter Linux unterstützen dies nicht alle Window-Manager.) #PB_Window_Minimize : Öffnet das Fenster minimiert. #PB_Window_NoGadgets : Verhindert das Erstellen einer Gadgetliste. UseGadgetList() kann verwendet werden, um dies später zu tun. #PB_Window_NoActivate : Aktiviert das Fenster nach dem Öffnen nicht.
ParentWindowID (optional)	Die WindowID, zu der das neue Fenster gehört. Der 'ParentWindowID' Wert kann einfach mittels WindowID() ermittelt werden.