Collapse Getting StartedGetting Started
Expand Types of SolidWorks API ApplicationsTypes of SolidWorks API Applications
Expand SolidWorks API Object Model and Class HierarchySolidWorks API Object Model and Class Hierarchy
Collapse Programming with the SolidWorks APIProgramming with the SolidWorks API
Expand Add-insAdd-ins
API Dependent on SolidWorks Being Visible
Attributes Imported from ACIS SAT Files
Block Definitions and Block Instances
Bodies in Body Folders
Bounding Box and Note Text
COM vs. Dispatch
CommandManager and CommandGroups
Components, Configurations, and Suppression States
Compound Note
ComVisibleAttribute in VSTA macros
Controls, Visual Basic 6.0, and Windows XP
Expand Double Arrays and Integer PairsDouble Arrays and Integer Pairs
Drawing Views and Model Entities
Early and Late Binding
Expand EventsEvents
Features of Components
Helper Functions
Hole Wizard Features and Objects
IDispatch Object Arrays as Input in .NET
Implementation Guidelines
Import and Export File Options
In-process Methods
Instantiate ActiveX Controls as Tabs
Interface Pointers
Keystrokes and Accelerator Keys
Library Features and Objects
Lightweight Components
Line Attributes for View::GetPolyLinesAndCurves
Line Weights
Long vs. Integer
Expand Macro FeaturesMacro Features
Mass Properties
Expand Multibody PartsMultibody Parts
Option Explicit Statement
Partition Rollback and API Handles
Persistent Reference IDs
Presentation Transforms
Collapse PropertyManager PagesPropertyManager Pages
Using IPropertyManagerPage2
Controls on Multipage PropertyManager Page
.NET Interop Assemblies
Quick Tips and Bubble ToolTips
Return Values
Expand SafeArraysSafeArrays
Selection Criteria
Selection Lists
Selections that Define Features
Setup Project to Distribute SolidWorks Add-in
Smart Pointers
SolidWorks Objects
Sorting Tables
STL Container Classes and Smart Pointers
Suspend Automatic Rebuilds
swdisp.cpp and swdisp.h Files
System Options and Document Properties
Tessellation and Edges
Tracking IDs
Expand Type LibrariesType Libraries
VBA and SolidWorks x64
Unmanaged C+ and C++/CLI Code Differences
Examples and Projects
Expand SolidWorks API HelpSolidWorks API Help
Expand FeatureWorks API HelpFeatureWorks API Help
Expand SolidWorks Document Manager API HelpSolidWorks Document Manager API Help
Expand eDrawings API HelpeDrawings API Help
Expand SolidWorks Routing API HelpSolidWorks Routing API Help
Expand SolidWorks Simulation API HelpSolidWorks Simulation API Help
Expand SolidWorks Utilities API HelpSolidWorks Utilities API Help
Expand SolidWorks Workgroup PDM API HelpSolidWorks Workgroup PDM API Help
Hide Table of Contents

Using IPropertyManagerPage2 and the Related Objects

IPropertyManagerPage2 and related objects provide an add-in application with the ability to create a PropertyManager page with the same look and feel as SolidWorks PropertyManager pages. The SolidWorks API provides a series of standard controls that are managed by the SolidWorks application.

This topic explains:

What is available?

The SolidWorks API provides:

See Controls on Multipage PropertyManager Page for details about programming controls on a multipage PropertyManager page.

Back to top

What does the add-in have to do?

To take advantage of this functionality, the add-in application must:

  1. Implement an object that supports IPropertyManagerPage2Handler8.

  2. Call ISldWorks::CreatePropertyManagerPage to create the new page, including a pointer to the IPropertyManagerPage2Handler8 for that page.

  3. Use the pointer returned by ISldWorks::CreatePropertyManagerPage to add group boxes and controls to the new page using IPropertyManagerPage2::AddControl, IPropertyManagerPage2::AddGroupBox, and IPropertyManagerPageGroup::AddControl.

  4. Call IPropertyManagerPage2::Show to display the PropertyManager page in the user interface.

  5. Respond to events generated by the SolidWorks application (such as IPropertyManagerPage2Handler8::OnButtonPress or IPropertyManagerPage2Handler8::OnClose) to collect data that your user typed in the PropertyManager page and take action based on that data, if necessary.

  6. Destroy the IPropertyManagerPage2 object.

Back to top

What does the SolidWorks application do?

When you create a IPropertyManagerPage2 object, SolidWorks:

  1. Creates the PropertyManager page (not visible) and associates it with the specified IPropertyManagerPage2Handler8 in the add-in application.

  2. Makes calls to the IPropertyManagerPage2Handler8 based on end-user, initiated events.

  3. Closes the PropertyManager page in the user interface when the end-user clicks OK or Cancel, but does not destroy the IPropertyManagerPage2 object.

Back to top

IPropertyManagerPage2 states

The controls associated with IPropertyManagerPage2 have two distinct states: not visible and visible.

When the PropertyManager is not visible, the window does not exist. The only items that exist are the API objects. These objects hold onto only the default values that are set by the application before it displays the PropertyManager.

When the PropertyManager is visible, the objects represent the controls displayed in the PropertyManager window. When a given control is queried, the value represents the current setting of the control.

These states are important because if the end-user closes a PropertyManager page, you cannot  determine the user-specified value for the control. It is up to you to provide data exchange between your application and the controls while they are visible and before the PropertyManager page goes away.

Back to top


Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

Subject:   Feedback on Help Topics
Page:   Using PropertyManagerPage2
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:


We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again

Web Help Content Version: API Help (English only) 2012 SP05

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.