4D Doc Center : EDIT ITEM

Home

4D v14.3

EDIT ITEM


EDIT ITEM ( {* ;} Objekt {; Eintrag} )

Parameter	Typ	Beschreibung
*	Operator	Mit : Objekt ist Objektname (String) Ohne : Objekt ist Tabelle oder Variable
Objekt	Formularobjekt	Mit : Objektname, Ohne : Tabelle oder Variable
Eintrag	Lange Ganzzahl	Nummer des Eintrags

Beschreibung

Der Befehl EDIT ITEM ermöglicht, den aktuellen Eintrag oder die in Eintrag angegebene Nummer im Array oder der Liste, definiert in Objekt, zu bearbeiten. Sie können also den gewählten Eintrag ändern, wobei ein eingegebenes Zeichen ganz den Inhalt des Eintrags ersetzt.

Mit dem optionalen Parameter * geben Sie an, dass Objekt ein Objektname ist. In diesem Fall übergeben Sie einen String. Ohne * geben Sie an, dass Objekt ein Feld oder eine Tabelle ist. In diesem Fall übergeben Sie eine Referenz auf eine Tabelle oder eine Variable.

EDIT ITEM gilt für folgende eingebbare Objekte:

Hierarchische Listen
Listboxen
Unterformulare (in diesem Fall lässt sich in Objekt nur ein Objektname des Unterformulars übergeben,
Listenformulare, die über die Befehle DISPLAY SELECTION oder MODIFY SELECTION angezeigt werden.

Bei Verwendung mit einem eingebbaren Objekt, das keine Liste ist, arbeitet EDIT ITEM genauso wie GOTO OBJECT.
Der Befehl führt nichts aus, wenn die Liste bzw. das Array leer oder ausgeblendet ist. Ist die Liste bzw. das Array nicht eingebbar, wählt der Befehl die angegebenen Einträge nur aus, ohne in den Bearbeitungsmodus zu wechseln.
Erlauben in Listboxen die Spalten keine Texteingabe (nur Eingabe über Optionsfelder oder DropDown-Listen), erhält das angegebene Element den Fokus.

Mit dem optionalen Parameter Eintrag setzen Sie die Position des Eintrags in der hierarchischen Liste bzw. die Zeilennummer in der Listbox, dem Listenformular und dem Unterformular im Modus mehrfache Auswahl, um in den Bearbeitungsmodus zu wechseln. Ohne diesen Parameter gilt der Befehl für den aktuellen Eintrag für Objekt. Gibt es keinen aktuellen Eintrag, wechselt der erste Eintrag von Objekt in den Bearbeitungsmodus.

Hinweise:

In Listen- und Unterformularen setzt EDIT ITEM das erste Feld einer angegebenen Zeile in den Bearbeitungsmodus, gemäß der Reihenfolge der Eingabe.
In Listboxen im hierarchischen Modus wird diese Ebene inkl. untergeordneter Ebenen automatisch aufgeklappt, wenn der anvisierte Eintrag zu einer zugeklappten hierarchischen Ebene gehört, so dass der Eintrag sichtbar wird.

Beispiel 1

Dieser Befehl eignet sich besonders zum Erstellen eines neuen Eintrags in einer hierarchischen Liste. Bei Aufruf des Befehls wird der zuletzt ein- oder angefügte Eintrag automatisch editierbar, also ohne Zutun des Benutzers.
Nachfolgender Code dient als Methode einer Schaltfläche, über die Sie in eine vorhandene Liste einen neuen Eintrag einfügen. Der Standardtext “Neuer_Eintrag” lässt sich automatisch verändern:

 vlUniqueRef:=vlUniqueRef+1

 INSERT IN LIST(hList;*;"Neuer_Eintrag";vlUniqueRef)

 EDIT ITEM(*;"MeineListe")

Beispiel 2

Wir gehen aus von zwei Spalten in einer Listbox mit den Variablennamen “Array1” und “Array2”.
Der folgende Code fügt einen neuen Eintrag in die beiden Arrays ein und setzt den neuen Eintrag von Array2 in den Bearbeitungsmodus:

 $vlRowNum:=Size of array(Array1)+1

 INSERT LISTBOX ROW(*;"MeineListBox";$vlRowNum)

 Array1{$vlRowNum}:="NeuerWert 1"

 Array2{$vlRowNum}:="NeuerWert 2"

 EDIT ITEM(Array2;$vlRowNum)