Layout der Select Options definieren

Verwendung

Sie definieren das Layout der Select Options mit der Methode INIT_SELECT_OPTIONS. Die Methode finden Sie im Interfacecontroller der Komponente. Sie gibt eine Referenz auf das Interface IF_WD_SELECT_OPTIONS_20 zurück.

Die Methode INIT_SELECT_OPTIONS hat verschiedene Parameter, mit deren Hilfe Sie das Layout der Select Options individuell anpassen können. Die folgende Tabelle listet diese Parameter auf:

ACTUAL_SEARCH (Typ: STRING): aktuell angezeigte Suche übergeben
GENERAL_TEXTS (Typ: Struktur WDR_SO_S_GENERAL_TEXTS): Texte setzen
GENERAL_VISIBILITY (Typ: Struktur WDR_SO_S_GENERAL_VISIBILITY):

Dieser Parameter bestimmt die Sichtbarkeit der Buttons und der Titel.
- Mit der Komponente BUTTON_SEARCH_IS_DEFAULT können Sie den Suchen bzw. Search Button als Standardbutton für den Suchkriterienbereich definieren. Dann wird die Suche ausgeführt, sobald der Benutzer ENTER wählt (vorausgesetzt der Cursor befindet sich im Suchkriterienbereich).
- Mit Komponente LOCATION_SAVED_SEARCHES können Sie bestimmen, ob die DropDownListBox für gesicherte Suchen im Suchkriterien Panel oder darüber angezeigt wird.
- Mit der Komponente IMG_BUTTON können Sie Icons für die Suchen, Einträge löschen und Auf Standard zurücksetzen Buttons definieren.
  Weitere Informationen finden Sie unter Handling von Bildern und Web-Ikonen.
SAVED_SEARCHES (Typ: Struktur WDR_CONTEXT_ATTR_VALUE_LIST): Inhalt des Aufklappmenüs
GLOBAL_OPTIONS (Typ: Struktur WDR_SO_S_GLOBAL_OPTIONS): Dieser Parameter erlaubt Ihnen, allgemeine Einstellungen für die Select Options vorzunehmen (siehe Tabelle).

NR_DEFAULT_ROWS	Anzahl der initial auszugebenden Zeilen Zeilen mit schreibgeschützten oder erforderlichen Attributen und Attribute mit freier Textsuche werden immer ausgegeben, auch wenn der Wert im Parameter NR_DEFAULT_ROWS kleiner ist. Ist kein Wert für diesen Parameter angegeben, wird eine Zeile für jedes Attribut ausgegeben.
DEFAULT_MAX_NR_ROWS	Anzahl der maximalen Treffer
NO_OPERATORS	Liste der Attribute wird ohne Operatoren ausgegeben, IS/EQUALS Default-Wert
NO_PLUS_MINUS	Liste der Attribute wird ohne Plus- oder Minuszeichen ausgegeben
NO_ATTRIBUTE_SELECTION	Das gerenderte Attribut kann nicht geändert werden. Das Aufklappmenü des Attributs ist nicht selektierbar.
FIXED_WIDTH_FOR_USE_IN_POPUP	Breite des Ausgabefensters, wenn es in einem Pop-up angezeigt wird
NO_RANGE_CONVERSION	Ist dieser Parameter ABAP_TRUE, wird die Rangekonversion ignoriert. Alle Attribute werden typisiert und im internen Format weitergegeben.
NO_ENTER_ON_SETTING_F4_VALUE	Ist dieser Parameter ABAP_TRUE, wird in keinem der folgenden Fälle das Ereignis ON_ENTER ausgelöst: wenn Checkboxen mit zwei oder drei Zuständen markiert werden wenn im Aufklappmenü ein Wert ausgewählt wird wenn ein Wert in der Wertehilfe ausgewählt wird
NO_MULTI_PASTE	Mit diesem Flag wird die Möglichkeit unterdrückt, mehrere Werte über CTRL-C / CTRL-V aus einer Tabelle oder einem Texteditor zu übernehmen.
NO_COLLAPSE_EXPAND	Mit diesem Flag wird das automatische Gruppieren mehrerer aufeinanderfolgender Zeilen und das Erzeugen einer Kopfzeile unterdrückt.
NO_ONLINE_HELP	Unterdrücken der Standard-Onlinehilfe
WIDTHS	Erlaubt das Verändern der Spaltenbreiten (Angaben in em). Falls fixe Elemente gerendert werden (z. B. Suche sichern... ), müssen die Breiten ausreichend groß definiert werden.
RENDER_SMALL	Erlaubt zusammen mit den Einstellungen in WIDTHS ein schmales Rendering, indem die fixen Zeilen wie Search-Buttons, Suche sichern oder Auszuschließende Kriterien in zwei Zeilen gesplittet werden.
ALLOW_PERSONALIZATION	Bietet Benutzern ein Dialogfenster für Personalisierungsmöglichkeiten an. Das Dialogfenster kann nur zur Verfügung gestellt werden, wenn gespeicherte Suchen aktiv sind und das Panel Suchkriterien aufklappbar ist.
ALLOW_EASY_MODE	Erlaubt dem Benutzer, statt der Suche mit allen Suchkriterien eine Einfache Suche zu verwenden. Bei der einfachen Suche sieht der Benutzer nur das Eingabefeld für die Freitextsuche. Wenn die einfache Suche aktiv ist, wird sie dem Benutzer als Standardsuche angeboten. Der Benutzer kann dies in der Personalisierung ändern. Bei der einfachen Suche kann keine vorgegebene Suche automatisch ausgeführt werden. Sie können den Parameter nur unter folgenden Voraussetzungen verwenden: Sie haben die Freitextsuche genau einmal implementiert. Es gibt keine Mussfelder in den Suchkriterien. Es gibt keine Suchkriterien, die nicht änderbar sind. Wenn für die Freitextsuche mehrere Operatoren erlaubt sind, wird in der einfachen Suche immer der Standardoperator verwendet.

