Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- primus:gui_document_datasheet [2022/08/05 12:39] – gelöscht - Externe Bearbeitung (Unknown date) 127.0.0.1
+++ primus:gui_document_datasheet [2023/08/08 11:37] (aktuell) – mgras
@@ Zeile 1: / Zeile 1: @@
+====== GUI_Document_DataSheet ======
+Der [[GUI_Data_Sheets|Abschnitt]] **GUI_Document_DataSheet**, ist das zentrale [[Datenblatt]] in dem die [[Datenfelder]] zu einem in der [[Dokumentenliste]] markierten Dokument angzeigt und, außer im [[Primus-Viewer]], auch geändert werden können. Das Tag //GUI_Document_DataSheet// kann folgende Attribute haben:
+^Attribut ^Funktion^
+|bgcolor|[[Farbdefinition|Hintergrundfarbe]] des Dialogs in RGB Werten|
+|height|Gibt die Höhe des Datenblatts in Pixel an.|
+|width|Gibt die Breite des Datenblatts in [[primus:glossar|Pixel]] an|
+===== Datenblatteinträge =====
+Die einzelnen Datenblatteinträge werden jeweils als einzelnes [[Glossar#Leer-Tag]] aufgebaut. Der [[Glossar#Tag-Name]] hat keine besondere Bedeutung, er __muss__ aber innerhalb des Abschnitts eindeutig sein. Der Übersichtlichkeit wegen sollte der Tag-Name aber einen Bezug zu der dargestellten Information haben. Die Reihenfolge der Tags im Abschnitt ist für die Reihenfolge der Bearbeitung von Bedeutung wenn man mit Tabulator durch das Formular springt, die Anordnung der Elemente eines Formulars wird jedoch durch entsprechende Attribute gesteuert. Ein Datenblatteintrag kann folgende Attribute haben:
+^Attribut ^Pflicht ^Wert ^Funktion^
+| [[callafterchange]]| |Ruft nach direkt erfolgter Änderung ein Programm auf|
+|[[ctrltype]] |  **X**  | |Definiert den Elementtyp|
+|[[data]]| | |Abhängig vom **ctrltype**, ein [[xml-datenfeld]] oder ein Parameter für das Element|
+|enabled| |''0'' / ''**1**'' |Definiert ob ein Element aktiv ist oder nicht (siehe auch [[Bedingung]])|
+|height |  **X**  | ''<ZAHL>'' |Höhe des Datenfelds in Pixel|
+|label | |[[Elementtext]] |Beschriftung des Elements, die Anzeigeposition ist vom **ctrltype** abhängig|
+| labelcolor| |''<RGB-Anteile>''| Definiert die [[Farbdefinition|Schriftfarbe]] des Labels Default ist schwarz, weiß wäre "255,255,255"|
+|labelposleft | | ''<ZAHL>''|Postion in Pixel, des Labeltextes vom linken Rand des Formulars (ctrltype abhängig)|
+|left | | ''<ZAHL>''|Abstand des in Pixel vom linken Rand des Formulars|
+| maxlength| | ''<ZAHL>''| Limitiert die maximal mögliche Eingabelänge|
+| mode| | ''R'' / ''**W**'' |Steuert ob das Element beschreibbar (''W'') ist oder nicht (''R'')|
+| mode_singlesel| | :::| dito bei Einzelauswahl|
+|multisel | |''**0**'' / ''1'' |Gibt an ob das Datenfeld auch bei einer Mehrfachauswahl in der Dokumentenliste aktiv ist.|
+|top |  **X**  | ''<ZAHL>''|Positon des Elements in Pixel vom oberen Rand des Formulars|
+|[[tooltip]]| |[[Elementtext]]|Definiert den Text der als Tooltip angezeigt wird, wenn man mit der Maus auf das Element deutet|
+|[[type]] |  **X**  | |Elementtyp, der Wert hängt mit [[ctrltype]] zusammen und muss entsprechend gewählt werden|
+|visible | |''0'' / ''**1**'' |Steuert ob ein Element sichtbar oder unsichtbar ist (siehe auch [[Bedingung]])|
+|width |  **X**  | ''<ZAHL>''|Breite des Elements in Pixel|
+Defaultwerte in **fett**.
+==== Datenfelder ====
+Ein normales **Datenfeld** enthält folgende Attribute:
+^Attribut ^Wert^
+^Pflichtattribute^^
+|[[ctrltype]] |''textbox''|
+|data|''[[xml-datenfeld]]'' oder ''[[primusvariable]]''|
+|height|''**20**''|
+|left|''**130**''|
+|top| in ''**22**'' Pixelschritten steigend |
+|width|''**255**''|
+^Optionale Attribute^^
+|label|''[[Elementtext]]''|
+|labelposleft|''**15**''|
+|mode|''**R**''|
+|multisel|''**1**''|
+|tooltip|''[[Elementtext]]''|
+| [[callafterchange]]| Externes Programm|
+=== Beispiel ===
+<code xml>
+<Title ctrltype="textbox" data="Title" label="$Primus.SHEET_TITLE" type="Text" mode="W" left="130" top="193" width="255" height="20" labelposleft="15" multisel="1" />
+<-- Aufruf eines externen Programms bei Änderung des Feldwertes -->
+<StkVP ctrltype="textbox" data="StkVP" label="VP/Stk. €" type="Text" callafterchange="CustomerAddIn.calcStkVP" mode="W" left="88" top="220" width="61" height="20" labelposleft="15" multisel="1" />
+</code>
+{{tag>GUI DataSheet}}