To set an icon in the header, a rule

sub RegisterButton_xxx method

has to be defined.

All RegisterButton-Rules will be executed in alphanumeric sequence by Trade2.

In this rule the button is set using rule “ButAddButton”:

“sub ButAddButton( in ArgBut field, in ArgLoc text, in ArgIco text, in ArgCapt text, in ArgHint text ) static”
meaning of arguments see inline of rule.

Example:

ButAddButton( GUIDOC, MnuButTopGlobal, "but_hlp.png", 'Online &Help', 'Show Online Transaction Documentation' )

For positioning of the icon (“ArgLoc”) the following options are available:

The values of a BitButton determine the visual appearance of the button.

In order that colour settings can be set centrally, use symbolic colour names defined in TDSKIN.ini instead of discrete colour definitions.

Standard settings are defined as follows:

Text with Icon:

SIZE 70 22
PAD 4
I pbt_redo.png VC HL 16 16
ID pbt_redo.png BW ALPHA 0.4
FONT Arial 8
SP 5
FR ButtonFrameColor 1
FRF ButtonFrameColorFocus 1
FRH ButtonFrameColorHover 1
FRP ButtonFrameColorPushed 1
FRD ButtonFrameColorDisabled 1
F BitButtonTextColor
FF BitButtonTextColorFocus
FH BitButtonTextColorHover
FP BitButtonTextColorPushed
FD BitButtonTextColorDisabled
B PanelIconBack
BF PanelIconBackFocus
BH PanelIconBackHover
BP PanelIconBackPushed
BD PanelIconBackDisabled
T $caption

Only Text:

SIZE 70 22
PAD 4
FONT Arial 8
SP 5
FR ButtonFrameColor 1
FRF ButtonFrameColorFocus 1
FRH ButtonFrameColorHover 1
FRP ButtonFrameColorPushed 1
FRD ButtonFrameColorDisabled 1
F BitButtonTextColor
FF BitButtonTextColorFocus
FH BitButtonTextColorHover
FP BitButtonTextColorPushed
FD BitButtonTextColorDisabled
B PanelIconBack
BF PanelIconBackFocus
BH PanelIconBackHover
BP PanelIconBackPushed
BD PanelIconBackDisabled
T $caption VC HC

Only Icon (e.g. magnifying glass in GETs)

SIZE 22 22
I seabut.png VC HC 16 16
ID seabut.png BW ALPHA 0.4
B PanelIconBack
BF PanelIconBackFocus
BH PanelIconBackHover
BP PanelIconBackPushed
BD PanelIconBackDisabled

The icons listed in the following table stored with an image file.

• Image files with Prefix “but_” are intended for usage in the header.
• Image files with Prefix “gbt_” are intended for usage in grid line.
• Image files with Prefix “pbt_” are intended for usage on buttons.

The respective suffix defines the meaning.

When using, the same caption an the same shortcut should be used whenever possible.

The hints may differ, however the real meaning must not be different.

Example: using the Icon but_add.png for 'change entry' will be wrong.
Using the icon for 'adding releaser' will be correct.

A detailed Description, which icon is used for what, can be found in the User Documentation under General Function Icons .

