Shape.AddRows-Methode (Visio)
Fügt einem ShapeSheet-Abschnitt an der angegebenen Position die angegebene Anzahl von Zeilen hinzu.
Syntax
Ausdruck.
AddRows( _Section_ , _Row_ , _RowTag_ , _RowCount_ )
expression Eine Variable, die ein Shape-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| Section | Erforderlich | Integer | Der Abschnitt, in dem die Zeilen hinzugefügt werden sollen. |
| Row | Erforderlich | Integer | Die Position, an der die Zeilen hinzugefügt werden sollen. |
| RowTag | Erforderlich | Integer | Der Typ der hinzuzufügenden Zeilen. |
| RowCount | Erforderlich | Integer | Die Anzahl der hinzuzufügenden Zeilen. |
Rückgabewert
Ganze Zahl
Hinweise
Wenn der ShapeSheet-Abschnitt nicht vorhanden ist, wird von der AddRows-Methode ein Abschnitt mit leeren Zeilen erstellt. Neue Zellen in neuen Zeilen werden, soweit zutreffend, mit Standardformeln initialisiert. Andernfalls muss ein Programm Anweisungen zum Festlegen der Formeln für die neuen Zellen enthalten. Falls die Zeile nicht hinzugefügt werden kann, wird ein Fehler generiert.
Die Visio-Typbibliothek deklariert die Konstanten für RowTag in VisRowIndices.
Die von der Visio-Typbibliothek deklarierten Zeilenkonstanten dienen als Basispositionen, an denen die Zeilen eines Abschnitts beginnen. Fügen Sie diesen Konstanten Offsets hinzu, um die erste Zeile und darüber hinaus anzugeben, z. B. visRowFirst +0, visRowFirst +1 usw. Um Zeilen am Ende eines Abschnitts hinzuzufügen, übergeben Sie die visRowLast-Konstante für das Row-Argument. Der zurückgegebene Wert ist der eigentliche Zeilenindex.
Das RowTag-Argument gibt den Typ der hinzuzufügenden Zeilen an. Übergeben Sie visTagDefault (0) als RowTag-Argument , um den Standardzeilentyp eines Abschnitts zu generieren. Explizite Tags sind nützlich, wenn Zeilen zu den Abschnitten Geometrie, Verbindungspunkte und Steuerelemente hinzugefügt werden. Beschreibungen gültiger Zeilentypen für diese Abschnitte finden Sie in der RowType-Eigenschaft . Das Übergeben eines ungültigen Zeilentyps generiert einen Fehler.
Ein Fehler wird gemeldet, wenn Sie versuchen, einem Abschnitt Characters, Tab oder Paragraph Zeilen hinzuzufügen.
Mit der AddRows-Methode können keine benannten Zeilen hinzugefügt werden. Verwenden Sie die AddNamedRow-Methode, um benannte Zeilen hinzuzufügen.
Wenn Sie zeilen zu einem Abschnitt hinzufügen, der über benennende Zeilen verfügt (z. B. den Abschnitt Verbindungspunkte oder Steuerelemente), wird das Argument Row ignoriert. Standardmäßig werden benannte Zeilen in der hinzugefügten Reihenfolge benannt, z. B. Row_1, Row_2 usw. Die Benennungsreihenfolge wird jedoch durch vorhandene oder zuvor gelöschte Zeilen beeinflusst.
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.