Page.GetContainers Method (Visio)

Article
09/15/2015

Returns an array of shape identifiers (IDs) of the container shapes on the page.

Version Information

Version Added: Visio 2010

Syntax

expression .GetContainers(NestedOptions)

expression A variable that represents a Page object.

Parameters

Name	Required/Optional	Data Type	Description
NestedOptions	Required	VisContainerNested	Indicates whether to exclude shapes in nested containers. See Remarks for possible values.

Return Value

Long()

Remarks

The NestedOptions parameter must be one of the following VisContainerNested constants.

Constant	Value	Description
visContainerIncludeNested	0	Include shapes that are in nested containers.
visContainerExcludeNested	1	Exclude shapes that are in nested containers.

You can use the Shapes.ItemFromID property to get the actual shapes from the IDs returned by GetContainers.

Example

The following Visual Basic for Applications (VBA) example shows how to use the GetContainers method to get the IDs of all the containers on a page, loop through those containers, and print each container name in the Immediate window. The example includes nested containers.

For Each containerID In vsoPage.GetContainers(visContainerIncludeNested)
    Set vsoContainerShape = vsoPage.Shapes.ItemFromID(containerID)
    Debug.Print vsoContainerShape.NameU
Next

Share via