Bezeichnung
SetLayerName -- weist einer Ebene einen Namen zu (V2.0)
Übersicht
SetLayerName(id, name$)
Beschreibung
Sie können diesen Befehl verwenden, um einen Namen für die in id angegebene Ebene zuzuweisen. Dies ist sehr nützlich, wenn Sie mehrere Ebenen benutzen, deren IDs ständig ändern (zum Beispiel, weil Sie häufig Ebenen einfügen und/oder entfernen). Wenn Sie Ihren Ebenen einen Namen geben, müssen Sie sich keine Sorgen mehr machen, an welcher Position die Ebene zur Zeit ist. Sie können leicht auf die Ebene zugreifen, indem Sie einfach ihren Namen verwenden. Alle Befehle, die Ebenen-IDs annehmen, werden auch die Namen akzeptieren.

Bitte beachten Sie, dass der Name für die Ebene innerhalb des aktuellen Ebenenspeichers des Hintergrundbildes eindeutig sein muss. Bei Ebenennamen werden Groß- und Kleinschreibung nicht unterschieden, das heißt "layer1" ist die gleiche Ebene wie "LAYER1".

Um herauszufinden, welche ID eine Ebene zur Zeit belegt, können Sie das Attribut #ATTRLAYERID mit dem Befehl GetAttribute() verwenden.

Wenn Sie einen Namen der neuesten Ebene zuordnen wollen, übergeben Sie einfach 0 und Hollywood wird automatisch die oberste Ebene verwenden. Um eine Ebenennamen zu entfernen, übergeben Sie eine leere Zeichenkette ("") in name$.

Sie müssen Ebenen aktivieren, bevor Sie diesen Befehl benutzen können. Siehe Einführung in die Ebenentechnik für Details.

Eingaben
id
Identifikator der Ebene oder 0 für die neuste Ebene
name$
gewünschter Name für die Ebene
Beispiel
EnableLayers()
SetFillStyle(#FILLCOLOR)

Box(0, 0, 100, 100, #RED)      ; erstellt Ebene 1
Box(50, 50, 100, 100, #GREEN)  ; erstellt Ebene 2

SetLayerName(1, "redbox")      ; weist Ebene 1 den Namen zu
SetLayerName(2, "greenbox")    ; weist Ebene 2 den Namen zu

SwapLayers("redbox", "greenbox")  ; tauscht sie! Nun ist "greenbox"
Ebene 1; und "redbox" Ebene 2!

ShowLayer("redbox", #RIGHT, #BOTTOM)  ; verschiebt Ebene 2 nach
unten rechts
ShowLayer("greenbox", #LEFT, #TOP)    ; verschiebt Ebene 1 nach
oben links
Sie sehen, dass es viel einfacher ist für die Ebenen, wenn man anstelle von Ebenen-IDs mit Zeichenkettennamen arbeitet, da IDs auf die Ebenenposition relativ sind.

Navigation zeigen