4D v14.3

EDIT ITEM

Home

 
4D v14.3
EDIT ITEM

EDIT ITEM 


 

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

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.

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")

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)

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Eingabekontrolle
Nummer: 870

 
GESCHICHTE 

Erstellt: 4D 2004

 
SIEHE AUCH 

GOTO OBJECT
INSERT IN LIST
SET LIST ITEM

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)

Geerbt von : EDIT ITEM ( 4D v11 SQL Release 6)