Bezeichnung
CreateDisplay -- erstellt ein neues Display (V4.5)
Übersicht
[id] = CreateDisplay(id[, table])
Beschreibung
Dieser Befehl kann verwendet werden, um ein neues Display zu erstellen, welches Sie mit dem Befehl OpenDisplay() öffnen dürfen. Sie können entweder eine ID oder Nil für das neue Display übergeben. Wenn Sie Nil angegeben haben, wird CreateDisplay() eine ID-Nummer für dieses Display zurückgeben.

Darüber hinaus sollten Sie eine Tabelle als zweites Argument übergeben, mit welcher Sie den Stil für das neue Display konfigurieren können. Bitte beachten Sie, dass jedes Display ein BGPic haben muss. Daher ist es ratsam, dass Sie den Tag BGPic in der optionalen Tabelle angeben, wenn Sie ein neues Display erstellen. Wenn Sie den BGPic-Tag nicht angeben, wird CreateDisplay() automatisch ein neues BGPic für das neue Display erstellen. Dieses neue BGPic wird die in Width/Height (Breite/Höhe) angegeben Größe übernehmen und es wird nach dem in FillStyle angegeben Stil gefüllt werden. Wenn Sie aber den BGPic-Tag angeben, werden Width, Height und FillStyle ignoriert.

Beachten Sie auch, dass das gleiche BGPic nicht mit mehreren Displays in Verbindung gebracht werden kann. Jedes BGPic darf nur einem einzigen Display zugewiesen werden. Es ist zum Beispiel nicht möglich, BGPic 1 Display 1 und 2 zuzuordnen. Machen Sie sonst einfach eine Kopie des BGPic mit dem Befehl CopyBGPic(), wenn Sie ein einzelnes BGPic mit mehreren Displays verwenden müssen.

Die optionale Tabelle erkennt die folgenden Tags:

BGPic:
Gibt das BGPic an, welches mit dem neuen Display arbeiten soll. Sie müssen entweder diesen Tag oder Width/Height und FillStyle angeben. Siehe oben für weitere Hinweise.

Width, Height:
Siehe DISPLAY für Details. Wird ignoriert, wenn Sie den BGPic-Tag gesetzt haben.

X, Y:
Siehe DISPLAY für Details.

Mode:
Siehe DISPLAY für Details.

Title:
Siehe DISPLAY für Details.

Borderless:
Siehe DISPLAY für Details.

Sizeable:
Siehe DISPLAY für Details.

Fixed:
Siehe DISPLAY für Details.

Backfill:
Siehe DISPLAY für Details.

ScrWidth, ScrHeight:
Siehe DISPLAY für Details.

ScrDepth:
Siehe DISPLAY für Details.

NoHide:
Siehe DISPLAY für Details.

NoModeSwitch:
Siehe DISPLAY für Details.

NoClose:
Siehe DISPLAY für Details.

Active:
Siehe DISPLAY für Details.

HidePointer:
Siehe DISPLAY für Details.

UseQuartz:
Siehe DISPLAY für Details.

ScaleMode:
Siehe DISPLAY für Details.

ScaleWidth, ScaleHeight:
Siehe DISPLAY für Details.

SmoothScale:
Siehe DISPLAY für Details.

DragRegion:
Siehe DISPLAY für Details.

SizeRegion:
Siehe DISPLAY für Details.

Layers:
Siehe DISPLAY für Details.

FitScale:
Siehe DISPLAY für Details. (V4.7)

KeepProportions:
Siehe DISPLAY für Details. (V4.7)

FillStyle:
Siehe DISPLAY für Details.. Wird ignoriert, wenn Sie den BGPic-Tag gesetzt haben. Voreingestellt ist #FILLCOLOR. (V5.0)

Color:
Siehe DISPLAY für Details.

TextureBrush:
Siehe DISPLAY für Details. (V5.0)

TextureX, TextureY:
Siehe DISPLAY für Details. (V5.0)

GradientStyle:
Siehe DISPLAY für Details. (V5.0)

GradientAngle:
Siehe DISPLAY für Details. (V5.0)

GradientStartColor, GradientEndColor:
Siehe DISPLAY für Details. (V5.0)

GradientCenterX, GradientCenterY:
Siehe DISPLAY für Details. (V5.0)

