Item

betrifft

 

Die Eigenschaft Item ermittelt ein Steuerelement der Auflistung über die Ordinalposition oder über den Namen des Steuerelementes.

 

Syntax

Item(NameOrIndex [, OnClient])

Rückgabewert

Typ

Beschreibung

Control

Das gefundene Steuerelement in der Auflistung

Parameter

Verwendung

Name

Typ

Übergabe

Beschreibung

Erforderlich

NameOrIndex

Variant

ByVal

Numerischer Index (1-basiert) oder der Name des zu suchenden Steuerelemente-Containers

Optional

OnClient

Boolean

ByVal

True, wenn das Steuerelement über den Client gesucht werden soll.

Defaultwert ist True

 

Die Eigenschaft kann nur gelesen werden.

 

Anmerkungen:

 

Serverseitig werden die Steuerelemente eines Formulars so behandelt, wie sie im Formular-Designer eines Formulars einer Klasse angezeigt werden. So hat z.B. ein Steuerelement vom Typ TCEPanels.SubFormular zumeist keine weiteren Kinder. Zur Laufzeit jedoch, wenn dieses Steuerelement ein anderes Formular einbindet, stehen dort dynamisch weitere Steuerelemente zur Verfügung. Daher kann durch Übergabe von True für den Parameter OnClient festgelegt werden, dass die Steuerelemente über den Client gesucht werden sollen. Dies verursacht einen zusätzlichen Roundtrip und ist somit deutlich langsamer. Jedoch können in diesen speziellen Situationen auch diese dynamisch erzeugten Elemente aufgefunden werden.