Skip to main content
Gruppenelement ist eine Sammlung mehrerer Elemente (genannt Subelemente). Subelemente können ihrerseits Gruppenelemente sein. Gruppenelemente sind im FlexiLayout-Baum mit Symbol für Gruppenelement gekennzeichnet.
Gruppenelemente umfassen auch Header, Fußzeile, First Found und Repeating Group.Verwenden Sie die Elemente Header und Fußzeile, um den Anfang und das Ende eines Dokuments zu erkennen. Jedes darf in einem Dokument nur einmal vorkommen.Repeating Group ist ein wiederkehrendes Gruppenelement. Ein Labeled Field-Element kann ebenfalls als zusammengesetztes Element dargestellt werden.

​
Wie Gruppenelemente erkannt werden

Bei Bedarf können Sie die Mindestanzahl der zu erkennenden Subelemente angeben. Wenn bei Anwendung des FlexiLayouts weniger Subelemente erkannt werden, gilt das zusammengesetzte Element als nicht erkannt. Ein Gruppenelement kann, genau wie ein einfaches Element, erforderlich, optional oder verboten sein. Wenn ein optionales Gruppenelement ein erforderliches Element enthält und dieses Element nicht mit einem Objekt abgeglichen werden kann, führt dies zu einer Nullhypothese für das Gruppenelement, und das Programm setzt den Abgleich des FlexiLayouts fort. Vermeiden Sie leere zusammengesetzte Elemente (d. h. zusammengesetzte Elemente ohne Subelemente). Wenn das Programm beim Kompilieren eines FlexiLayouts auf ein leeres zusammengesetztes Element stößt, zeigt es eine Warnmeldung an. Die Elemente Header und Fußzeile werden standardmäßig hinzugefügt. Wenn Ihr FlexiLayout sie nicht verwendet, löschen Sie diese überflüssigen Elemente.

​
Wann Gruppenelemente verwendet werden

Gruppenelemente sind in den folgenden Fällen nützlich:
  • Um das Testen unabhängiger Teile eines FlexiLayout zu erleichtern. Ein FlexiLayout, das beispielsweise aus 100 Elementen besteht, kann nur 3 Gruppenelemente enthalten: den Titel, den Hauptteil und den unteren Teil des Dokuments. Jedes dieser drei Gruppenelemente enthält wiederum Gruppenelemente, die kleinere Teile des Dokuments beschreiben. Dieser Ansatz begrenzt die Anzahl der zu berücksichtigenden möglichen Varianten und erleichtert zugleich das Debugging des FlexiLayout, da jede Gruppe unabhängig bearbeitet und getestet werden kann.
  • Um die Navigation im FlexiLayout-Baum zu erleichtern.
  • Um die Anzahl möglicher Elementhypothesen zu verringern und dadurch die Formulierung der endgültigen Hypothese zu beschleunigen. Durch das Gruppieren von Elementen kann das Programm eine Menge von Elementen als Ganzes betrachten, für die eine einzelne Hypothese formuliert wurde (wenn auch aus den Hypothesen für Subelemente bestehend) und für die die Quality berechnet werden kann. Innerhalb der Gruppe werden verschiedene Kombinationen von Subelement-Hypothesen berücksichtigt, und bei der Suche weiter unten im Baum wird nur eine festgelegte Anzahl der besten Gruppenhypothesen verwendet. Die Standardanzahl der besten Hypothesen für ein Gruppenelement ist 1.
    Es wird nicht empfohlen, die maximale Anzahl von Hypothesen zu erhöhen, da dies zu einem unkontrollierbaren Wachstum des Baums führen und dazu, dass das FlexiLayout nicht mit den Bildern abgeglichen werden kann.
  • Um eine Suchbedingung festzulegen, die für alle Subelemente gemeinsam ist. Der Suchbereich für ein bestimmtes Element wird als Schnittmenge des im Subelement angegebenen Suchbereichs und des Suchbereichs der gesamten Gruppe berechnet.
    Manchmal kann die Schnittmenge des Suchbereichs eines Gruppenelements und eines seiner Subelemente leer sein, sodass das Programm das Subelement nicht finden kann. Versuchen Sie, für Gruppenelemente nur einfache Beziehungen anzugeben, zum Beispiel Above: PageRect.Top + PageRect.Height/2; (das heißt: „Suchen Sie das Element in der oberen Hälfte des Bildes“), oder geben Sie überhaupt keine Beziehungen an.