Compartir a través de


Método Page.InsertObject (Visio)

Agrega un nuevo objeto incrustado o un control ActiveX a una página, un patrón o un grupo.

Sintaxis

expresión. InsertObject( _ClassOrProgID_ , _Flags_ )

Expresión Variable que representa un objeto Page .

Parameters

Nombre Obligatorio/opcional Tipo de datos Descripción
ClassOrProgID Obligatorio String Identifica el tipo de objeto o de control que se va a crear.
Flags Obligatorio Integer Marcas que influyen en la operación.

Valor devuelto

Forma

Comentarios

ClassOrProgID es una cadena que identifica el tipo de objeto o control que se va a crear. Puede ser el identificador de clase (GUID) del objeto o del control en forma de cadena o el identificador de programa del objeto o del control del controlador de la clase.

  • Si ClassOrProgID es una cadena que representa un identificador de clase, su aspecto es similar a "{D3E34B21-9D75-101A-8C3D-00AA001A1652}".

  • Si ClassOrProgID es una cadena que representa un identificador de programa, su aspecto es similar a "paint.picture" o "forms.combobox.1".

Vea la documentación específica del proveedor o examine el Registro para determinar los identificadores de clase y de programa que están asociados a los objetos y controles suministrados por otras aplicaciones.

El argumento Flags es una máscara de bits que puede incluir uno de los valores siguientes.

Constante Valor Descripción
visInsertIcon &H10 Muestra la nueva forma como un icono.
visInsertDontShow &H1000 No ejecuta el verbo show del objeto nuevo.

Si se especifican visInsertIcon y visInsertDontShow, el método InsertObject produce un error. Si desea insertar un objeto que se muestra como un icono, debe permitir que la aplicación ejecute el verbo show del objeto.

El argumento Flags también puede incluir uno de los siguientes valores.

Constante Valor
visInsertAsControl &H2000
visInsertAsEmbed &H4000

Los valores de visInsertAsControl y visInsertAsEmbed sólo tienen efecto si la clase identificada por ClassOrProgID se identifica en el Registro como un control que se puede insertar. Si no se especifican ni visInsertAsControl ni visInsertAsEmbed y el objeto puede ser un control o un objeto incrustado, la aplicación lo inserta como un control.

En casos excepcionales, Visio 5.0 o versiones posteriores pueden insertar un control, mientras que las versiones anteriores de Visio habrían respondido a la misma llamada insertando un objeto incrustado. Si se inserta un control, este método coloca el documento en modo de diseño, deteniendo el código que se esté ejecutando en el documento hasta que éste vuelva al modo de ejecución.

Precaución

Tenga cuidado al agregar controles ActiveX a la aplicación. Es posible que estos controles estén diseñados de tal forma que su uso conlleve riesgos de seguridad. Recomendamos que los utilice sólo de fuentes de confianza. Firme los controles que cree.

Advertencia

La modificación del Registro de Windows de cualquier manera, ya sea mediante el Editor del Registro o mediante programación, siempre conlleva algún grado de riesgo. Las modificaciones incorrectas pueden ocasionar serios problemas que pueden requerir la reinstalación del sistema operativo. Es aconsejable realizar siempre una copia de seguridad del Registro de un equipo antes de modificarlo.

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.