ButtonEdit

<< Click to Display Table of Contents >>

Navigation:  Steuerelemente > Standard Steuerelemente >

ButtonEdit

Ein Eingabefeld mit einer Schaltfläche, um gespeicherte Dateien auszuwählen. Per Klick auf den Button öffnet sich ein Dateiauswahlfenster, in dem der Benutzer eine oder mehrere Dateien auswählen kann. Anschließend wird der Pfad zur Datei in dem Eingabefeld angezeigt, den der Benutzer nicht bearbeiten kann. Das Steuerelement kann unsichtbar oder deaktiviert werden, sodass ein Anklicken nicht mehr möglich ist. Außerdem unterstützt es das Senden von Signalen bei verschiedenen Events.

 

Steuerelement auf der Parametermaske

Steuerelement zur Laufzeit

buttonedit_zoom50

runtime1_zoom50

 

Eigenschaft

Erläuterung der Einstellungsoptionen

Steuerelemente mit dieser Eigenschaft

Anchors

Definiert, welche der vier Ränder der Komponente (links, oben, rechts, unten) verankert werden sollen.

 

Je nach Einstellung kann die Komponente beim Vergrößern des Fensters in eine bestimmte Richtung mitziehen und der Abstand zum Rand bleibt gleich. Sind mehrere Anker gesetzt, wird die Komponente dementsprechend gestreckt.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

ClearOnCopy

Bei aktiviertem Loop-Modus wird der Datenwert der Komponente nach dem Speichern von Daten gelöscht bzw. auf den Anfangswert zurückgesetzt (z.B. nach Klick auf "Weiter")

ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Sprachkit

DataQuery

Defniert eine frei gestaltbare SQL-Datenabfrage zur Anzeige von Daten. Die Datenmenge kann auf Änderungen von Parametern in anderen Steuerelementen reagieren.

 

Je nach Steuerelement muss die Abfrage die in DataCaptionField und DataValueField hinterlegten Datenfelder als Attribute enthalten; dies ist daran zu erkennen, dass die Eigenschaft im Steuerelement vorhanden ist.

 

Über das Signalsystem lassen sich Abhängigkeiten von Eingaben oder Auswahlen in anderen Steuerelementen steuern, um Änderungszustände von Daten in der Maske anzuzeigen.

 

 

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

DataQuerySignalBehavior

Auswahl, unter welchen Umständen die SQL-Abfrage die Daten aus der Datenbank aktualisiert, wenn gleichzeitig ein treffendes Signal vorliegt.

 

 

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

DataValueField

Definiert den Namen des Datenfeldes, welches den Datenwert im Steuerelement darstellt, wenn in DataQuery eine SQL-Datenabfrage zugewiesen wurde.

 

Der Rückgabewert der Datenmenge muss dem Datentype der Zielkomponente entsprechen oder sich dahin gehend konvertieren lassen.

 

Im Gegensatz dazu enthält DataCaptionField den Anzeigewert.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

DefaultExt

Auswahl einer Standardendung, die automatisch angehängt wird, wenn der Benutzer keine Endung angibt.

ButtonEdit

Delimiter

Einige Steuerelemente bieten die Möglichkeit, mehrere selektierte Datenwerte zurückzugeben. Um im SQL-Code die Auflösung der einzelnen Werte zu ermöglichen, kann der Delimiter als Anhaltspunkt zur Trennung verwendet werden. Ist nur ein Wert ausgewählt, bleiben die Delimiter trotzdem aktiv.

 

Diese Einstellung ist unter Umständen relevant in Kombination mit Suffix, Prefix und RawMode.

 

 

ButtonEdit, CheckCombo, Checklist, DB-Checklist, DB-Liste, Grid, Liste, Memo

Enabled

Aktiviert oder deaktiviert die Komponente für die Verwendung durch den Benutzer. Das Element wird dabei in den meisten Fällen farblich leicht ausschattiert. Auch wenn eine Komponente inaktiv ist, werden die Datenwerte an die Parametersteuerung zurück geliefert.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

Filter

Zeigt nur Dateien mit der eingegebenen Endung im Fenster zur Auswahl von Dateien an, z.B. *.PDF oder *.DWG.

 

Die Eingabe muss wie folgt erfolgen: Name Format1|Endung Format 1|Name Format 2|...

ButtonEdit

FilterIndex

Auswahl, welcher Filter bei einer Dateiauswahl in einem ButtonEdit als erstes verwendet wird.

ButtonEdit

Font

Bestimmt Farbe, Schriftart, Schriftschnitt und Schriftgröße des Textes im Steuerelement in einem eigenen Dialog.

ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Beschriftung (Label), Liste, Memo, Kalender, Radio, Sprachkit

Height

Höhe der Komponente in Pixel.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

Hint

Optionaler individueller Hilfetext, der angezeigt wird, wenn sich der Mauszeiger über der Komponente befindet.

ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image

InitialDir

Bestimmt, welcher Ordner bei einem Dialog zur Auswahl von Dateien initial angezeigt wird.

ButtonEdit

Left

X-Position der Komponente auf dem Formular in Pixel.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

Mode

Auswahl, ob ein Ordner oder eine Datei im Dateiauswahl-Fenster ausgewählt werden kann.

ButtonEdit

MultiSelect

Aktiviert die Möglichkeit, mehrere Datenobjekte im Auswahlfenster zu selektieren.

 

