4D Doc Center : LISTBOX DUPLICATE COLUMN

Home

4D v14.3

LISTBOX DUPLICATE COLUMN


LISTBOX DUPLICATE COLUMN ( {* ;} Objekt ; SpaltePos ; SpalteName ; SpalteVariable ; KopfName ; KopfVariable {; FußName ; FußVariable} )

Parameter	Typ	Beschreibung
*	Operator	Mit : Objekt ist Objektname (String) Ohne : Objekt ist eine Variable
Objekt	Formularobjekt	Objektname (mit ) oder Variable (ohne ) der zu duplizierenden Spalte
SpaltePos	Lange Ganzzahl	Position der neu duplizierten Spalte
SpalteName	String	Name der neuen Spalte
SpalteVariable	Array, Feld, Variable	Name der Variable Array Spalte oder Feld oder Variable
KopfName	String	Objektname Spaltenkopfteil
KopfVariable	Variable Ganzzahl	Variable Spaltenkopfteil
FußName	String	Objektname Spaltenfußteil
FußVariable	Variable	Variable Spaltenfußteil

Beschreibung

Der Befehl LISTBOX DUPLICATE COLUMN dupliziert per Programmierung die mit den Parametern Objekt und * definierte Spalte im Formular in der Ausführung (Anwendungsmodus). Das Originalformular, das im Designmodus erstellt wurde, wird nicht verändert.

Hinweis: Diese Funktionalität war bereits im Designmodus von 4D vorhanden, und zwar im Kontextmenü des Formulareditors über den Befehl Spalte duplizieren.

Standardmäßig werden alle Stiloptionen der Ausgangsspalte (Größe, Farbe, Formate, etc.), die über die Eigenschaftenliste oder Befehle zur Objektverwaltung (OBJECT SET COLOR, etc.) gesetzt wurden, auch auf die Kopie angewendet. Auch die Objektmethode und die Einstellungen der Formularereignisse werden duplizieren. Die Datenquelle (Listbox vom Typ Array oder Auswahl) sowie Stil und Farb-Arrays werden dagegen nicht dupliziert. Sie müssen selbst dafür sorgen, dass diese nach dem Duplizieren jeder neuen Spalte zugewiesen wird.

Die Parameter Objekt und * bestimmen die Spalte zum Duplizieren. Mit dem optionalen Parameter * ist Objekt ein Spaltenname (String). Ohne * ist Objekt eine Spaltenvariable. In diesem Fall übergeben Sie eine Variablenreferenz anstelle eines String.

Hinweis: Dieser Befehl führt nichts aus, wenn er auf die erste Spalte einer Listbox im hierarchischen Modus angewandt wird.

Die duplizierte Spalte wird genau vor die Spalte gesetzt, die im Parameter SpaltePosition angegeben ist. Ist SpaltePosition größer als die Gesamtanzahl der Spalten, wird sie nach der letzten Spalte gesetzt.

In den Parametern SpalteName und SpalteVariable übergeben Sie den Objektnamen und die Variable der neuen duplizierten Spalte.

Für Listboxen vom Typ Array entspricht der Variablenname dem Namen des Array, dessen Inhalt in der Spalte angezeigt wird.
Für Listboxen vom Typ Auswahl können Sie im Parameter SpalteVariable ein Feld oder eine Variable übergeben. Dann ist der Inhalt der Spalte der Wert dieses Feldes oder der Variable, der für jeden Datensatz in der Auswahl für die Listbox gewertet wird. Dafür muss die Eigenschaft "Datenquelle" der Listbox auf "aktuelle Auswahl" oder "temporäre Auswahl" gesetzt sein.

Beachten Sie, dass die Datenquelle der ursprünglichen Spalten nicht dupliziert wird: Sie müssen für die neue duplizierte Spalte ein Quellvariable, Array oder Feld setzen.

In den Parametern KopfteilName und KopfteilVariable übergeben Sie Objektname und Variable für den Kopfteil der neuen duplizierten Spalte.
In den Parametern FußteilName und FußteilVariable können Sie Objektname und Variable für den Fußteil der neuen duplizierten Spalte übergeben. Lassen Sie FußteilVariable weg, verwendet 4D eine dynamische Variable.

Hinweis: Objektnamen im Formular müssen einmalig sein. Sie müssen sicherstellen, dass die Namen in den Parametern SpalteName, KopfteilName und FußteilName noch nicht verwendet wurden. Andernfalls wird die Spalte nicht dupliziert und ein Fehler wird generiert.

Dieser Befehl muss beim Anzeigen eines Formulars verwendet werden. Er wird normalerweise im Ereignis On Load des Formulars oder in Folge einer Benutzeraktion aufgerufen (Ereignis (On Clicked).

Beispiel

In einer Listbox vom Typ Array die Spalte "Vorname" zur Eingabe des 2. Vornamens duplizieren

Der Code der Schaltfläche lautet:

 ARRAY TEXT(arrFirstNames2;Records in table([Mitglieder]))

 LISTBOX DUPLICATE COLUMN(*;"column2";3;"col2bis";arrFirstNames2;"FirstNameA";vHead2A)

 OBJECT SET TITLE(*;"FirstNameA";"2. Vorname")

 EDIT ITEM(*;"col2A";0)

Klicken Sie auf die Schaltfläche am unteren Rand, erhalten Sie folgende Listbox: