Propriété Shape.DistanceFrom (Visio)

  • Article

Renvoie la distance d'une forme à une autre, mesurée entre les points les plus proches de deux formes. Les deux formes doivent se trouver sur la même page ou dans la même forme de base. En lecture seule.

Syntaxe

expression. DistanceFrom( _OtherShape_ , _Flags_ )

expression Une variable qui représente uneForme d’objet.

Paramètres

Nom Requis/Facultatif Type de données Description
Autre forme Obligatoire [IVSHAPE] Autre objet Shape impliqué dans la comparaison.
Flags Obligatoire Integer Indicateurs influençant le type d'entrées renvoyées dans les résultats.

Valeur renvoyée

Double

Remarques

La propriété DistanceFrom renvoie les valeurs suivantes :

  • Zéro et génère une exception si les formes comparées se trouvent sur différentes formes de base ou sur différentes pages.

  • Zéro si les formes comparées se chevauchent.

  • Zéro si une forme contient l'autre forme ou si une forme est contenue dans l'autre.

L'argument Indicateurs peut être l'une des combinaisons de valeurs des constantes définies dans le tableau suivant. Ces constantes sont également définies en tant que membres de VisSpatialRelationFlags dans la bibliothèque de types de Microsoft Visio.

Constante Valeur Description
visSpatialIncludeDataGraphics &H40 Inclut les formes de légende des graphiques de données et leurs sous-formes. Par défaut, les formes de légende des graphiques de données et leurs sous-formes ne sont pas incluses. Si la forme parente est elle-même une légende de graphique de données, les recherches sont réalisées entre la géométrie de la forme parente et les formes qui ne sont pas des formes de légende, excepté si cet indicateur est défini.
visSpatialIncludeHidden &H10 Tient compte des sections Geometry masquées. Par défaut, les sections Geometry masquées n’influencent pas le résultat.
visSpatialIgnoreVisible &H20 Ne tient pas compte des sections Geometry visibles. Par défaut, les sections Geometry visibles influencent le résultat.

Utilisez la cellule NoShow pour déterminer si une section Geometry est visible ou masquée. Les sections Geometry masquées ont une valeur TRUE et celles qui sont visibles ont une valeur FALSE dans la cellule NoShow.

Si la forme parente ou AutreForme n'a pas de géométrie ou si Indicateurs ne tient aucun compte de la géométrie d'une autre forme, la propriété DistanceFrom renvoie un grand nombre (1E+30) qui doit être interprété comme infini.

La propriété DistanceFrom ne tient pas compte de la largeur de trait, des ombres, des extrémités de trait, des points de contrôle ou des points de connexion des formes lors des comparaisons.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.