PopupEntitySelection(EntityCapabilities,Boolean,Boolean,EntityFilterRestrictionType,Int32,String,String) Method
- Last UpdatedNov 06, 2025
- 2 minute read
The PopupEntitySelection() method opens the Entity dialog, which allows entities to be selected based on a specified capability.
For this overload of the method:
- All entities in the entity tree can be seen, but only entities with the specified capability can be selected.
- A flag specifies whether multiple entities can be selected.
- One entity can be singled out to be unselectable even if the entity has the specified capability.
- An empty node can optionally be inserted at the beginning of the tree (to allow for selection of 'No Entity').
'Declaration
Public Overloads Shared Function PopupEntitySelection( _
ByVal capability As Utility.EntityCapabilities, _
ByVal AllowMultipleEntitySelection As Boolean, _
ByVal includeEmptyNode As Boolean, _
ByVal restriction As EntityFilterRestrictionType, _
ByRef entID As Integer, _
ByRef entName As String, _
ByRef entList As String _
) As Boolean
public static bool PopupEntitySelection(
Utility.EntityCapabilities capability,
bool AllowMultipleEntitySelection,
bool includeEmptyNode,
EntityFilterRestrictionType restriction,
out int entID,
out string entName,
out string entList
)
Parameters
- capability
- Required. Holds the capability the entity must have to be selected.
- AllowMultipleEntitySelection
- Required. Holds a flag that, if set to true, specifies that multiple entities can be selected. If set to false, only one entity can be selected.
- includeEmptyNode
- Required. Holds a flag that, if set to true, causes an empty node to be included at the top of the entity tree in the dialog. This allows for 'No Entity' to be selected by the user.
- restriction
- Required. Holds an enumerated type for restricting what entities are allowed to be selectabled on the entity selection dialog.
- entID
- Output. Returns the ID of the selected entity.
- entName
- Output. Returns the name of the selected entity.
- entList
- Output. If AllowMultipleEntitySelection is true, the method returns a comma-separated list of the entity IDs (ent_id) that are selected in the Entity tree. If AllowMultipleEntitySelection is false, then the ID of the selected entity is returned.
Return Value
Returns true if the user selects at least one entity.