Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- primus:button [2022/08/05 12:39] – gelöscht - Externe Bearbeitung (Unknown date) 127.0.0.1
+++ primus:button [2024/03/12 13:13] (aktuell) – NamedCalls ergänzt mgras
@@ Zeile 1: / Zeile 1: @@
+====== 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}}