Der Benutzer kann mit der Shift- und Strg-Taste mehrere Einträge markieren, klickt er jedoch ohne eine dieser Tasten auf einen Eintrag, werden alle zuvor ausgewählten Einträge zurückgesetzt. Bei deaktivierter Option bleiben die Einträge solange markiert, bis der Benutzer die Markierung durch einen zweiten Klick auf den Eintrag aufhebt.

ButtonEdit, DB-Liste, Grid, Liste

Name

Beliebige eindeutige Bezeichnung der Komponente.

 

Die Bezeichnung wird zur Navigation im DataNAUT Designer verwendet. Zudem wird die Bezeichnung zur Laufzeit herangezogen, wenn eine Meldung zum Steuerelement angezeigt wird, beispielsweise weil der Benutzer keinen Eingabewert hinterlassen hat.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

Prefix

Zeichen oder Zeichenkette welche bei der Rückgabe von PARAMETER an die Programmsteuerung kombiniert wird. Der Prefix wird dem eigentlichen Rückgabewert vorangestellt.

 

Diese Einstellung ist unter Umständen relevant in Kombination mit Suffix, Delimiter und RawMode.

 

 

ButtonEdit, CheckCombo, Checklist, DB-Checklist, DB-Liste, Grid, Liste, Memo

RawMode

Im RAW-Modus (raw engl. = roh) werden Daten als nativer Rohtext aus dem Steuerelement mit allen Zeilenumbrüchen und Formatierungen an den zugewiesenen Parameter übergeben. In diesem Fall kommen die Vorgaben in Prefix, Suffix und Delimiter nicht zum Einsatz.

 

Der aktivierte RAW-Modus eignet sich besonders, wenn aus einem MEMO-Eingabefeld der Text 1:1 aus der Ansicht übernommen werden soll.

 

 

ButtonEdit, CheckCombo, Checklist, DB-Checklist, Grid, Liste, Memo

SignalOnClick

Bestimmt, ob beim Klick auf ein Datenobjekt im Auswahldialog des Steuerelements oder beim Klick auf das Steuerelement selbst ein Signal auf den in SignalSendChannels angegebenen Kanälen gesendet wird. Die Eigenschaft SignalSendEnabled muss dazu ebenfalls aktiv gesetzt sein.

Button, ButtonEdit, Checkbox, DB-Liste, DB-Radio, Liste, Kalender, Radio

SignalOnEnter

Bestimmt, ob ein Signal auf den unter SignalSendChannels angegebenen Kanälen gesendet wird, wenn das betreffende Steuerelement den Fokus erhält, zum Beispiel in dem es angeklickt wird. Die Eigenschaft SignalSendEnabled muss dazu ebenfalls aktiv gesetzt sein.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar

SignalOnExit

Bestimmt, ob ein Signal auf den unter SignalSendChannels angegebenen Kanälen gesendet wird, wenn das betreffende Steuerelement den Fokus verliert. Die Eigenschaft SignalSendEnabled muss dazu ebenfalls aktiv gesetzt sein.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar

SignalReceiveChannels

Enthält eine durch Kommata separierte Liste von numerisch benannten Kanälen, auf denen das Steuerelement Signale empfängt, sofern die Eigenschaft SignalReceiveEnabled aktiv ist.

 

 

ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Info-ProgressBar, Info-Shape

SignalReceiveEnabled

Schaltet das Empfangen von Signalen von anderen Steuerelemente auf den unter SignalSendChannels angegebenen Kanälen ein oder aus.

ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Info-ProgressBar, Info-Shape

SignalSendChannels

Enthält eine durch Kommata separierte Liste von numerisch benannten Kanälen, auf denen das Steuerelement Signale sendet, sofern die Eigenschaft SignalSendEnabled aktiv ist.

 

 

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar

SignalSendEnabled

Schaltet das Senden von Signalen an andere Steuerelemente auf den unter SignalSendChannels angegebenen Kanälen ein oder aus.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar

Suffix

Zeichen oder Zeichenkette welche bei der Rückgabe von PARAMETER an die Programmsteuerung kombiniert wird. Der Suffix wird dem eigentlichen Rückgabewert abschließend angefügt.

 

Diese Einstellung ist unter Umständen relevant in Kombination mit Prefix, Delimiter und RawMode.

 

 

ButtonEdit, CheckCombo, Checklist, DB-Checklist, DB-Liste, Grid, Liste, Memo

TabOrder

Gibt die Position in der Reihenfolge an, in der das betreffende Steuerelement aktiviert werden soll und den Fokus erhält, wenn der Benutzer auf einem anderen Element die TAB-Taste drückt. Das Steuerelement mit der kleinsten Zahl wird zuerst aktiviert. Die Zählweise ist 0-basiert.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Sprachkit, Info-ProgressBar

Task

Bei Aktivierung dieser Option ist die Eingabe oder Auswahl von Daten in dem betreffenden Steuerelement für den Benutzer Pflicht. In Steuerelementen mit Mehrfachauswahl muss dann mindestens ein Datenobjekt gewählt werden.

 

Wird keine Eingabe oder Auswahl vorgenommen, wird eine entsprechende Fehlermeldung mit Verweis auf den unter Name angegebenen Namen der Komponente angezeigt. Das Verlassen des Steuerelements oder der Maske ist dann einstellungsbedingt nur durch Abbruch der Maske möglich.

ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, Eingabe, Grid, Liste, Memo

Top

Y-Position der Komponente auf dem Formular in Pixel.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

Visible

Gibt an, ob die Komponente auf dem Formular für den Benutzer sichtbar ist oder nicht.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

Width

Breite der Komponente in Pixel.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape