Verwendung und Beispiel

Die Weberweiterung Elementliste verfügt über Parameter für die Kernfunktionalität und zusätzliche Parameter, um den Inhalt anzupassen.

Folgende primäre Parameter sind verfügbar:

Elementschlüssel: Eine Referenz auf einen Bereich von Zellen, die die eindeutigen Namen von Elementen und Aktionen zur weiteren Verarbeitung enthalten. Wenn eine Aktion ausgelöst wird, sendet Actions.Input.Text einen der folgenden Werte:
- Actions.Input.Text="Row": Das Objekt wird ausgewählt.
- Actions.Input.Text="Edit": Es wurde auf die Schaltfläche Bearbeiten geklickt.
- Actions.Input.Text="Delete": Es wurde auf die Schaltfläche Löschen geklickt.
Elementdaten: Eine Referenz auf einen Bereich von Zellen, die Elementdaten enthalten, oder eine Zelle, die XML mit denselben Daten enthält. Die erste Spalte des Datenbereichs ist für die folgenden optionalen Eigenschaften von Elementschlüsseln reserviert:
Titel (Zeichenfolge)
Beschreibung 1 (Zeichenfolge)
Beschreibung 2 (Zeichenfolge)
Zeitstempel (Zeichenfolge)
Sichtbar (Boolesch): Bei False wird das Element ausgeblendet. Der Standardwert ist True.
Aktiviert (Boolesch): Bei False ist das Element deaktiviert. Der Standardwert ist True.
Ausgewählt (Boolesch): Bei True ist das Element ausgewählt. Der Standardwert ist False.
Bearbeiten (Boolesch): Bei True werden Inline-Symbole zum automatischen Bearbeiten und Löschen angezeigt. Der Standardwert ist False.

Diese zusätzlichen Parameter ermöglichen die Anpassung des Inhalts. Geben Sie ="" an, um die Standardwerte zu verwenden, sofern verfügbar.

Hinweis

Wo Sie Text angeben können, wie etwa für die Fehlermeldung, können Sie mit der Funktion TRANSLATEUNIQUESTRING sicherstellen, dass der Text übersetzt wird, wenn die Sprache der Benutzeroberfläche geändert wird.

Multiselect: Bei True ist die Mehrfachauswahl aktiviert. Der Standardwert ist False.
Suchfeld-Platzhalter: Das Suchfeld wird standardmäßig angezeigt und ist leer. Geben Sie False an, um die Checkbox zu deaktivieren.
Fehlermeldung: Wenn keine Listeneinträge vorhanden sind, ist die Fehlermeldung Keine Elemente verfügbar.
Haupttitel: Der Titel der Liste. Standardmäßig wird kein Titel angezeigt.
Haupttitelfarbe: Die Standardfarbe des Titels ist #368ac0.
Titelfarbe: Die Standardfarbe der Schriftart des Titels ist #1a1a1a.
Ausgewählte Farbe: Die Farbe, in der die ausgewählte Zeile hervorgehoben wird. Der Standardwert ist #c8e9f4.
Text ausgewählter Elemente: Standardmäßig ist der Text Ausgewählt. Dieser Parameter ist nur relevant, wenn die Mehrfachauswahl aktiviert ist.
Entfernen-Aktion: Definieren Sie eine Aktion für eine Zelle, die beim Klicken auf die Schaltfläche Entfernen ausgelöst wird. Der Standardtext ist Entfernen. Dieser Parameter ist nur relevant, wenn die Mehrfachauswahl aktiviert ist.
Seitliche Rahmenlinien verbergen: Geben Sie True an, um die linke und rechte Rahmenlinie der Zeile auszublenden. Die Rahmenlinien sind standardmäßig sichtbar.
Rahmenfarbe: Standardmäßig ist die Farbe der Rahmenlinien #d8d8d8.

Erstellen Sie einen Application Studio-Bericht.

Fügen Sie folgende Beispieldaten in den Bereich B8:H12 ein:


Schlüssel	Titel	Beschreibung1	Beschreibung2	Aktiviert	Ausgewählt	Bearbeiten
a	Element A	Beschreibung A			FALSE	TRUE
b	Element B	Beschreibung B	Detailinformationen B	FALSE	FALSE	FALSE
c	Element C	Beschreibung C			TRUE	FALSE
d	Element D	Beschreibung D			FALSE	FALSE

Erstellen Sie eine Berichtsvariable mit dem Namen rv_SelectedItem,und geben Sie c als Wert und als Standardwert an. Geben Sie in den Eigenschaften der Variablen False als Wert für die Option "Is Persistent" an.
Geben Sie in Zelle G9 =ReportVariables.rv_SelectedItem.Text=B9 an. Kopieren Sie die Formel in die Zellen G10, G11 und G12.
Nach dieser Aktualisierung behalten die Zellen die ursprünglichen Texte.
Erstellen Sie für jede der Schlüsselzellen (B9, B10, B11 und B12) eine Aktion mit folgenden Eigenschaften:

Aktionen: Typ

Wählen Sie Parameter setzen als Aktionstyp aus.

Aktionen: Modus

Wählen Sie Weberweiterung als Aktionsmodus aus.

Aktionen: Bedingung

Geben Sie =Actions.Input.Text="ROW" an.

Hinweis
Diese Bedingung ist nur gültig, wenn der Aktionsmodus Weberweiterung ist.

Parameter: Name

Klicken Sie auf Parameter hinzufügen, und wählen Sie die Variable rv_SelectedItem aus.

