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_ )
expression 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
Hinweise
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 der Seite, master oder Gruppenform befinden, die die zu prüfende Form enthält.
Im Folgenden sind mögliche Werte aufgeführt, 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.