<<

Inhaltsverzeichnis

Suchen

>>

 

ADD_TOOLBAR

 

 

Funktion

 

 

Syntax:

ADD_TOOLBAR(<Handle>,<Parameter>,<Makroname>[,<Verschiebbar>])

 

<Handle>

= <NUM-AUSDRUCK>

<Parameter>

= <STRING-AUSDRUCK>

<Makroname>

= <MAKRONAME>

<Verschiebbar>

= <NUM-AUSDRUCK>

 

 

Bedeutung:

ADD_TOOLBAR erzeugt eine zusätzliche Iconleiste (Toolbar).

 

Es können im Mainwindow, Window und Splitwindow beliebig viele zusätzliche Iconleisten erzeugt werden.

 

ADD_TOOLBAR liefert als Ergebnis eine Nummer, die die Iconleiste identifiziert und die zum Entfernen der Iconleiste mit der Funktion REMOVE_TOOLBAR verwendet werden kann.

 

Im Fehlerfall liefert ADD_TOOLBAR als Ergebnis folgende Fehlercodes:

-1: Das Window <HANDLE> existiert nicht
-2: Window nicht gefunden
-3: Im Window <HANDLE> kann keine Toolbar erzeugt werden.

 

Parameter:

Handle

Legt das Window fest, in dem die zusätzliche Toolbar angezeigt wird. Ist <Handle> <= 0, so erfolgt die Anzeige im Mainwindow, andernfalls muss <Handle> entweder eine Windowtiefe oder die Identifizierungsnummer eines NOWAIT-Windows enthalten.

Bei Splitwindows muss der Splithandle angegeben werden.

 

Parameter

Enthält durch Strichpunkt getrennt die Einträge, die die anzuzeigenden Bilder festlegen. Ein leerer Eintrag erzeugt einen zusätzlichen Abstand zum nächsten Bild.

 

Jeder Eintrag muss folgendermaßen aufgebaut sein:

 

 [#][@]<BILDNAME>[,<BILDNAME-OVER>[,<BILDNAME-SELECTED> [,<BILDNAME-OVER-SELECTED>[,<NOAUTOTOGGLE>]]]]  |  <HILFETEXT> | <ID>

 

Achtung: Da das Zeichen | als Trennzeichen fungiert, darf weder <HILFETEXT> noch <ID> das Zeichen | enthalten.

 

Ist das erste Zeichen eines Eintrags das Zeichen "#", so wird das Bild in der Iconleiste rechtsbündig positioniert, andernfalls linksbündig.

 

<BILDNAME> legt das Bild fest, das angezeigt werden soll. <BILDNAME> kann mit und ohne @ angegeben werden.

 

<BILDNAME-OVER> legt das Bild fest, das angezeigt werden soll, wenn sich der Mauszeiger über dem Bild befindet. <BILDNAME-OVER> kann mit und ohne @ angegeben werden.

 

<BILDNAME-SELECTED> legt das Bild fest, das angezeigt werden soll, wenn das Icon durch Drücken eingeschaltet wurde. <BILDNAME-SELECTED> kann mit und ohne @ angegeben werden. Wird ein <BILDNAME-SELECTED> angegeben, so arbeitet das Icon wie ein 2-Phasen-Button: Durch Anklicken wird es eingeschaltet und durch erneutes Anklicken wird es ausgeschaltet.

 

Fehlt der Parameter <NOAUTOTOGGLE> oder ist <NOAUTOTOGGLE> = 0, so bewirkt das Anklicken eines anderen Icons der Toolbar, dass das Icon wieder ausgeschaltet wird.

 

Ist der Parameter <NOAUTOTOGGLE> angegeben und hat er einen numerischen Wert <> 0, so wird das Icon nur durch erneutes Anklicken und nicht durch das Anklicken eines anderen Icons wieder ausgeschaltet wird.

 

Wenn der Makro <Makroname> ausgeführt wird, steht in EBUS_DATA$ der augenblickliche Zustand des Icons: "1" bedeutet eingeschaltet, "0" bedeutet ausgeschaltet.

 

<BILDNAME-OVER-SELECTED> legt das Bild fest, das angezeigt werden soll, wenn sich der Mauszeiger über dem Bild befindet und das Icon eingeschaltet (selected) ist. <BILDNAME-OVER-SELECTED> kann mit und ohne @ angegeben werden.

 

<HILFETEXT> ist der Hilfetext, der angezeigt wird, wenn sich der Mauszeiger über dem Bild befindet.

 

Als <ID> kann ein Identifizierungsstring angegeben werden, der in der Variablen EBUS_DATA$ übergeben wird, wenn das Icon mit der Maus angeklickt wird.

 

Makroname

Der Makro wird ausgeführt, wenn ein Icon der Iconleiste mit der Maus angeklickt wird. EBUS_DATA enthält dann die Nummer des Icons (gezählt wird ab 1 von links nach rechts, leere Einträge werden mitgezählt) und EBUS_DATA$ enthält die <ID>.

 

EBUS_TRANSFER enthält den Zustand des Icons: 1 bedeutet eingeschaltet, 0 bedeutet ausgeschaltet. Ist beim Icon kein <BILDNAME-SELECTED> angegeben, so enthält EBUS_TRANSFER immer 0.

 

Verschiebbar

= 0: Die Toolbar ist nicht verschiebbar.

<> 0: Die Toolbar ist verschiebbar.

 

Fehlt dieser Parameter, so ist die Toolbar verschiebbar.

 

Achtung: Dieser Parameter hat keine Wirkung bei Html-Programmen. Toolbars in Html-Programmen sind generell nicht verschiebbar.

 

Beispiel:

/* 2 Icons im Mainwindow erzeugen mit zusätzlichen Abstand

NR% = ADD_TOOLBAR(0,"@ebussave.gif|Speichern;;ebusnew.gif|Neu|Icon1",

                  MACRO.TOOLBAR)

 

Siehe auch:

REMOVE_TOOLBAR

EBUS_TOOLBAR_ADJUST_WINDOW

ADD_TOOLBAR_ICON

REMOVE_TOOLBAR_ICON

ENABLE_TOOLBAR_ICON

EBUS_DATA

EBUS_DATA$