Propriété Shape.DistanceFromPoint (Visio)

Renvoie la distance entre une forme et un point. En lecture seule.

Syntaxe

expression. DistanceFromPoint( _x_ , _y_ , _Flags_ , _[pvPathIndex]_ , _[pvCurveIndex]_ , _[pvt]_ )

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

Paramètres

Nom	Requis/Facultatif	Type de données	Description
x	Obligatoire	Double	Coordonnée x.
y	Obligatoire	Double	Coordonnée y.
Flags	Requis	Integer	Indicateurs influençant le type d'entrées renvoyées dans les résultats.
pvPathIndex	Facultatif	Variant	Identifie le point sur la forme avec pvIndexCourbe et pvt.
pvCurveIndex	Facultatif	Variant	Identifie le point sur la forme avec pvIndexChemin et pvt.
Pvt	Facultatif	Variant	Identifie le point sur la forme avec pvIndexChemin et pvIndexCourbe.

Valeur renvoyée

Double

Remarques

Le point ( x,y) est exprimé en unités de dessin internes (pouces dans le dessin) par rapport à l’espace de coordonnées défini par la feuille contenant immédiatement ThisShape.

Les arguments pvIndexChemin, pvIndexCourbe et pvt renvoient facultativement les valeurs qui identifient le point à partir duquel la distance renvoyée est mesurée. Appelez ce point ( xOnThis,yOnThis). Il est situé le long de la courbe c du chemin p de ThisShape et peut être déterminé par :

ThisShape.Paths(*pvPathIndex).Item(*pvCurveIndex).Point(*pvt,&xOnThis ,&yOnthis)

Utilisez la méthode PointAndDerivatives au lieu de la méthode Point si vous souhaitez trouver les premier et deuxième dérivés à la position t le long de la courbe.

Si pvIndexChemin ou pvIndexCourbe n'est pas Null, un Integer (type VT_I4) est renvoyé. Si pvt n'est pas Null, DistanceFromPoint renvoie un Double (type VT_R8).

La propriété DistanceFromPoint considère que les repères ont des extensions et prend en compte les chemins et zones remplis d'une forme.

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 l'objet parent n'a pas de géométrie ou si Indicateurs ne tient aucun compte de la géométrie, la propriété DistanceFromPoint renvoie un grand nombre (1E+30) qui doit être interprété comme infini.

La propriété DistanceFromPoint 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 du calcul de ses résultats.

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.