Shape.HitTest-Methode (Visio)

Bestimmt, ob eine X,Y-Position außerhalb, innerhalb oder auf der Grenze eines Shapes liegt.

Syntax

Ausdruck. HitTest( _xPos_ , _yPos_ , _Tolerance_ )

Ausdruck Eine Variable, die ein Shape-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
xPos	Erforderlich	Double	Die X-Koordinate, die auf einen Treffer getestet werden soll.
yPos	Erforderlich	Double	Die Y-Koordinate, die auf einen Treffer getestet werden soll.
Toleranz	Erforderlich	Double	Wie nah xPos,yPos an einer Form sein muss, damit ein Treffer auftritt.

Rückgabewert

Ganze Zahl

HinwBemerkungeneise

Die HitTest-Methode berücksichtigt nur sichtbare Geometrie. Ausgeblendete Geometrie wird ignoriert.

Verwenden Sie interne Zeichnungseinheiten (Zoll in der Zeichnung) für die Werte xPos, yPos und Tolerance . Diese Werte sollten sich auch im Koordinatenbereich des Seiten-, Master- oder Gruppen-Shapes befinden, das die zu prüfende Form enthält.

Es folgen mögliche Werte, die von der HitTest-Methode zurückgegeben werden und von der Visio-Typbibliothek in VisHitTestResults deklariert werden.

Konstante	Wert
visHitOutside	0
visHitOnBoundary	1
visHitInside	2

Auf das übergeordnete Shape angewendete Beschriftungs-Shapes (einschließlich untergeordneter Shapes) für Datengrafiken werden bei Berechnungen für Treffertests nicht berücksichtigt. Wenn das übergeordnete Shape ein Beschriftungs-Shape für eine Datengrafik ist, wird dessen Geometrie (und die Geometrie der untergeordneten Shapes) bei Berechnungen für Treffertests hingegen berücksichtigt.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.