Hinweis

Die Funktionen MultiPaste und Collapse/Expand sind in dem Basis Release SAP_BASIS 7.31 bis SP4 nicht generell freigegeben, sondern können nur von freigeschalteten Paketen benutzt werden. In höheren Releaseständen sind sie automatisch aktiv.

Label

Vor einem Attribut kann optional ein Label angezeigt werden. Bei Feldern mit freier Texteingabe wird der Text als Label verwendet, der in der Attributseigenschaft TEXT angegeben wird.

Events des öffentlichen Interfaces der Komponente WD_SELECT_OPTIONS_20

Name des Events	Beschreibung, wann das Event auftritt
ON_ATTRIBUTE_CHANGE	Ein anderes Attribut in einer Zeile wird ausgewählt.
ON_CLEAR	Einer der Buttons Clear bzw. Eingabe löschen wird betätigt, nachdem die Daten von der Select Options-Komponente entfernt wurden
ON_DELETE_SEARCH	Einer der Buttons Delete Search bzw. Suche löschen wird betätigt. Die Select Options-Komponente entfernt keine Daten.
ON_EDIT_MULTI_VALUE	Betätigen des Editierbuttons eines MultiValue-Feldes.
ON_ENTER	beim Betätigen der Enter-Taste bei Auswahl im Aufklappmenü beim Markieren des Ankreuzfeldes beim Markieren des Tristate-Feldes Wenn NO_ENTER_ON_SETTING_F4_VALUE = ABAP_TRUE ist, wird das ENTER-Event nur beim Betätigen der ENTER-Taste ausgelöst.
ON_EXECUTE	Betätigen des Buttons Suchen bzw. Search; Die Select Options-Komponente führt keine zusätzliche Aktion durch.
ON_LOAD_SEARCH	Betätigen des Buttons Load Search bzw. Suche laden; Die Select Options-Komponente führt keine zusätzliche Aktion durch.
ON_OVS	Betätigen der F4-Taste
ON_RESET	Betätigen des Buttons Reset bzw. Zurücksetzen Die Select Options-Komponente führt keine zusätzliche Aktion durch. Hinweis Entnehmen Sie den Guidelines, was bei dem Ereignis ON_RESET angezeigt werden sollte und übermitteln Sie die entsprechenden Daten und Suchen in den Methoden IF_WD_SELECT_OPTIONS_20->RESET und IF_WD_SELECT_OPTIONS_20->SET_SAVED_SEARCHES.
ON_SAVE_SEARCH	Betätigen des Buttons Save Search bzw. Suche sichern; Die Suche wird nicht innerhalb der Select Options-Komponente gesichert.
ON_PLUS	Betätigen des Plusbuttons am Ende der Zeile
ON_MINUS	Betätigen des Minusbuttons am Ende der Zeile
ON_SAVE_PERS	Speichern im Dialogfenster für Personlisierungsmöglichkeiten

Vorgehensweise

Um das Layout zu definieren, rufen Sie die Methode INIT_SELECT_OPTIONS z. B. in der Methode WDDOINIT (entweder der View oder des ComponentControllers) auf.

Hinweis

Stellen Sie sicher, dass dieser Aufruf vor dem Rendering erfolgt.

Einen Beispiels-Quellcode für den Methodenaufruf finden Sie unter Select Options einbetten.