Ets_Ctl_Domain_Object_By_Point_Get()
Note: Requires OPNET Development Kit
Abstract
Gets the topmost object of the desired type in the network domain at the given control-based coordinates.
Syntax
Ets_Ctl_Domain_Object_By_Point_Get (dom_ctl_ptr, hit_point, ets_type)
| Argument | Type | Description |
|---|---|---|
dom_ctl_ptr |
EtsT_Ctl * |
Domain control of interest. |
hit_point |
const EtsT_Point * |
Point in the specified domain at which to get the topmost object. |
ets_type |
EtsT_Obj_Type |
Type of object to get; must be EtsC_Obj_Mtype_Link or EtsC_Obj_Mtype_Site. |
Return Type
EtsT_Obj_Handle
Handle to the matching object. An invalid object handle is returned if there is no object at hit_point, dom_ctl_ptr is null or does not contain a subnet, or ets_type is not a permitted type.
Header
ets_api_ctl_dom.h
Details
hit_point is a position in the specified domain control (dom_ctl_ptr). The position is given by x,y coordinates within the control; units are in pixels relative to the control origin. EtsT_Point is defined as:
struct EtsT_Point
{
int pos_x;
int pos_y;
};