atk.Component the ATK interface provided by UI components that occupy a physical area on the screen. atk.Component gobject.GInterface contains x y coord_type ref_accessible_at_point x y coord_type get_extents coord_type get_position coord_type get_size grab_focus remove_focus_handler handler_id set_extents x y width height coord_type set_position x y coord_type set_size width height get_layer get_mdi_zorder "bounds-changed" callback atkcomponent rect user_param1 ... atk.Component should be implemented by most if not all UI elements with an actual on-screen presence, i.e. components which can be said to have a screen-coordinate bounding box. Virtually all widgets will need to have atk.Component implementations provided for their corresponding atk.Object class. In short, only UI elements which are *not* GUI elements will omit this ATK interface. A possible exception might be textual information with a transparent background, in which case text glyph bounding box information is provided by atk.Text. contains x y coord_type x : x coordinate y : y coordinate coord_type : specifies whether the coordinates are relative to the screen or to the components top level window - one of the Returns : True or False indicating whether the specified point is within the extent of the component or not Checks whether the specified point is within the extent of the component. ref_accessible_at_point x y coord_type x : x coordinate y : y coordinate coord_type : specifies whether the coordinates are relative to the screen or to the components top level window - one of the Returns : an atk.Object reference to the accessible child, if one exists Gets a reference to the accessible child, if one exists, at the coordinate point specified by x and y. get_extents coord_type coord_type : specifies whether the coordinates are relative to the screen or to the components top level window - one of the Returns : a 4-tuple containing the x, y position coordinates and the width and height of the component. Gets the rectangle which gives the extent of the component. get_position coord_type coord_type : specifies whether the coordinates are relative to the screen or to the components top level window - one of the Returns : a 2-tuple containing the x, y position coordinates of the component. Gets the position of the component in the form of a point specifying the component's top-left corner. get_size Returns : a 2-tuple containing the width and height of the component. Gets the size of the component in terms of width and height. grab_focus Returns : True if successful, False otherwise. Grabs focus for this component. remove_focus_handler handler_id handler_id : the handler id of the focus handler to be removed from component Remove the handler specified by handler_id from the list of functions to be executed when this object receives focus events (in or out). set_extents x y width height coord_type x : x coordinate y : y coordinate width : width to set for the component height : height to set for the component coord_type : specifies whether the coordinates are relative to the screen or to the components top level window - one of the Returns : True if the extents were set Sets the extents of the component. set_position x y coord_type x : x coordinate y : y coordinate coord_type : specifies whether the coordinates are relative to the screen or to the components top level window - one of the Returns : True if the position was set Sets the postition of the component. set_size width height width : width to set for component height : height to set for component Returns : True if the size was set Set the size of the component in terms of width and height. get_layer Returns : one of the which is the layer of the component Gets the layer of the component. get_mdi_zorder Returns : an integer which is the zorder of the component, i.e. the depth at which the component is shown in relation to other components in the same container. Gets the zorder of the component. The value G_MININT will be returned if the layer of the component is not atk.LAYER_MDI or atk.LAYER_WINDOW. callback atkcomponent rect user_param1 ... atkcomponent : the object which received the signal. rect : The atk.Rectangle giving the new position and size. user_param1 : the first user parameter (if any) specified with the connect() method ... : additional user parameters (if any) The 'bounds-changed" signal is emitted when the bposition or size of the a component changes.