Anzeige-Element

Aufruf aus der Befehlsliste: Anzeige-Element

Dieser Befehl erstellt ein Steuerelement im Ausgabefenster oder einer Zeichenfläche. Typ, Position, Größe und Eigenschaften werden in dem Dialog eingestellt. Es sind auch spätere Zugriffe über Platzhalter möglich.

Der Text (bei einigen Elementen auch Bild) bestimmt die Beschriftung des Elements. Hier können über Sonderzeichen auch Zeilenumbrüche (^M) oder Tabulatoren (^T) eingesetzt werden.

Die ID dient der Identifikation des Elements für spätere Zugriffe.

Hinweis: Die ID muss mit einem Buchstaben beginnen und darf keine Leerzeichen enthalten.

Hinweis 2: Die selbe ID darf nicht für mehrere Elemente vergeben werden.

Hinweis 3: Die Tastenkombination Alt-Entf löscht die Basiseigenschaften in dem Dialog. Dies ist hilfreich, wenn der Grundbefehl für das Ändern von Eigenschaften kopiert wird und Position und Größe dabei nicht verändert werden sollen.

Folgende Elemente können eingesetzt werden, wobei die Auswahl über das entsprechende Register erfolgt:

Button

Schaltfläche
Wahlweise kann die Schaltfläche als "Vorgabe" (Auslösung durch [Enter]) und/oder als "Abbruch" (Auslösung durch [Escape]) definiert werden.
Außerdem kann ein Bild bzw. Icon für den Button sowie eine Hintergrundfarbe eingestellt werden.

Schalter

Schalter (quadratisch), der ein- oder ausgeschaltet werden kann. Wahlweise kann das Häkchen direkt hier oder später über Setze gesetzt bzw. entfernt werden.
Wird in dem Eingabefeld neben dem "Eingeschaltet"-Schalter ein Ausdruck eingegeben (etwa Platzhalter), wird der Schalter deaktiviert und der Schalterzustand hängt vom Wert des Ausdrucks ab (0=aus, sonst an).

Option

Wahlschalter (rund), auch Radiobutton genannt, bei denen immer nur einer von mehreren aktiviert ist. Die Vorgabe des Einschaltzustands erfolgt wie bei Schalter (s.o.)
Hinweis: Werden mehrere Optionsgruppen benötigt, können diese in Zeichenflächen gelegt werden. Hierbei sollten die Optionselemente die letzten Elemente in der Zeichenfläche sein.

Bild	Grafik aus Datei verschiedener Typen (z.B. BMP, WMF, ICO, GIF, JPG, PNG). Es können auch alternative Bildquellen wie z.B. %Clip%, %Desktop% oder %Karte X% verwendet werden. Hinweis: Durch Auslassen der Breiten/Höhenangabe wird das Bild in der Originalgröße dargestellt.

Eingabefeld

Textbox für die Eingabe eines Textes, wahlweise auch nicht editierbar (nur Lesen).
Hierbei kann zusätzlich die maximale Anzahl Zeichen vorgegeben werden, die in das Feld eingetragen werden dürfen, sowie die ausschließliche Eingabe von Ziffern (einschließlich "-", ",", "." und ":") erzwungen werden.
Außerdem kann das Feld für eine mehrzeilige Eingabe freigegeben werden, wahlweise mit zusätzlichem vertikalem Schieber am rechten Rand.
Die Option automatisch markieren bewirkt, dass der Textinhalt bei Aktivierung des Elementes vollständig markiert wird. Dies ist für Texte sinnvoll, für die im Allgemeinen ein anderer Text eingetragen werden soll. Wahlweise kann der Text auch rechtsbündig bzw. zentriert ausgerichtet werden.

Bezeichner

Beschriftungs-Text (Wird hier ein & eingesetzt, ergibt sich so ein unterstrichener Shortcut - das folgende Element wird dann durch diesen Shortcut aktiviert).
Wahlweise kann der Text mit einem Rahmen versehen oder rechtsbündig bzw. zentriert ausgerichtet werden.