Parameter: Eigenschaft

Geben Sie Selected Value(.Text) an.

Parameter: Wert

Geben Sie für die Aktion in B9 =B9 an. Geben Sie für die anderen Aktionen =B10, =B11 bzw. =B12 an.
Erstellen Sie eine Berichtsvariable mit dem Namen rv_TitleItemA, und geben Sie Element A als Wert an. Geben Sie in den Eigenschaften der Variablen Element A als Standardwert an, und wählen Sie False als Wert der Option "Is Persistent" aus.
Geben Sie in Zelle C9 =ReportVariables.rv_TitleItemA.Text an, und drücken Sie die Eingabetaste.
Nach dieser Aktualisierung behält die Zelle den ursprünglichen Text bei.
Erstellen Sie in Zelle B9 eine Aktion mit folgenden Eigenschaften:

Aktionen: Typ

Wählen Sie Parameter setzen als Aktionstyp aus.

Aktionen: Modus

Wählen Sie Weberweiterung als Aktionsmodus aus.

Aktionen: Bedingung

Geben Sie =Actions.Input.Text="EDIT" an.

Hinweis
Diese Bedingung ist nur gültig, wenn der Aktionsmodus Weberweiterung ist.

Parameter: Name

Klicken Sie auf Parameter hinzufügen, und wählen Sie die Variable rv_TitleItemA aus.

Parameter: Eigenschaft

Wählen Sie Value(.Text) aus.

Parameter: Wert

Geben Sie ="Edited Item A" an.

Geben Sie in Zelle B13 folgende SETPROPERTY-Formel an:

=SETPROPERTY("",B9:B12,C8,C9:C12,D8,D9:D12,E8,E9:E12,F8,F9:F12,G8,G9:G12,H8,H9:H12)

Klicken Sie auf der Symbolleiste Objekte auf Weberweiterung, und doppelklicken Sie auf die Weberweiterung Elementliste.
Der Cursor wird zu einem Fadenkreuz.
Ziehen Sie den Cursor, um die Weberweiterung einzufügen, zu skalieren und zu positionieren.
Geben Sie folgende Parameter an:

Eindeutige Namen

Geben Sie den Bereich der Zellen an, die die eindeutigen Namen der Listenelemente enthalten. Geben Sie im folgenden Beispiel =B9:B12 an.

Elementdaten

Geben Sie den Bereich der Zellen an, in denen die Datentabelle für die Erweiterung definiert wird. Geben Sie im folgenden Beispiel =B13 an.
Geben Sie optional Werte für diese Parameter an, oder geben Sie ="" an, um die Standardwerte zu verwenden.

Haupttitel

Standardmäßig hat die Liste keinen Titel. Geben Sie optional einen Titel ein.

Schriftfarbe des Haupttitels

Wenn ein Haupttitel angegeben wird, ist die Standardfarbe blau (#368ac0). Geben Sie optional einen anderen Farbwert an.

Suchfeld-Platzhalter

Das Suchfeld ist standardmäßig leer. Geben Sie optional Text an, der im Feld angezeigt werden soll. Geben Sie FALSE (Groß-/Kleinschreibung relevant) an, um das Suchfeld auszublenden.

Fehlermeldung

Standardmäßig werden nur Fehler angezeigt, wenn Elemente verfügbar sind. Geben Sie optional eine Fehlermeldung an. Verwenden Sie TRANSLATESTRING, um die Übersetzung des Fehlers zu ermöglichen, wenn die Sprache der Benutzeroberfläche geändert wird.

Schriftfarbe des Titels

Standardmäßig ist der Titel der Listenelemente dunkelgrau (#1a1a1a). Geben Sie optional einen anderen Farbwert an.

Ausgewählte Farbe

Geben Sie die Farbe an, in der das ausgewählte Listenelement hervorgehoben werden soll. Der Standardwert ist hellblau (#c8e9f4). Geben Sie optional einen anderen Farbwert an.

Multiselect

Standardmäßig können Sie nur einzelne Elemente auswählen. Um die Checkboxen zur Auswahl mehrerer Elemente zu aktivieren, geben Sie ="TRUE" an.

Seitliche Rahmenlinien verbergen

Standardmäßig verfügt jede Zeile über eine linke und eine rechte Rahmenlinie. Geben Sie "=TRUE" an, um diese Rahmenlinien auszublenden.

Rahmenfarbe

Standardmäßig sind die oberen und seitlichen Rahmenlinien der Liste hellgrau (#d8d8d8). Geben Sie optional einen anderen Farbwert an.

Text ausgewählter Elemente

Wenn die Mehrfachauswahl aktiviert ist, wird die Anzahl der ausgewählten Elemente angezeigt, gefolgt von Selected. Geben Sie optional einen anderen Text an. Verwenden Sie TRANSLATESTRINGUNIQUE, um die Übersetzung des Textes zu ermöglichen, wenn die Sprache der Benutzeroberfläche geändert wird.

Entfernen-Schaltfläche auf Aktionsleiste

Wenn die Mehrfachauswahl aktiviert ist, können Sie eine Entfernen-Schaltfläche anzeigen, mit der die Auswahl von Elementen wieder aufgehoben wird. Geben Sie die Referenz einer Zelle an, die das Wort Remove enthält.

Verwenden Sie TRANSLATESTRING, um eine Übersetzung der Schaltfläche zu ermöglichen, wenn die Sprache der Benutzeroberfläche geändert wird.