GradientBalance:
Siehe DISPLAY für Details. (V5.0)

GradientBorder:
Siehe DISPLAY für Details. (V5.0)

GradientColors:
Siehe DISPLAY für Details. (V5.0)

KeepScreenOn:
Siehe DISPLAY für Details. (V5.1)

PubScreen:
Siehe DISPLAY für Details. (V5.2)

HideFromTaskbar:
Siehe DISPLAY für Details. (V5.3)

HideOptionsMenu:
Siehe DISPLAY für Details. (V5.3)

Orientation:
Siehe DISPLAY für Details. (V5.3)

DisableBlanker:
Siehe DISPLAY für Details. (V6.0)

Menu:
Siehe DISPLAY für Details. (V6.0)

Monitor:
Siehe DISPLAY für Details. (V6.0)

XServer:
Siehe DISPLAY für Details. (V6.0)

ScreenTitle:
Siehe DISPLAY für Details. (V6.0)

ScreenName:
Siehe DISPLAY für Details. (V6.0)

RememberPosition:
Siehe DISPLAY für Details. (V6.1)

Maximized:
Siehe DISPLAY für Details. (V7.0)

TrapRMB:
Siehe DISPLAY für Details. (V7.0)

NoScaleEngine:
Siehe DISPLAY für Details. (V7.0)

NoLiveResize:
Siehe DISPLAY für Details. (V7.0)

NativeUnits:
Siehe DISPLAY für Details. (V7.0)

AlwaysOnTop:
Siehe DISPLAY für Details. (V7.1)

NoCyclerMenu:
Siehe DISPLAY für Details. (V8.0)

HideTitleBar:
Siehe DISPLAY für Details. (V8.0)

Subtitle:
Siehe DISPLAY für Details. (V8.0)

SingleMenu:
Siehe DISPLAY für Details. (V8.0)

ScaleFactor:
Siehe DISPLAY für Details. (V8.0)

ImmersiveMode:
Siehe DISPLAY für Details. (V9.0)

Palette:
Siehe DISPLAY für Details. (V9.0)

FillPen:
Siehe DISPLAY für Details. (V9.0)

SoftwareRenderer:
Siehe DISPLAY für Details. (V9.0)

VSync:
Siehe DISPLAY für Details. (V9.0)

ScaleSwitch:
Siehe DISPLAY für Details. (V9.0)

UserTags:
Siehe DISPLAY für Details. (V10.0)

Nachdem das Display erfolgreich erstellt wurde, können Sie es öffnen, indem Sie OpenDisplay() aufrufen. Möchten Sie mit Grafikbefehlen hineinzeichnen, verwenden Sie den Befehl SelectDisplay() und zum Schließen den Befehl CloseDisplay().

Siehe SelectDisplay für die Verwendung mehrerer Displays mit Hollywood.

Dieser Befehl ist auch als Präprozessor vorhanden: Verwenden Sie @DISPLAY um beim Start ein Display zu erstellen!

Eingaben
id
Identifikator für das Display oder Nil für die automatische ID-Zuweisung
table
optional: weitere Konfigurationsmöglichkeiten
Rückgabewerte
id
optional: Identifikator des neuen Displays; wird nur zurückgegeben, wenn Sie Nil als erstes Argument übergeben haben (siehe oben)
Beispiel
CreateDisplay(2, {BGPic = 2, Active = True})
OpenDisplay(2)
NPrint("Hello World")
Der obige Code erstellt ein neues Display und weist ihm BGPic Nummer 2 zu. Das Display zeigt die Größe und Grafiken von BGPic an. Dann öffnen wir das Display und geben "Hello World" aus.


CreateDisplay(2, {Width = 800, Height = 600, Borderless = True,
   Color = #WHITE, Active = True})
OpenDisplay(2)
Der obige Code erstellt und öffnet eine 800x600 großes randloses Display mit weißem Hintergrund. Weil wir kein BGPic für dieses Display angegeben haben, wird CreateDisplay() eines automatisch erstellen und dem neuen Display zuweisen. Sie können mit dem Befehl GetAttribute() und dem Argument #ATTRBGPIC die automatisch erstellte ID das BGPic abfragen.

Navigation zeigen