====== button ======
Mit dem Wert **button** für das [[Glossar#Attribut]] [[ctrltype]] kann man Schaltflächen in [[:gui_datasheets|DataSheets]] definieren. Dem Button kann eine Funktion zugewiesen werden, die beim Klick darauf, aufgerufen wird. Bei den Funktionen kann es sich um Primus interne Funktionen z.B. [[Menuebefehl]] oder um [[prmStartProcess|externe Programme]] oder [[AddIns]] handeln.

===== Zugehörige Attribute =====
Um eine Schaltfläche in einem Formular zu definieren müssen neben dem Attribut **ctrltype** noch weitere Attribute ausgefüllt sein. Prinzipiell können alle Attribute aus DataSheets verwendet werden.

^Attribut ^Pflicht ^Funktion^
| ''data''|Ja | Definiert das aufzurufende Programm und übergibt ggf. noch Parameter (Trennzeichen ''|'') an dieses|
| ''type''|Ja | __Muss__ **button** sein|
| ''height''|Nein | Darf nicht zu klein sein, sonst ist der Button nicht zu sehen und die Beschriftung wird nicht vollständig angezeigt|
| ''width''|:::| :::|
| ''labelposleft''|:::| Kann entfallen da der Labeltext immer auf der Schaltfläche liegt|
| ''visible''| :::| Gibt an ob der Befehl im Menü sichtbar ist|
| ''enabled''| :::| Wird nicht unterstützt|

===== Beispiel =====
<code xml><ButtonGetNr ctrltype="button" data="UnitecAddIn.unitecGetControlText_Click Number|Title" label="ERP-Nummer holen" type="Button" mode="W" left="393" top="170" width="150" height="22" /></code>

===== Aufruf von NamedCalls =====
Es ist möglich mit einem Button auch [[NamedCalls]] aufzurufen. Es ist jedoch zu beachten dass,
  *[[Liste aller Platzhalter|%FILENAME%]]
  *[[Liste aller Platzhalter|%FILEPATH%]]
sich immer auf die Auswahl in der [[userman:Dokumentenliste|Haupt-Dokumentenliste]] beziehen und nicht auf die Auswahl in der [[userman:Komponentenliste]]. Der Hintergrund ist, dass nicht feststellbar ist, ob der Button im [[GUI_Document_DataSheet|DataSheet]] oder im [[SubDataSheet]] gedrückt wurde.

==== Beispiel ====
<code xml>
<ButtonClickDemo ctrltype="button" data="prmExecuteNamedCalls |DraftExport" label="ButtonClickDemo" type="Text" mode="W" left="382" top="713" width="100" height="22" />
</code>
Wichtig ist hier das Leerzeichen hinter [[prmExecuteNamedCalls]].
===== Rückgabewert =====
{{tag>klaerungsbedarf}}
\\ 

{{tag>gui datasheet ctrltype}}