Shape.InsertObject-Methode (Visio)

Fügt einem Zeichenblatt, einem Master oder einer Gruppe ein neues eingebettetes Objekt oder ein ActiveX-Steuerelement hinzu.

Syntax

Ausdruck. InsertObject( _ClassOrProgID_ , _Flags_ )

expression Eine Variable, die ein Shape-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
ClassOrProgID	Erforderlich	String	Identifiziert den zu erstellenden Typ des Objekts oder Steuerelements.
Flags	Erforderlich	Integer	Kennzeichen, die den Vorgang beeinflussen.

Rückgabewert

Form

Bemerkungen

ClassOrProgID ist eine Zeichenfolge, mit der das zu erstellende Objekt oder Steuerelement identifiziert wird. Dabei kann es sich um die Klassen-ID (GUID) des Objekts oder Steuerelements in der Form einer Zeichenfolge oder um die Programm-ID des Handlers für die Klasse handeln.

• Wenn ClassOrProgID eine Zeichenfolge ist, die eine Klassen-ID darstellt, entspricht sie "{D3E34B21-9D75-101A-8C3D-00AA001A1652}".

• Wenn ClassOrProgID eine Zeichenfolge ist, die eine Programm-ID darstellt, entspricht sie "paint.picture" oder "forms.combobox.1".

Mithilfe der herstellerspezifischen Dokumentation oder in der Registrierung können Sie bestimmen, welche Klassen-IDs und Programm-IDs den von anderen Programmen bereitgestellten Objekten und Steuerelementen zugeordnet sind.

Das Flags-Argument ist eine Bitmaske, die einen der folgenden Werte enthalten kann.

Konstante	Wert	Beschreibung
visInsertIcon	&H10	Zeigt das neue Shape als Symbol an.
visInsertDontShow	&H1000	Führt das Anzeigeverb des neuen Objekts nicht aus.

Wenn visInsertIcon und visInsertDontShow angegeben sind, schlägt die InsertObject-Methode fehl. Wenn Sie ein Objekt einfügen möchten, das als Symbol angezeigt wird, müssen Sie zulassen, dass die Anwendung das Anzeigeverb des Objekts ausführt.

Das Flags-Argument kann außerdem einen der folgenden Werte enthalten.

Konstante	Wert
visInsertAsControl	&H2000
visInsertAsEmbed	&H4000

Werte in visInsertAsControl und visInsertAsEmbed haben nur Auswirkungen, wenn die von ClassOrProgID identifizierte Klasse in der Registrierung als Steuerelement gekennzeichnet ist, das eingefügt werden kann. Wenn visInsertAsControl und visInsertAsEmbed nicht angegeben sind und das Objekt ein Steuerelement oder ein eingebettetes Objekt sein kann, wird es von der Anwendung als Steuerelement eingefügt.

In seltenen Fällen können Visio 5.0 oder höhere Versionen ein Steuerelement einfügen, während frühere Versionen von Visio auf denselben Aufruf durch Einfügen eines eingebetteten Objekts reagiert hätten. Wenn ein Steuerelement eingefügt wird, versetzt diese Methode das Dokument in den Entwurfsmodus, sodass code, der im Dokument ausgeführt wird, angehalten wird, bis das Dokument in den Ausführungsmodus zurückgegeben wird.

Achtung

Fügen Sie Ihrer Anwendung ActiveX-Steuerelemente nur mit Vorsicht hinzu. ActiveX-Steuerelemente sind unter Umständen so konzipiert, dass ihre Verwendung ein Sicherheitsrisiko darstellen kann. Es wird empfohlen, nur Steuerelemente aus vertrauenswürdigen Quellen zu verwenden. Signieren Sie alle Steuerelemente, die Sie erstellen.

Warnung

Das Ändern der Windows-Registrierung auf beliebige Weise, sei es über den Registrierungs-Editor oder programmgesteuert, birgt immer ein gewisses Risiko. Eine falsche Änderung kann zu schwerwiegenden Problemen führen, wodurch das Betriebssystem unter Umständen neu installiert werden muss. Es wird empfohlen, die Registrierung eines Computers vor dem Ändern stets zu sichern.

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.