Passer au contenu principal
Group est une collection de plusieurs éléments (appelés sous-éléments). Les sous-éléments peuvent, à leur tour, être des éléments Group. Les éléments Group sont signalés par dans l’arborescence FlexiLayout.
Les éléments Group incluent également : Header,Footer, First Found et Repeating Group. Utilisez les éléments Header et Footer pour détecter le début et la fin d’un document. Les éléments Header et Footer ne peuvent apparaître chacun qu’une seule fois dans un document. Repeating Group est un élément Group récurrent. Un élément Labeled Field peut également être représenté sous forme d’élément composé.
Si nécessaire, vous pouvez spécifier le nombre minimum de sous-éléments à détecter. Si l’application du FlexiLayout détecte un nombre d’éléments inférieur, l’élément composé sera considéré comme non détecté. Un élément Group, comme un élément simple, peut être obligatoire, facultatif ou interdit. Si un élément Group facultatif inclut un élément obligatoire, l’impossibilité d’associer cet élément à un objet entraînera une hypothèse nulle pour l’élément Group, et le programme continuera à tenter d’associer le FlexiLayout. Veillez à ne pas conserver d’éléments composés vides (c’est-à-dire des éléments composés sans sous-éléments). Si le programme rencontre un élément composé vide lors de la compilation d’un FlexiLayout, il affichera un message d’avertissement. Si votre FlexiLayout n’utilise pas les éléments composés Header et Footer, ajoutés par défaut, supprimez ces éléments superflus. Les éléments Group sont utiles dans les cas suivants :
  • pour faciliter le test de parties indépendantes d’un FlexiLayout. Par exemple, un FlexiLayout composé de 100 éléments peut ne contenir que 3 éléments Group : le titre, le corps et le bas du document. Chacun de ces trois éléments Group contiendra des éléments Group décrivant des portions plus petites du document. Cette approche limite à la fois le nombre de variantes possibles à prendre en compte et facilite le débogage du FlexiLayout, car chaque groupe peut être modifié et testé indépendamment.
  • pour faciliter la navigation dans l’arborescence FlexiLayout.
  • pour réduire le nombre d’hypothèses d’élément, et ainsi accélérer la formulation de l’hypothèse finale. Le regroupement d’éléments permet au programme de considérer un ensemble d’éléments comme un tout, pour lequel une seule hypothèse est formulée (bien qu’elle soit constituée des hypothèses des sous-éléments) et dont la qualité peut être calculée. L’examen des différentes combinaisons d’hypothèses de sous-éléments s’effectue à l’intérieur du groupe, et seul un nombre défini des meilleures hypothèses de groupe est utilisé lors de la recherche dans l’arborescence. Le nombre par défaut des meilleures hypothèses pour un élément Group est de 1. Remarque. Nous ne recommandons pas d’augmenter le nombre maximal d’hypothèses, car cela peut entraîner une croissance incontrôlée de l’arborescence et empêcher l’association du FlexiLayout avec les images.
  • Un élément Group vous permet de spécifier une contrainte de recherche commune à tous les sous-éléments. La zone de recherche d’un élément donné sera calculée comme l’intersection entre la zone de recherche spécifiée dans le sous-élément et la zone de recherche de l’ensemble du groupe. Remarque. Il arrive que l’intersection entre la zone de recherche d’un élément Group et celle de l’un de ses sous-éléments soit vide, et que le programme ne parvienne pas à trouver le sous-élément. Essayez de ne définir que des relations simples pour les éléments Group, par exemple “Au-dessus : PageRect.Top + PageRect.Height/2;” (c’est-à-dire “rechercher l’élément dans la moitié supérieure de l’image”), ou de ne définir aucune relation.

​
Voir aussi :

Création et suppression d’éléments Vue d’ensemble des propriétés des éléments Zone de recherche Contraintes de recherche supplémentaires