atk.Component — the ATK interface provided by UI components that occupy a physical area on the screen.
class atk.Component(gobject.GInterface): |
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
.
def contains(x
, y
, coord_type
)
| x coordinate |
| y coordinate |
| specifies whether the coordinates are relative to the screen or to the components top level window - one of the Atk Coord Type Constants |
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
.
def ref_accessible_at_point(x
, y
, coord_type
)
| x coordinate |
| y coordinate |
| specifies whether the coordinates are relative to the screen or to the components top level window - one of the Atk Coord Type Constants |
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
.
def get_extents(coord_type
)
| specifies whether the coordinates are relative to the screen or to the components top level window - one of the Atk Coord Type Constants |
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.
def get_position(coord_type
)
| specifies whether the coordinates are relative to the screen or to the components top level window - one of the Atk Coord Type Constants |
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.
def 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.
def grab_focus()
Returns : | True if successful,
False otherwise. |
Grabs focus for this component.
def remove_focus_handler(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).
def set_extents(x
, y
, width
, height
, coord_type
)
| x coordinate |
| y coordinate |
| width to set for the component |
| height to set for the component |
| specifies whether the coordinates are relative to the screen or to the components top level window - one of the Atk Coord Type Constants |
Returns : | True if the extents were
set |
Sets the extents of the component.
def set_position(x
, y
, coord_type
)
| x coordinate |
| y coordinate |
| specifies whether the coordinates are relative to the screen or to the components top level window - one of the Atk Coord Type Constants |
Returns : | True if the position was
set |
Sets the postition of the component.
def set_size(width
, height
)
| width to set for component |
| height to set for component |
Returns : | True if the size was
set |
Set the size of the component in terms of width and height.
def get_layer()
Returns : | one of the Atk Layer Constants which is the layer of the component |
Gets the layer of the component.
def 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
.
def callback(atkcomponent
, rect
, user_param1
, ...
)
| the object which received the signal. |
| The atk.Rectangle
giving the new position and size. |
| the first user parameter (if any) specified
with the connect () |
| additional user parameters (if any) |
The 'bounds-changed" signal is emitted when the bposition or size of the a component changes.