Schieber

Horizontaler oder vertikaler Schieberegler, dessen Minimum- und Maximumwerte Sie vorgeben können (Standard=0 bis 100). Die Option Schrittweite bestimmt die Werteveränderung beim Klick in den Schiebebereich und gleichzeitig die Größe des Schiebebereichs selbst.

Zeichenfläche wahlweise umrandeter Bereich im Fenster, welcher auch als Zielfenster bei den Befehlen Ausgabe, Zeichne sowie den Anzeige-Elementen in der Form Anzeige-ID.ElementeID angegeben werden kann (siehe Auswahlliste Zielfenster-ID). Hierdurch lassen sich Bereiche im Fenster schaffen, in denen bestimmte Ausgaben stattfinden oder Elemente gruppiert werden können (Container-Prinzip), wobei die Koordinaten der Elemente innerhalb des Containers relativ zu diesem angegeben werden müssen (Position 0/0 = oben links im Container). Außerdem müssen die Kindelemente im Skript nach dem Containerelement eingesetzt werden.
Hinweis: Der Zugriff auf in Container eingesetzte Elemente erfolgt wie bei allen anderen, also mit dem Anzeige(Fenster-ID).Element(Elemente-ID) - hier wird im Gegensatz zur Schreibweise der Zielfenster-ID als Fenster-ID nicht der Container mit angegeben.
Ist die Option Rahmen zeichnen aktiviert, wird ein Gruppierungsrahmen mit dem oben angegebenen Text gezeichnet. Andernfalls kann oben unter Text auch ein Bild angegeben werden, das dann unskaliert in der Zeichenfläche angezeigt wird.
Unten finden Sie ein Beispiel, welches diese Möglichkeiten demonstriert.

Die meisten der Elemente können außerdem mit einer Vordergrundfarbe versehen werden. Existiert das angegebene Element bereits, werden nicht ausgefüllte Werte für X, Y, Breite und Höhe ignoriert und die Originalwerte beibehalten.

Die Option Entfernen löscht das Element aus dem Fenster und aus dem Speicher.

Der Eintrag Tooltiptext bestimmt den gelben Hilfstext, der bei Berührung des Elements (außer Schieber) angezeigt wird.

Sollten mehrere Fenster vorhanden sein, kann auch die ID des Zielfensters angegeben werden, ansonsten wird das aktive Fenster als Ziel verwendet.

Wird das Element angeklickt, erfolgt automatisch der Aufruf des Unterprogramms ::Anzeige_Element(X), wobei X für ID (falls angegeben) steht. Folgende Ereignis-Unterprogramme können zusätzlich eingesetzt werden, wobei der Ereignisname an den Elementenamen angehängt wird (z.B. ::Anzeige_Element(X)_Doppelklick):

_Klick		Element angeklickt bzw. Wert bei Schaltern verändert
_Doppelklick	(alle Elemente außer Button)	Doppelklick ausgeführt
_Verändert	(Text)	tritt auf pro Zeichen, wenn eine Eingabe stattfindet
_Aktiviert	(Text, Liste, Button)	Element erhält den Fokus
_Deaktiviert	(Text, Liste, Button)	Element verliert den Fokus

Die Variable [Anzeige.Element(X)] oder nur [.Element(X)] enthält den Zustand des Elementes X (Schaltfläche: gedrückt, Schalter: aktiviert, Eingabefeld: Text) und kann auch eingesetzt werden, um mit Setze diesen Zustand zu verändern.

In der Variablen [Anzeige.Element] (ohne Angabe des Elementes X) ist zusätzlich die ID bzw. Nummer des zuletzt angeklickten Elementes enthalten. [Anzeige.AktivesElement] liefert die ID des momentan aktiven Elements im Fenster.

Weitere Eigenschaften-Zuordnungen:

