Método ContainerProperties.AddMember (Visio)

Agrega una forma o un conjunto de formas al contenedor.

Sintaxis

expresión. AddMember (pObjectToAdd, addOptions)

Expresión Variable que representa un objeto ContainerProperties .

Parameters

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
pObjectToAdd	Obligatorio	DESCONOCIDO	Forma o formas que se desean agregar al contenedor. Puede ser de tipo Shape o Selection.
addOptions	Obligatorio	VisMemberAddOptions	Determina si el contenedor se debe expandir para contener completamente las formas agregadas. Debe ser una de las constantes VisMemberAddOptions .

Valor devuelto

Nothing

Comentarios

Al pasar visMemberAddUseResizeSetting o visMemberAddDoNotExpand para addOptions se puede crear una situación en la que una forma pertenezca a un contenedor pero no esté físicamente dentro de éste. En ese caso, la forma puede perder su pertenencia al contenedor durante los movimientos siguientes o los cambios de tamaño del contenedor o de la forma perteneciente.

Si el contenedor es una lista, AddMember agrega el objeto especificado al contenedor de lista, pero no a la lista misma. Es decir, la forma está contenida por la lista pero realmente no aparece en ésta. Esta situación es habitual en formas contenidas en contenedores que pertenecen a una lista.

Si la propiedad ContainerProperties.LockMembership es True, Microsoft Visio devuelve un error Deshabilitado.

Si el parámetro pObjectToAdd no contiene formas de nivel superior en la página, Visio devuelve un error "Parámetro no válido".

Visio también devuelve un error "Parámetro no válido" si se intenta usar el método AddMember para agregar la forma de contenedor misma o las subformas del contenedor a éste.

Visio devuelve un error de destino no válido si pObjectToAdd no coincide con los requisitos de categoría de la lista o del contenedor. Las formas se pueden asignar a categorías, y los contenedores pueden tener categorías requeridas y excluidas.

Las categorías son cadenas definidas por el usuario que se pueden usar para clasificar las formas y, de esa manera, restringir la pertenencia en un contenedor. Las categorías se pueden definir en la celda User.msvShapeCategories, en la ShapeSheet de una forma. Se pueden definir varias categorías para una forma, separándolas con puntos y coma.

Ejemplo:

En el siguiente ejemplo de Visual Basic para Aplicaciones (VBA) se muestra cómo usar el método AddMember para agregar un nuevo miembro (vsoShape) a un contenedor existente (vsoContainerShape) en una página. El código supone que vsoShape ya se superpone con vsoContainerShape.

vsoContainerShape.ContainerProperties.AddMember vsoShape, visMemberAddExpandContainer

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.