ContainerProperties.AddMember-Methode (Visio)

  • Artikel

Fügt dem Container ein Shape oder eine Gruppe von Shapes hinzu.

Syntax

Ausdruck. AddMember (pObjectToAdd, addOptions)

Ausdruck Eine Variable, die ein ContainerProperties-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
pObjectToAdd Erforderlich UNBEKANNT Die Form oder Formen, die dem Container hinzugefügt werden sollen. Kann vom Typ Form oder Auswahl sein.
addOptions Erforderlich VisMemberAddOptions Legt fest, ob der Container erweitert werden soll, damit die hinzugefügten Shapes vollständig enthalten sind Muss eine der VisMemberAddOptions-Konstanten sein.

Rückgabewert

Nothing

HinwBemerkungeneise

Wird visMemberAddUseResizeSetting oder visMemberAddDoNotExpand für addOptions übergeben, kann eine Situation entstehen, in der ein Shape ein Containermitglied ist, sich jedoch nicht physisch im Container befindet. In einem solchen Fall kann das Shape seine Containermitgliedschaft bei nachfolgenden Verschiebungen oder Größenänderungen des Containers oder des Mitglieds verlieren.

Wenn es sich bei dem Container um eine Liste handelt, fügt AddMember das angegebene Objekt dem Listencontainer, jedoch nicht der eigentlichen Liste hinzu, d. h. das Shape ist zwar in der Liste enthalten, befindet sich aber nicht tatsächlich in der Liste. Dies tritt häufig bei Shapes in Containern auf, die sich selbst in einer Liste befinden.

Wenn die ContainerProperties.LockMembership-EigenschaftTrue ist, gibt Microsoft Visio den Fehler Disabled zurück.

Wenn der pObjectToAdd-Parameter keine Shapes der obersten Ebene auf der Seite enthält, gibt Visio den Fehler "Ungültiger Parameter" aus.

Visio gibt den Fehler "Ungültiger Parameter" auch dann aus, wenn Sie versuchen, mit der AddMember-Methode das Container-Shape als solches oder Unter-Shapes des Containers zum Container hinzuzufügen.

Visio gibt den Fehler Ungültiges Ziel zurück, wenn pObjectToAdd nicht den Kategorieanforderungen der Liste oder des Containers entspricht. Shapes können Kategorien zugewiesen werden, und Container können erforderliche und ausgeschlossene Kategorien aufweisen.

Kategorien sind vom Benutzer definierte Zeichenfolgen, die zum Kategorisieren von Shapes und damit zum Einschränken der Mitgliedschaft in einem Container verwendet werden können. Kategorien können in der Zelle User.msvShapeCategories im ShapeSheet eines Shapes definiert werden. Sie können mehrere Kategorien für ein Shape definieren, indem Sie diese durch Semikolons trennen.

Beispiel

Im folgenden beispiel für Visual Basic for Applications (VBA) wird veranschaulicht, wie sie die AddMember-Methode verwenden, um einem vorhandenen Container (vsoContainerShape) auf einer Seite ein neues Element (vsoShape) hinzuzufügen. Der Code geht davon aus, dass vsoShape bereits vsoContainerShape überlappt.

vsoContainerShape.ContainerProperties.AddMember vsoShape, visMemberAddExpandContainer

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.