Selection.DrawRegion-Methode (Visio)
Zeichnet ein neues Shape, das den Bereich darstellt, der einen bestimmten Punkt enthält.
Syntax
Ausdruck. DrawRegion( _Tolerance_ , _Flags_ , _x_ , _y_ , _ResultsMaster_ )
Ausdruck Eine Variable, die ein Selection-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| Toleranz | Erforderlich | Double | Fehlertoleranz bei der Bestimmung des Zufalls von Punkten. Ein Abstand, der in internen Einheiten im Koordinatenraum der enthaltenden Form des Selection-Objekts ausgedrückt wird; die maximale Lücke zwischen Pfaden, die beim Erstellen der Grenzen eines Bereichs toleriert wird. |
| Flags | Erforderlich | Integer | Eine Konstante oder eine ganze Zahl, die angibt, wie der Bereich gezeichnet wird. |
| x | Optional | Variant | Eine X-Koordinate in internen Einheiten im Koordinatenbereich des Selection-Objekts. |
| y | Optional | Variant | Die Y-Koordinate in internen Einheiten im Koordinatenbereich des Selection-Objekts. |
| ResultsMaster | Optional | Variant | Das Master-Objekt, von dem das neue Shape-Objekt eine Instanz sein sollte. |
Rückgabewert
Form
Bemerkungen
Die DrawRegion-Methode erstellt ein neues Shape-Objekt von Pfadkomponenten im Selection-Objekt.
Wenn sowohl x als auch y angegeben werden, ist die resultierende Form der kleinste Bereich, der den Punkt ( x, y) enthält.
Wenn kein x oder y vorhanden ist, oder wenn der Punkt ( x, y) in keinem Bereich enthalten ist, der von den Pfaden der ausgewählten Shapes eingeschlossen ist, ist das Ergebnis die Vereinigung aller Formen, die mit der Fragmentierungsoperation erstellt worden wären.
Wenn von den ausgewählten Shapes kein geschlossener Bereich definiert wird, gibt die DrawRegion-Methode Nothing zurück und löst keine Ausnahme aus.
Das Flags-Argument kann eine oder eine Kombination der folgenden Konstanten sein, die von der Visio-Typbibliothek in VisDrawRegionFlags deklariert werden.
| **Namen** | Wert | Beschreibung |
|---|---|---|
| visDrawRegionDeleteInput | &H4 | Elemente in der Auswahl löschen. |
| visDrawRegionIgnoreVisible | &H20 | Sichtbare Geometrie ausschließen. |
| visDrawRegionIncludeDataGraphics | &H40 | Beschriftungs-Shapes (einschließlich untergeordneter Shapes) für Datengrafiken einschließen. |
| visDrawRegionIncludeHidden | &H10 | Ausgeblendete Geometrie einblenden. |
Wenn der DrawRegion-Methode ein ResultsMaster-Argument vom Typ VT_EMPTY oder VT_ERROR übergeben wird (auf diese Weise wird von VBA ein nicht angegebenes optionales Argument übergeben), ist das neue Shape keine Instanz eines Master-Shapes. Und für die Füll-, Linien- und Textformatvorlagen des neuen Bereichs werden die Standardformatvorlagen des Dokuments festgelegt.
Wenn der DrawRegion-Methode ein Verweis auf ein Master-Objekt in ResultsMaster übergeben wird (Typ VT_UNKNOWN oder VT_DISPATCH), erstellt die DrawRegion-Methode eine Instanz dieses Master-Objekts und fügt berechnete Geometrie anhand des Selection-Objekts hinzu.
Das neue Shape-Objekt weist nur den bereits in ResultsMaster vorhandenen Text auf.
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.