Icon	File (diff. icon)	Caption English	Shortcut	Hint English (default)	Caption German	Shortcut	Hint German (default)
	but_add.png gbt_add.png pbt_add.png	Add New	N	Create a new entry	Neu	N	Hinzufügen eines Eintrages
	but_ass.png	Assign	none	Assign this entry to another user	Zuordnen	none	Diesen Eintrag einem anderen Benutzer zuordnen
	but_assgrp.png	Assign group	none	Assign this entry to another user group	Gruppe zuordnen	none	Diesen Eintrag einer anderen Benutzergruppe zuordnen
	pbt_att.png	Add Memo	none	Create a new attachment	Memo erfassen	none	Erfassen eines neuen Attachments
	but_bck.png pbt_bck.png	Back	none	Return to calling transaction	Zurück	none	Rückkehr zur aufrufenden Transaktion
	but_blk.png	Block	none	Block the selected user	Sperren	none	Blockieren des ausgewählten Benutzers
	but_brk.png pbt_brk.png ()	Break	B	Pause the processing for this entry	Unterbrechen	B	Unterbrechen der aktuellen Erfassung
	pbt_can.png	-	none	-	-	none	-
	but_cfgsav.png	Save Settings	none	Save the currently specified settings in configuration <file>	Speichern	none	Speichern der aktuellen Einstellungen in <file>
	but_chb.png	Exit Version	none	Leave the Version control	Ende Versionsanzeige	none	Beenden der Versionsanzeige
	but_chg.png	Change	E	Modify the selected entry	Ändern	Ä	Ändern des ausgewählten Eintrages
	but_chk.png pbt_chk.png	Check	C	Check the current data for missing or erroneous fields	Prüfen	Ü	Prüfen der aktuellen Erfassung auf fehlende oder falsche Eingaben
	but_clc.png	Close Contract	C	Close the corresponding contract	Kontrakt schliessen	K	Schliessen des zugehörigen Kontraktes
	pbt_clipfilled.png	Attachments	none	Show Attachments	Anhänge	none	Zeige Anhänge
	but_clr.png pbt_clr.png	Reset	R	Clear the actual selection fields	Leeren	R	Zurücksetzen der aktuellen Selektion
	but_con.png	Connect	none	Connect this entry to a contract	Verbinden	none	Diesen Eintrag mit einem Kontrakt verknüpfen
	but_config.png gbt_config.png pbt_config.png	Configuration	none	Maintain the configuration settings	Einstellungen	none	Bearbeiten der Konfigurationseinstellungen
	but_cpc.png pbt_cpc.png	Copy PC	none	Copy the file to the PC	Kopie PC	none	Kopiere die Datei auf den PC
	but_cti.png but_cti_green.png but_cti_red.png	Show Info	none	Show all structured information	Zeige Info	none	Zeige alle strukturierten Informationen
	but_del.png pbt_del.png	Delete	L	Delete the current entry	Löschen	L	Löschen des aktuellen Eintrages
	but_det.png gbt_det.png () pbt_det.png	Details	none	Show more details of this entry	Details	none	Zeige weitere Details dieses Eintrags
	but_detach.png	Detach	none	Detach the connection of the partial message	Trennen	none	Löst die Verbindung der Teilnachricht
	but_dia.png	Diaries	D	Maintain diary entries of current contract	Termine	T	Bearbeiten der Termine des aktuellen Kontraktes
	but_diaedt.png	Edit Diaries	none		Termine bearbeiten	none
	but_diff.png pbt_diff.png	Show difference	none	Show difference between old and new entries	Zeige Differenz	none	Zeige Differenz zwischen altem und neuem Eintrag
	but_doc.png gbt_doc.png pbt_doc.png	Document	none	none	Dokument	none	none
	but_don.png pbt_don.png	Done	none	Handled	Fertig	none	Hantiert
	but_dpl.png pbt_dpl.png	Duplicate	none	Creates a copy of selected entry	Duplizieren	none	Erzeugt eine Kopie des ausgewählten Eintrags
	but_dsp.png pbt_dsp.png	Display	I	Show details for selected entry	Anzeigen	I	Details des aktuellen Satzes anzeigen
	but_dwn.png pbt_dwn.png	Down	none	Move selected row down	Runter	none	Ausgewählte Zeile runterschieben
	gbt_edt.png pbt_edt.png pbt_edt_green.png pbt_edt_red.png	Edit	none	Edit of selected item	Ändern	none	Ändern des ausgewählten Eintrags
	gbt_efa.png	-	none	-	-	none	-
	gbt_efh.png	-	none	-	-	none	-
	but_err.png pbt_err.png	Error	none	Set Service Error	Error	none	Setze Service Fehler
	but_ety.png	Change Entity	E	Change the current entity	Entity Wechseln	E	Wechseln in eine andere Entity
	but_etyshw.png	Assign Entity		Assign available entities of user	Entity zuweisen		Verfügbare Entities einem Benutzer zuweisen
	but_exi.png pbt_exi.png	Exit	X	Leave the current transaction	Ende	E	Beenden der aktuellen Transaktion
	but_exp.png	Export	none	Export the selected file	Export	none	Exportieren der ausgewählten Datei
	but_expall.png	Export All	none	Export all existing import files	Alle Exportieren	none	Exportiere alle Dateien
	but_fil.png	Save	none	Save a report definiton under new name	Speichern	none	Speichern einer Reportdefiniton
	but_filas.png	Save as	none	Save a report definition under new name	Speichern unter	none	Speichern einer Reportdefiniton unter neuem Namen
	gbt_fill.png	Fill	none	Fill line	Fülle	none	Fülle Zeile
	but_fol.png	File	F	Show detailed contract of selected entry	Akte	K	Kontrakt des selektierten Eintrages ansehen
	gbt_hea.png	-	none	-	-	none	-
	but_hlp.png	Online Help	H	Show the online transaction documentation	Online Hilfe	H	Anzeigen der Online Transaktionsdokumentation
	but_hom.png	Home	O	Go back to the start page	Home	O	Zurück zur Startseite
	but_imp.png	Import	none	Import the selected file	Import	none	Importieren der ausgewählten Datei
	but_impall.png	Import All	none	Import all existing files	Alle Importieren	none	Importiere alle Dateien
	but_inc.png	Incoming Message	none	Show incoming message	Eingehende Nachricht	none	Einkommende Nachricht anzeigen
	but_inf.png gbt_inf.png () pbt_inf.png	Infotext	none	Show infomation text for this entry	Infotext	none	Zeige Informationstext zu diesem Eintrag
	but_info.png	Access Info	I	Direct start of an Info transaction	Info Transaktion starten	I	Direkter Start einer Info-Transaktion
	but_loa.png pbt_loa.png	Load	none	Load data from selected file into transaction	Laden	none	Lade Daten aus der gewählten Datei in die Transaktion
	but_log.png gbt_log.png pbt_log.png	Log	G	Show created log file	Log	G	Aktuelles Log anzeigen
	but_memnew.png	Add Memo	none	Create a new memo	Memo erfassen	none	Erfassen eines neuen Attachments
	but_modred.png	Reduced Edit	none	Edit user with reduced rights	Reduzierte Änderung	none	Benutzerpflege mit eingeschränkten Rechten
	but_mrg.png	Group	none	Join partial messages	Gruppe	none	Teilnachrichten zusammenführen
	but_nxt.png pbt_nxt.png	Next	none	Next entry	Nächster	none	Nächster Eintrag
	but_ovw.png gbt_ovw.png	Overview	none	Overview of Entries	Übersicht	none	Übersicht der Einträge
	but_pdf.png	Make PDF	P	Creates a PDF of the file	Erz. PDF	P	Erzeugt ein PDF aus der Datei
	gbt_pln.png	-	none	-	-	none	-
	but_prt.png pbt_prt.png	Print	P	Print list	Drucken	D	Ausdrucken der Liste
	but_prv.png	Previous	none	Previous Entry	Vorheriger	none	Vorheriger Eintrag
	but_raw.png	Raw Message	none	Show the message in technical format\n Without internal editing	Rohnachricht	none	Anzeigen der Nachricht im technischen Format\n Ohne interne Aufbereitung
	but_redo.png pbt_redo.png	Redo	none	Set service redo	Redo	none	Setze Service Nochmal
	but_rej.png pbt_rej.png	Delete	T	Delete the current entry	Löschen	Ö	Ausgewählten Eintrag löschen
	but_don.png pbt_rel.png	Release	R	Sign/Release the current entry	Freigabe	R	Unterschreiben des aktuellen Eintrages
	but_redo.png pbt_rep.png	Repair	A	Send the selected item to correction	Korrektur	K	Ausgewählten Eintrag auf Korrektur stellen
	but_rfr.png pbt_rfr.png	Refresh	none	Refresh entries	Aktualisieren	none	Einträge aktualisieren
	but_rmv.png	Remove	none	Remove the current entry	Löschen	L	Löschen des aktuellen Eintrages
	but_rou.png pbt_rou.png	Routing	none	Change assignment	Routen	none	Nachricht an eine andere Entity routen
	but_rouety.png	Routing	none	Reroute message to another entity	Routen	none	Zuordnung ändern
	but_rpt.png gbt_rpt.png ()	Report	R	Create list of entries	Liste	R	Erstelle Liste der Einträge
	but_run.png gbt_run.png pbt_run.png	Process	none	Run processing	Verarbeite	none	Starte Verarbeitung
	but_sav.png pbt_sav.png	Save	S	Store the current transaction	Speichern	S	Speichern der aktuellen Transaktion
	but_sea.png pbt_sea.png ()	Search	S	Search fitting entries	Suchen	S	Suche passende Einträge
	but_sel.png pbt_sel.png	Check selected	none	Check selected entries	Markiere Auswahl	none	Markiere ausgewählte Einträge
	but_selall.png pbt_selall.png	Check all	none	Check all entries	Markiere Alle	none	Markiere alle Einträge
	but_sem.png	Search	S	Search Messages of this entry	Suche	S	Suche Nachrichten dieses Eintrags
	but_shut.png	Shutdown	none	Send Exit notify message	Shutdown	none	Sende Exit Notify Nachricht
	but_shw.png gbt_shw.png () pbt_shw.png	Display	none	Show	Anzeigen	none	Anzeigen
	pbt_sign.png	-	none	-	-	none	-
	but_skip.png pbt_skip.png	Skip	none	Set Service Skip	Skip	none	Setze Service Skip
	but_snd.png pbt_snd.png	Send	none	Send Notify Message	Senden	none	Sende Benachrichtigung
	gbt_spa.png	Split	none	Split by amount	Teilen	none	Teilen nach Betrag
	gbt_spt.png	Split	none	Split by date	Teilen	none	Teilen nach Datum
	but_srv.png	Set date for time travel	none	Set date for time travel	Datum für Zeitreise setzen	none	Datum für Zeitreise setzen
	but_stat.png	Status C	none	Set Status of session to Canceled	Status C	none	Setze Status der Session auf abgebrochen
	but_stp.png gbt_stp.png () pbt_stp.png	Stop	none	Stops processing of current manager	Stoppen	none	Stoppt die Verarbeitung des aktuellen Managers
	but_strt.png	Start	none	Start processing of current manager	Start	none	Starte Verarbeitung durch den Manager
	but_tak.png gbt_tak.png pbt_tak.png	Take	none	Use selected entry for processing	Nehmen	none	Gewählten Eintrag zur Bearbeitung aufgreifen
	but_target.png	Launch transaction	none	Direct start of a transaction	Transaktion starten	none	Direkter Start einer Transaktion
	but_toolbox.png	Toolbox	none	Test & Demo Toolbox	Werkzeuge	none	Test & Demo Werkzeuge
	but_tst.png	Test	none	Test processing without changing data	Test	none	Teste Verarbeitung ohne Änderung der Daten
	but_unblk.png	Unblock	none	Unblock selected user	Entsperren	none	Ausgewählte Benutzer entsperren
	but_undel.png	Undelete	none	Restore entry from recycle bin	Reaktivieren	none	Eintrag aus Papierkorb zurückholen
	but_unknown.png	nur temporär verwenden, solange das richtige Icon noch unklar ist
	but_unmapped.png but_unmapped_green.png but_unmapped_red.png pbt_unmapped.png	Unmapped	none	Show unmapped fields of incoming message	Unmapped	none	Zeige nicht übernommene Felder der Eingangsnachricht
	but_unsel.png pbt_unsel.png	Uncheck select	none	Remove check from selected entries	Markierung aufheben Auswahl	none	Entferne Markierung der ausgewählten Einträge
	but_unselall.png pbt_unselall.png	Uncheck all	none	Remove check from all entries	Markierung aufheben alle	none	Entferne Markierung aller Einträge
	but_up.png pbt_up.png	Up	none	Move selected line up	Hoch	none	Ausgewählte Zeile hochschieben
	but_usf.png	User Filter	U	Maintain default filter	Benutzer Filter	U	Bearbeiten des Default-Filters
	but_ver.png	Version	V	Show version control	Versionsanzeige	V	Anzeige Versionskontrolle
	but_verhis.png	History	none	Show history of changes of current entry	Historie	none	Anzeige der Historie der Änderungen des aktuellen Eintrags
	but_vlh.png	Next	none	Next version	Nächste	none	Nächste Version
	but_vlo.png pbt_vlo.png	Previous	none	Previous version	Vorherige	none	Vorherige Version
	but_wrn.png but_wrn_green.png but_wrn_red.png	Warnings	W	Show warnings of current transaction	Warnungen	W	Zeige Warnungen der aktuellen Transaktion

If icons are not shown in business transactions despite being called, the reason might be a missing business sector in the ATP entry of the transaction.

If hints for an icon are not shown, check module properties of the transaction. There “Show hints” must be checked.