#PSTip Working with Excel constants

When automating Microsoft Excel, almost every time you’ll need to include some constant values to define the behaviour of the code. Excel (and other Office applications) makes extensive use of constant values via enumeration objects. For example, to right align cell content you need to know in advance the value of the xlRight constant. Most of the time you’ll lookup the value using an Internet search or use some VBA-Fu techniques and hard code it in your script.

$xlRight = -4152
$sheet.Range('A1').HorizontalAlignment = $xlRight

In this tip I want to suggest a convenient  way  to work with those constants, a way that utilizes tab completion and that also doesn’t require you to know the numeric value of the constant in question. Now it’s very easy to discover all constants that have ‘right’ in their name.


The following code iterates over all Enumeration objects of Excel, converge all values into one PowerShell custom object. Now whenever you need to specify one of the constants, it’s very easy to discover the value.

# create Excel object
$xl = New-Object -ComObject Excel.Application

# create new PowerShell object
$xlEnum = New-Object -TypeName PSObject

# get all Excel exported types of type Enum
$xl.GetType().Assembly.GetExportedTypes() | Where-Object {$_.IsEnum} | ForEach-Object {

    # create properties from enum values
    $enum = $_
    $enum.GetEnumNames() | ForEach-Object {
        $xlEnum | Add-Member -MemberType NoteProperty -Name $_ -Value $enum::($_)

Now you can use constants without hard coding them first.

$sheet.Range('A1').HorizontalAlignment = $xlEnum.xlRight

If you still need to find the numeric value:

PS> $xlEnum.xlRight.value__
Filed in: Columns, Tips and Tricks Tags: , , , ,
© 6393 PowerShell Magazine. All rights reserved. XHTML / CSS Valid.
Proudly designed by Theme Junkie.
%d bloggers like this: