User Rating: 3 / 5

Star ActiveStar ActiveStar ActiveStar InactiveStar Inactive

Rename refactoring allows you to intelligently rename variables, controls, parameters, functions and more.

You start by right-clicking on the object you wish to rename to bring up the context menu. Then select Rename… from the menu:

select Rename… from the menu

You are then presented with the rename dialog:

rename dialog

Let us cover each field:

New Name:

Here you enter the new name for the selected object.

Object Type:

This field lets you know what type of object you are renaming.

The field will display the following types:

Object Type Description
Event Updates the event variable and references in the designer.
Function Updates function declaration and function calls.
GUI Control Updates the GUI control variables and updates any event names and return variables for projects.
Parameter Updates the parameter for the function and any calls using the parameter.
Variable Updates variables within the document that aren’t a parameter or GUI control.

Note: Depending on the object’s type the some settings may vary.



The scope lets you define in which scope the objects will be replaced.

Depending on the object type the following scopes may be selected:

Scope Description
Current Scope Rename refactoring only occurs within the scope of the current function or event block.
Current Document Rename refactoring will occur for all instances of the object within the current document.
Entire Project Rename refactoring will occur for all instances of the object within all the project files.

GUI Controls, Events, Parameters and Functions will always apply to the global scope such as the Current Document or the Entire Project.

Preview references changes:

When this option is checked, you will be presented with a dialog listing all the changes that will take affect.

dialog lists changes

Here you can preview the changes by clicking on any item in the list.

preview changes

You can also uncheck an item if you do not want that particular instance to be modified.

Note: You are unable to uncheck items if you are renaming a GUI Control.


Rename Refactoring in Projects

Rename refactoring can be extremely useful when dealing with multiple files as in a project, because it will update all the project files (with the exception of excluded files):

extremely useful when dealing with multiple files as in a project

In PowerShell Studio return variables are updated when a GUI control is renamed. In addition, when you rename a project file in PowerShell Studio, all the reference functions and return variables are updated to reflect the new file name.

Tip If you include ps1 files as content and dot source the file within a project, calls to functions defined in the dot sourced file can be updated using rename refactoring.


The rename refactoring feature can be a big time saver when renaming events, variables, functions and other objects. In addition, with the preview you can quickly see where the object is used and selectively decide if you want to go forward with any change.

If you have questions about our products, please post in our support forum.
For licensed customers, use the forum associated with your product in our Product Support Forums for Registered Customers.
For users of trial versions, please post in our Former and Future Customers - Questions forum.
Copyright © 2024 SAPIEN Technologies, Inc.