> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fonctions Nearest

> Sélectionnez l’hypothèse la plus proche d’un point, d’un élément ou d’un bord de page avec les fonctions Nearest, NearestX et NearestY dans les relations avancées de pré-recherche de FlexiLayout.

Les fonctions **Nearest** indiquent à FlexiLayout Studio que, toutes choses égales par ailleurs, il doit sélectionner l’hypothèse la plus proche d’un élément ou d’un point de l’image spécifié par les paramètres de la fonction **Nearest**. Dans la section **Advanced pre-search relations** de l’élément, vous ne pouvez utiliser qu’une seule fonction **Nearest**.

Une fois la fonction appliquée, une seule hypothèse est sélectionnée parmi un ensemble de plusieurs hypothèses. La sélection a lieu lors de la génération des hypothèses pour l’élément, c’est-à-dire avant l’exécution du code saisi dans la section **Advanced post-search relations**.

Pour en savoir plus, voir [Rechercher des éléments avec Nearest et FuzzyQuality](/fr/flexi-capture/fls/tips-tricks/date9).

Les fonctions **Nearest** peuvent être utilisées pour sélectionner des hypothèses pour tout type d’élément, à l’exception des **Groups**, des **groupes répétitifs** et des **Tables**.

<div id="nearest-functions">
  ## Fonctions Nearest
</div>

| Définition                                 | Description                                                                                                                                                                                                                                                        |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Void NearestX( XCoordinate x )`           | Sélectionne l’hypothèse la plus proche de la ligne verticale passant par le point `( x, 0 )`.                                                                                                                                                                      |
| `Void NearestY( YCoordinate y )`           | Sélectionne l’hypothèse la plus proche de la ligne horizontale passant par le point `( 0, y )`.                                                                                                                                                                    |
| `Void Nearest( XInterval x, YInterval y )` | Sélectionne l’hypothèse la plus proche du rectangle `Rect( x.Start, y.Start, x.End, y.End )`.                                                                                                                                                                      |
| `Void Nearest( PageEdge )`                 | Sélectionne, sur chaque page du document, l’hypothèse la plus proche de l’un des bords de la page : top, bottom, right ou left. **Remarque.** Si plusieurs hypothèses se trouvent à la même distance de la limite spécifiée, plusieurs peuvent être sélectionnées. |
| `Void Nearest( Hypothesis hyp )`           | Sélectionne l’hypothèse la plus proche du rectangle flou `hyp.Rect`.                                                                                                                                                                                               |
| `Void Nearest( HypothesisInstances )`      | Sélectionne l’hypothèse la plus proche de l’ensemble d’hypothèses pour l’élément **groupe répétitif** spécifié.                                                                                                                                                    |

Exemple pour `NearestX` :

Le code suivant indique que l’élément recherché est, horizontalement, le plus proche de la limite droite de l’élément **ElementName**.

```text theme={null}
NearestX: ElementName.Right.Start;
```

Exemple de `NearestY` :

Le code suivant indique que l’élément recherché est verticalement le plus proche de la limite supérieure de l’élément **ElementName**.

```text theme={null}
NearestY: ElementName.Top.Start;
```

Exemple pour `Nearest( XInterval x, YInterval y )` :

Le code suivant indique que l’élément recherché est le plus proche du centre de l’élément **ElementName**.

```text theme={null}
Nearest: ElementName.XCenter, ElementName.YCenter;
```

Le code suivant spécifie que l’élément recherché est le plus proche du centre de la page.

```text theme={null}
Nearest: PageRect.XCenter, PageRect.YCenter;
```

Exemple pour `Nearest( PageEdge )` :

Pour préciser que l’élément actuel est le plus proche du bord inférieur de la page, écrivez :

```text theme={null}
Nearest: PageBottom;
```

Exemple pour `Nearest( Hypothesis hyp )` :

Le code suivant indique que l’élément recherché est le plus proche de l’élément **ElementName**.

```text theme={null}
Nearest: ElementName;
```