PopupEntitySelection(EntityCapabilities,Boolean,Int32,Boolean,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 excludedEntID As Integer, _
ByVal includeEmptyNode As Boolean, _
ByRef entID As Integer, _
ByRef entName As String, _
ByRef entList As String _
) As Boolean
public static bool PopupEntitySelection(
Utility.EntityCapabilities capability,
bool AllowMultipleEntitySelection,
int excludedEntID,
bool includeEmptyNode,
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.
- excludedEntID
- Required. Holds the ID of the entity to be excluded from selection even if it holds the specified capability.
- 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.
- 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.