Über die Schaltfläche Extra-Eigenschaften oder [Strg]-[F9] kann ein Eingabe-Dialog eingeblendet werden, in dem weitere zu setzende Eigenschaften des Elements eingetragen werden können - pro Zeile Eigenschaft=Wert. Hierdurch können weitere Anpassungen des Elements über die in dem Dialog vorhandenen Eigenschaften vorgenommen werden. Ein Anwendungsbeispiel finden Sie unter Extra-Eigenschaften.

Beispielskript:

Anzeigefenster 'Fenster mit Anzeige-Elementen' (ID='', Aktivieren)

Anzeige-Element Hor. Schieber: Wert '0' (ID='HSchieber1')

Anzeige-Liste 'Listbox1' (ID='Programm_Liste')

Anzeige-Element Bezeichner: 'Bezeichnertext' (ID='Programm_Bezeichner', umrandet)

Anzeige-Element Eingabe: 'Eingabefeldtext' (ID='Programm_Eingabefeld')

Anzeige-Element Bild: 'Bildtext' (ID='Programm_Bild', umrandet)

Anzeige-Element Option: 'Optiontext' (ID='Programm_Option', Aktiviert)

Anzeige-Element Schalter: 'Schaltertext' (ID='Programm_Schalter', Aktiviert)

Anzeige-Element Button: 'Buttontext' (ID='Programm_Button')

Anzeige-Element Vert. Schieber: Wert '1' (ID='Programm_Schieber', Min=1, Max=100, Schrittweite=1)

Warte endlos...

Das Beispielskript legt in einem Anzeigefenster die in click.EXE verfügbaren Anzeige-Elemente an. Wenn Sie das Skript starten, erhalten Sie folgende Ausgabe auf dem Bildschirm:

Beispiel für den Umgang mit Zeichenflächen:

Anzeigefenster 'Zeichenflächen-Test' (ID='Test', B=60, H=80, Aktivieren)

( Anzeige-Element Zeichenfläche: '%ICON_Info%' (ID='Fläche1', X=2, Y=10, B=-2, H=50, umrandet, Zielfenster-ID: 'Test')

Anzeige-Element Zeichenfläche: 'Gruppierung' (ID='Fläche1', X=2, Y=10, B=-2, H=50, Rahmen zeichnen, Zielfenster-ID: 'Test')

Anzeige-Element Button: 'Zeichne!' (ID='Draw', X=2, Y=-10, B=20, H=8)

*** Elemente in Zeichenfläche einsetzen

Anzeige-Liste 'Listen-¶Element¶' (ID='L1', X=10, Y=5, B=20, H=10, Zielfenster-ID='Test.Fläche1')

*** voneinander unabhängige Optionsgruppen bilden:

*** eine Gruppe innerhalb der Zeichenfläche

Anzeige-Element Option: 'Gruppe 2 a' (ID='Test1', X=32, Y=5, B=20, H=4, Aktiviert, Zielfenster-ID: 'Test.Fläche1')

Anzeige-Element Option: 'Gruppe 2 b' (ID='Test2', X=32, Y=10, B=20, H=4, Zielfenster-ID: 'Test.Fläche1')

*** ...und eine außerhalb

Anzeige-Element Option: 'Gruppe 1 a' (ID='Test1a', X=2, Y=3, H=4, Aktiviert)

Anzeige-Element Option: 'Gruppe 1 b' (ID='Test1b', X=30, Y=3, H=4)

Warte endlos...

:: Anzeige_Element(Draw)_Klick

*** in Zeichenfläche zeichnen

Zeichne auf Fenster 'Test.Fläche1': 3D-Rechteck (X=1, Y=20, B=30, H=20, Farbig, Verlauf horizontal)

Ausgabe "Hallo!" (auf Fenster 'Test.Fläche1', Zeilenumbruch, 24 Punkt, X=1, Y=40, farbig)

Zurück

Dieses Beispiel zeigt ein Fenster mit einem Gruppierungselement (Zeichenfläche) an, in dem Elemente und Ausgaben stattfinden. Hierbei wird auch gezeigt, wie zwei voneinander unabhängige Optionsschalter-Gruppen erstellt werden können.