GetContainers Method
TOC
Collapse the table of content
Expand the table of content

Page.GetContainers Method (Visio)

Office 2013 and later
GitHub-Mark-64px

Contribute to this content

Use GitHub to suggest and submit changes. See our guidelines for contributing to VBA documentation.

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

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()

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.

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
Show:
© 2016 Microsoft