Page. insertObject-Methode (Visio)Page.InsertObject method (Visio)

Fügt einem Zeichenblatt, einem Master oder einer Gruppe ein neues eingebettetes Objekt oder ein ActiveX-Steuerelement hinzu.Adds a new embedded object or ActiveX control to a page, master, or group.

SyntaxSyntax

Ausdruck.expression. InsertObject( _ClassOrProgID_ , _Flags_ )

Ausdruck Eine Variable, die ein Page -Objekt darstellt.expression A variable that represents a Page object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
ClassOrProgIDClassOrProgID ErforderlichRequired StringString Identifiziert den zu erstellenden Typ des Objekts oder Steuerelements.Identifies the type of object or control to create.
FlagsFlags ErforderlichRequired IntegerInteger Kennzeichen, die den Vorgang beeinflussen.Flags that influence the operation.

RückgabewertReturn value

FormShape

BemerkungenRemarks

ClassOrProgID ist eine Zeichenfolge, mit der das zu erstellende Objekt oder Steuerelement identifiziert wird.ClassOrProgID is a string that identifies the kind of object or control to create. 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.It can be either the object or control's class ID (GUID) in string form or the object or control's program ID of the handler for the class.

  • Wenn ClassOrProgID eine Zeichenfolge ist, die eine Klassen-ID darstellt, sieht Sie wie "{D3E34B21-9D75-101A-8C3D-00AA001A1652}" aus.If ClassOrProgID is a string representing a class ID, it looks like "{D3E34B21-9D75-101A-8C3D-00AA001A1652}."

  • Wenn ClassOrProgID eine Zeichenfolge ist, die eine Programm-ID darstellt, sieht Sie wie "Paint. Picture" oder "Forms. ComboBox. 1" aus.If ClassOrProgID is a string representing a program ID, it looks like "paint.picture" or "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.See vendor-specific documentation or browse the registry to determine which class IDs and program IDs are associated with objects and controls provided by other applications.

Das Flags -Argument ist eine Bitmaske, die einen der folgenden Werte enthalten kann.The Flags argument is a bitmask that can include one of the following values.

KonstanteConstant WertValue BeschreibungDescription
visInsertIconvisInsertIcon &H10&H10 Zeigt das neue Shape als Symbol an.Displays the new shape as an icon.
visInsertDontShowvisInsertDontShow &H1000&H1000 Führt das Anzeigeverb des neuen Objekts nicht aus.Does not execute the new object's show verb.

Wenn sowohl visInsertIcon als auch visInsertDontShow angegeben werden, schlägt die insertObject -Methode fehl.If both visInsertIcon and visInsertDontShow are specified, the InsertObject method fails. 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.If you want to insert an object that is displayed as an icon, you must allow the application to execute the object's show verb.

Das Flags -Argument kann auch einen der folgenden Werte enthalten.The Flags argument can also include one of the following values.

KonstanteConstant WertValue
visInsertAsControlvisInsertAsControl &H2000&H2000
visInsertAsEmbedvisInsertAsEmbed &H4000&H4000

Werte in visInsertAsControl und visInsertAsEmbed haben nur eine Auswirkung, wenn die von ClassOrProgID identifizierte Klasse in der Registrierung als Steuerelement identifiziert wird, das eingefügt werden kann.Values in visInsertAsControl and visInsertAsEmbed only have an effect if the class identified by ClassOrProgID is identified in the registry as a control that can be inserted. 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.If neither visInsertAsControl nor visInsertAsEmbed is specified and the object can be either a control or an embedded object, the application inserts it as a control.

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.In rare cases, Visio 5.0 or later versions may insert a control whereas earlier versions of Visio would have responded to the same call by inserting an embedded object. Wenn ein Steuerelement eingefügt wird, platziert diese Methode das Dokument im Entwurfsmodus, sodass Code, der im Dokument ausgeführt wird, angehalten wird, bis das Dokument in den Ausführungsmodus zurückgegeben wird.If a control is inserted, this method places the document in design mode, causing any code executing in the document to halt until the document is returned to run mode.

Achtung

Fügen Sie Ihrer Anwendung ActiveX-Steuerelemente nur mit Vorsicht hinzu.Use caution when you are adding ActiveX controls to your application. ActiveX-Steuerelemente sind unter Umständen so konzipiert, dass ihre Verwendung ein Sicherheitsrisiko darstellen kann.ActiveX controls may be designed in such a way that their use could pose a security risk. Es wird empfohlen, nur Steuerelemente aus vertrauenswürdigen Quellen zu verwenden.We recommend that you use controls from trusted sources only. Signieren Sie alle Steuerelemente, die Sie autorisieren.Sign any controls that you author.

Warnung

Das Ändern der Windows-Registrierung auf beliebige Weise, ob über den Registrierungs-Editor oder programmgesteuert, birgt immer ein gewisses Risiko.Modifying the Windows registry in any manner, whether through the Registry Editor or programmatically, always carries some degree of risk. Eine falsche Änderung kann zu schwerwiegenden Problemen führen, wodurch das Betriebssystem unter Umständen neu installiert werden muss.Incorrect modification can cause serious problems that may require you to reinstall your operating system. Es wird empfohlen, die Registrierung eines Computers vor dem Ändern stets zu sichern.It is a good practice to always back up a computer's registry first before modifying it.

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.