Function OnSubmitSelection( _
   ByVal Id As System.Integer, _
   ByVal Selection As System.Object, _
   ByVal SelType As System.Integer, _
   ByRef ItemText As System.String _
) As System.Boolean

Dim instance As IPropertyManagerPage2Handler9
Dim Id As System.Integer
Dim Selection As System.Object
Dim SelType As System.Integer
Dim ItemText As System.String
Dim value As System.Boolean
 
value = instance.OnSubmitSelection(Id, Selection, SelType, ItemText)

System.bool OnSubmitSelection( 
   System.int Id,
   System.object Selection,
   System.int SelType,
   out System.string ItemText
)

System.bool OnSubmitSelection( 
&   System.int Id,
&   System.Object^ Selection,
&   System.int SelType,
&   [Out] System.String^ ItemText
) 

Parameters

Id

ID of the active selection box, where this selection is being made

Selection

Object being selected

SelType

Entity type of the selection as defined in swSelectType_e

ItemText

Item for selection list box (see Remarks)

If writing a macro, you must set this method to true for the user to select something (see the examples). If this method is not set to true, then the user cannot select anything. This method is set to false by default.

This method is called by SolidWorks when an add-in has a PropertyManager page displayed and a selection is made that passes the selection filter criteria set up for a selection list box. The add-in can then:

• Take the Dispatch pointer and the selection type.
• QueryInterface the Dispatch pointer to get the specific interface.
• Use APIs of that interface to determine if the selection should be allowed or not.  

  • If the selection is accepted, return True, and processing will continue normally.
    
    - or -
     

  • If the selection is rejected, return false, and SolidWorks will not accept the selection, just as if the selection did not pass the selection filter criteria of the selection list box.  

The add-in should not Release() the Dispatch pointer. SolidWorks will Release() the Dispatch pointer upon return from this method.

The method is called during the process of SolidWorks selection. It is neither a pre-notification nor post-notification. The add-in should not be taking any action that might affect the model or the selection list. The add-in should only be querying information and then returning true/VARIANT_TRUE or false/VARIANT_FALSE.

ItemText is returned to SolidWorks and stored on the selected object and can be used by your PropertyManager page selection list boxes for the life of that selection.