Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/
Cmdlet

Add-OfficeVisioRectangle

Aliases: VisioRect, VisioRectangle
Module PSWriteOffice
Aliases
VisioRect VisioRectangle
Inputs
OfficeIMO.Visio.VisioPage
Outputs
OfficeIMO.Visio.VisioShape

Adds a rectangle shape to the current Visio page.

Syntax

Add-OfficeVisioRectangle [-Angle <Double>] [-FillColor <String>] [-FillPattern <Int32>] [-Height <Double>] [-Key <String>] [-LineColor <String>] [-LinePattern <Int32>] [-LineWeight <Double>] [-Name <String>] [-NameU <String>] [-Page <VisioPage>] [-PassThru] [[-Text] <String>] [-Unit <Inches|Centimeters|Millimeters>] [-Width <Double>] [-X <Double>] [-Y <Double>] [<CommonParameters>]
#
Parameter set: All Parameter Sets

Examples

Authored help example

Add a labeled process box.

OfficeVisio -Path .\Flow.vsdx {
    VisioRectangle -Key intake -Text 'Intake' -X 1.5 -Y 4 -Width 1.7 -Height 0.8 -FillColor '#E0F2FE'
}

Adds a rectangle and registers a key for later connector commands.

Parameters

-Angle Double optional
Shape angle in radians.
-FillColor String optional
Fill color name or hex value.
-FillPattern Int32 optional
Native Visio fill-pattern index: 0 has no fill, 1 is solid, and 2 through 40 select built-in patterns.
-Height Double optional
Shape height.
-Key String optional
DSL key used by connector commands.
-LineColor String optional
Line color name or hex value.
-LinePattern Int32 optional
Native Visio line-pattern index: 0 hides the line, 1 is solid, and 2 through 23 select built-in patterns.
-LineWeight Double optional
Line weight.
-Name String optional
Optional shape name.
-NameU String optional
Optional universal shape name.
-Page VisioPage optionalpipeline: True (ByValue)
Target page. Optional inside VisioPage or OfficeVisio.
-PassThru SwitchParameter optional
Emit the object created or changed by the command.
-Text String optionalposition: 0
Text placed inside the shape.
-Unit VisioMeasurementUnit optional
Measurement unit for coordinates and dimensions.
Possible values: Inches, Centimeters, Millimeters
-Width Double optional
Shape width.
-X Double optional
X coordinate of the shape origin.
-Y Double optional
Y coordinate of the shape origin.

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.