Share via

Selection.DrawRegion-Methode (Visio)

  • Artikel

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.