Master.DataGraphicVerticalPosition Property (Visio)
Gets or sets the default vertical callout position for members of the GraphicItems collection of the Master object of type visTypeDataGraphic. Read/write.
Note
This Visio object or member is available only to licensed users of Microsoft Visio Professional 2010 or Visio Premium 2010.
Version Information
Version Added: Visio 2007
Syntax
expression .DataGraphicVerticalPosition
expression An expression that returns a Master object.
Return Value
VisGraphicPositionVertical
Remarks
The default vertical callout position for graphic items in the GraphicItems collection of a Master object of type visTypeDataGraphic, commonly called a data graphic master, is specified by the settings of the Master.DataGraphicVerticalPosition property. If GraphicItem.UseDataGraphicPosition is True, the graphic item is positioned according to the default setting. If UseDataGraphicPosition is False, its vertical position is determined by the settings of the GraphicItem.VerticalPosition property.
Note, however, that users can manually re-position a data graphic that was applied to a shape by using the control handle of the data graphic. A position set in this manner takes precedence over the position specified by property settings.
The setting of the DataGraphicVerticalPosition property corresponds to the setting of the Vertical box under Default position in the New Data Graphic or Edit Data Graphic dialog box in the Microsoft Visio user interface (UI).
The following possible values for the DataGraphicVerticalPosition property are from the VisGraphicPositionVertical enumeration, which is declared in the Visio type library.
Constant |
Value |
Description |
|---|---|---|
visGraphicBelow |
0 |
The top edge of the graphic item's alignment box is aligned with the bottom edge of the shape or container's alignment box. |
visGraphicBottomEdge |
1 |
The horizontal centerline of the graphic item's alignment box is aligned with the bottom edge of the shape or container's alignment box. |
visGraphicBottom |
2 |
The bottom edge of the graphic item's alignment box is aligned with the bottom edge of the shape or container's alignment box. |
visGraphicMiddle |
3 |
The horizontal centerline of the graphic item's alignment box is aligned with the horizontal centerline of the shape or container's alignment box. |
visGraphicTop |
4 |
The top edge of the graphic item's alignment box is aligned with the top edge of the shape or container's alignment box. |
visGraphicTopEdge |
5 |
The horizontal centerline of the graphic item's alignment box is aligned with the top edge of the shape or container's alignment box. |
visGraphicAbove |
6 |
The bottom edge of the graphic item's alignment box is aligned with the top edge of the shape or container's alignment box. |
Note
Before you can set any property of a graphic item, you must use the Master.Open method to open for editing a copy of the data graphic master whose GraphicItems collection the graphic item belongs to. When you are finished setting properties, use the Master.Close method to commit changes.