<<

Inhaltsverzeichnis

Suchen

>>

 

ADD_TOOLBAR_ICON

 

 

Funktion

 

 

Syntax:

ADD_TOOLBAR_ICON(<Toolbarnummer>,<Parameter>)

 

<Toolbarnummer>

= <NUM-AUSDRUCK>

<Parameter>

= <STRING-AUSDRUCK>

 

 

Bedeutung:

ADD_TOOLBAR_ICON trägt ein zusätzliches Icon in die Iconleiste (Toolbar) <Toolbarnummer> ein.

 

ADD_TOOLBAR_ICON liefert folgende Ergebniswerte:

 

Ergebnis

Bedeutung

1

Die Funktion wurde erfolgreich ausgeführt.

-1

Es ist ein Laufzeitfehler aufgetreten.

-2

Die Toolbar <Toolbarnummer> existiert nicht.

 

Parameter:

Toolbarnummer

Identifizierungsnummer der Toolbar

 

Parameter

Legt die anzuzeigenden Bilder fest. Ein leerer Eintrag erzeugt einen zusätzlichen Abstand zum nächsten Bild.

 

<Parameter> 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.

 

 

Beispiel:

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

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

                  MACRO.TOOLBAR)

 

/* Weiteres Icon dazufügen

H% = ADD_TOOLBAR_ICON(NR%,"@ebusstop.gif|Anhalten|Stop")

IF H% < 0

THEN … Fehler …

ENDIF

 

 

Siehe auch:

ADD_TOOLBAR

REMOVE_TOOLBAR

REMOVE_TOOLBAR_ICON

ENABLE_TOOLBAR_ICON

EBUS_DATA$