| ATK Library Reference Manual | |||
|---|---|---|---|
| <<< Previous Page | Home | Up | Next Page >>> |
struct AtkObject
{
GObject parent;
gchar *description;
gchar *name;
AtkObject *accessible_parent;
AtkRole role;
AtkRelationSet *relation_set;
AtkLayer layer;
}; |
typedef enum
{
ATK_ROLE_INVALID = 0,
ATK_ROLE_ACCEL_LABEL,
ATK_ROLE_ALERT,
ATK_ROLE_ANIMATION,
ATK_ROLE_ARROW,
ATK_ROLE_CALENDAR,
ATK_ROLE_CANVAS,
ATK_ROLE_CHECK_BOX,
ATK_ROLE_CHECK_MENU_ITEM,
ATK_ROLE_COLOR_CHOOSER,
ATK_ROLE_COLUMN_HEADER,
ATK_ROLE_COMBO_BOX,
ATK_ROLE_DATE_EDITOR,
ATK_ROLE_DESKTOP_ICON,
ATK_ROLE_DESKTOP_FRAME,
ATK_ROLE_DIAL,
ATK_ROLE_DIALOG,
ATK_ROLE_DIRECTORY_PANE,
ATK_ROLE_DRAWING_AREA,
ATK_ROLE_FILE_CHOOSER,
ATK_ROLE_FILLER,
ATK_ROLE_FONT_CHOOSER,
ATK_ROLE_FRAME,
ATK_ROLE_GLASS_PANE,
ATK_ROLE_HTML_CONTAINER,
ATK_ROLE_ICON,
ATK_ROLE_IMAGE,
ATK_ROLE_INTERNAL_FRAME,
ATK_ROLE_LABEL,
ATK_ROLE_LAYERED_PANE,
ATK_ROLE_LIST,
ATK_ROLE_LIST_ITEM,
ATK_ROLE_MENU,
ATK_ROLE_MENU_BAR,
ATK_ROLE_MENU_ITEM,
ATK_ROLE_OPTION_PANE,
ATK_ROLE_PAGE_TAB,
ATK_ROLE_PAGE_TAB_LIST,
ATK_ROLE_PANEL,
ATK_ROLE_PASSWORD_TEXT,
ATK_ROLE_POPUP_MENU,
ATK_ROLE_PROGRESS_BAR,
ATK_ROLE_PUSH_BUTTON,
ATK_ROLE_RADIO_BUTTON,
ATK_ROLE_RADIO_MENU_ITEM,
ATK_ROLE_ROOT_PANE,
ATK_ROLE_ROW_HEADER,
ATK_ROLE_SCROLL_BAR,
ATK_ROLE_SCROLL_PANE,
ATK_ROLE_SEPARATOR,
ATK_ROLE_SLIDER,
ATK_ROLE_SPLIT_PANE,
ATK_ROLE_SPIN_BUTTON,
ATK_ROLE_STATUSBAR,
ATK_ROLE_TABLE,
ATK_ROLE_TABLE_CELL,
ATK_ROLE_TABLE_COLUMN_HEADER,
ATK_ROLE_TABLE_ROW_HEADER,
ATK_ROLE_TEAR_OFF_MENU_ITEM,
ATK_ROLE_TERMINAL,
ATK_ROLE_TEXT,
ATK_ROLE_TOGGLE_BUTTON,
ATK_ROLE_TOOL_BAR,
ATK_ROLE_TOOL_TIP,
ATK_ROLE_TREE,
ATK_ROLE_TREE_TABLE,
ATK_ROLE_UNKNOWN,
ATK_ROLE_VIEWPORT,
ATK_ROLE_WINDOW,
ATK_ROLE_LAST_DEFINED
} AtkRole; |
Describes the role of an object
| ATK_ROLE_INVALID | Invalid role |
| ATK_ROLE_ACCEL_LABEL | A label which represents an accelerator |
| ATK_ROLE_ALERT | An object which is an alert to the user |
| ATK_ROLE_ANIMATION | An object which is an animated image |
| ATK_ROLE_ARROW | An arrow in one of the four cardinal directions |
| ATK_ROLE_CALENDAR | An object that displays a calendar and allows the user to select a date |
| ATK_ROLE_CANVAS | An object that can be drawn into and is used to trap events |
| ATK_ROLE_CHECK_BOX | A choice that can be checked or unchecked and provides a separate indicator for the current state |
| ATK_ROLE_CHECK_MENU_ITEM | A menu item with a check box |
| ATK_ROLE_COLOR_CHOOSER | A specialized dialog that lets the user choose a color |
| ATK_ROLE_COLUMN_HEADER | The header for a column of data |
| ATK_ROLE_COMBO_BOX | A list of choices the user can select from |
| ATK_ROLE_DATE_EDITOR | An object whose purpose is to allow a user to edit a date |
| ATK_ROLE_DESKTOP_ICON | An inconifed internal frame within a DESKTOP_PANE |
| ATK_ROLE_DESKTOP_FRAME | A pane that supports internal frames and iconified versions of those internal frames |
| ATK_ROLE_DIAL | An object whose purpose is to allow a user to set a value |
| ATK_ROLE_DIALOG | A top level window with title bar and a border |
| ATK_ROLE_DIRECTORY_PANE | A pane that allows the user to navigate through and select the contents of a directory |
| ATK_ROLE_DRAWING_AREA | An object used for drawing custom user interface elements |
| ATK_ROLE_FILE_CHOOSER | A specialized dialog that lets the user choose a file |
| ATK_ROLE_FILLER | A object that fills up space in a user interface |
| ATK_ROLE_FONT_CHOOSER | A specialized dialog that lets the user choose a font |
| ATK_ROLE_FRAME | A top level window with a title bar, border, menubar, etc. |
| ATK_ROLE_GLASS_PANE | A pane that is guaranteed to be painted on top of all panes beneath it |
| ATK_ROLE_HTML_CONTAINER | A document container for HTML, whose children represent the document content |
| ATK_ROLE_ICON | A small fixed size picture, typically used to decorate components |
| ATK_ROLE_IMAGE | An object whose primary purpose is to display an image |
| ATK_ROLE_INTERNAL_FRAME | A frame-like object that is clipped by a desktop pane |
| ATK_ROLE_LABEL | An object used to present an icon or short string in an interface |
| ATK_ROLE_LAYERED_PANE | A specialized pane that allows its children to be drawn in layers, providing a form of stacking order |
| ATK_ROLE_LIST | An object that presents a list of objects to the user and allows the user to select one or more of them |
| ATK_ROLE_LIST_ITEM | An object that represents an element of a list |
| ATK_ROLE_MENU | An object usually found inside a menu bar that contains a list of actions the user can choose from |
| ATK_ROLE_MENU_BAR | An object usually drawn at the top of the primary dialog box of an application that contains a list of menus the user can choose from |
| ATK_ROLE_MENU_ITEM | An object usually contained in a menu that presents an action the user can choose |
| ATK_ROLE_OPTION_PANE | A specialized pane whose primary use is inside a DIALOG |
| ATK_ROLE_PAGE_TAB | An object that is a child of a page tab list |
| ATK_ROLE_PAGE_TAB_LIST | An object that presents a series of panels (or page tabs), one at a time, through some mechanism provided by the object |
| ATK_ROLE_PANEL | A generic container that is often used to group objects |
| ATK_ROLE_PASSWORD_TEXT | A text object uses for passwords, or other places where the text content is not shown visibly to the user |
| ATK_ROLE_POPUP_MENU | A temporary window that is usually used to offer the user a list of choices, and then hides when the user selects one of those choices |
| ATK_ROLE_PROGRESS_BAR | An object used to indicate how much of a task has been completed |
| ATK_ROLE_PUSH_BUTTON | An object the user can manipulate to tell the application to do something |
| ATK_ROLE_RADIO_BUTTON | A specialized check box that will cause other radio buttons in the same group to become unchecked when this one is checked |
| ATK_ROLE_RADIO_MENU_ITEM | A check menu item which belongs to a group. At each instant exactly one of the radio menu items from a group is selected |
| ATK_ROLE_ROOT_PANE | A specialized pane that has a glass pane and a layered pane as its children |
| ATK_ROLE_ROW_HEADER | The header for a row of data |
| ATK_ROLE_SCROLL_BAR | An object usually used to allow a user to incrementally view a large amount of data. |
| ATK_ROLE_SCROLL_PANE | An object that allows a user to incrementally view a large amount of information |
| ATK_ROLE_SEPARATOR | An object usually contained in a menu to provide a visible and logical separation of the contents in a menu |
| ATK_ROLE_SLIDER | An object that allows the user to select from a bounded range |
| ATK_ROLE_SPLIT_PANE | A specialized panel that presents two other panels at the same time |
| ATK_ROLE_SPIN_BUTTON | An object used to get an integer or floating point number from the user |
| ATK_ROLE_STATUSBAR | An object which reports messages of minor importance to the user |
| ATK_ROLE_TABLE | An object used to represent information in terms of rows and columns |
| ATK_ROLE_TABLE_CELL | A cell in a table |
| ATK_ROLE_TABLE_COLUMN_HEADER | The header for a column of a table |
| ATK_ROLE_TABLE_ROW_HEADER | The header for a row of a table |
| ATK_ROLE_TEAR_OFF_MENU_ITEM | A menu item used to tear off and reattach its menu |
| ATK_ROLE_TERMINAL | An object that represents an accessible terminal |
| ATK_ROLE_TEXT | An object that presents text to the user |
| ATK_ROLE_TOGGLE_BUTTON | A specialized push button that can be checked or unchecked, but does not provide a separate indicator for the current state |
| ATK_ROLE_TOOL_BAR | A bar or palette usually composed of push buttons or toggle buttons |
| ATK_ROLE_TOOL_TIP | An object that provides information about another object |
| ATK_ROLE_TREE | An object used to represent hierarchical information to the user |
| ATK_ROLE_TREE_TABLE | An object capable of expanding and collapsing rows as well as showing multiple columns of data |
| ATK_ROLE_UNKNOWN | The object contains some Accessible information, but its role is not known |
| ATK_ROLE_VIEWPORT | An object usually used in a scroll pane |
| ATK_ROLE_WINDOW | A top level window with no title or border |
| ATK_ROLE_LAST_DEFINED | not a valid role, used for finding end of enumeration |
AtkRole atk_role_register (const gchar *name); |
Registers the role specified by name.
| name : | a character string describing the new role. |
| Returns : | an AtkRole for the new role. |
typedef enum
{
ATK_LAYER_INVALID,
ATK_LAYER_BACKGROUND,
ATK_LAYER_CANVAS,
ATK_LAYER_WIDGET,
ATK_LAYER_MDI,
ATK_LAYER_POPUP,
ATK_LAYER_OVERLAY
} AtkLayer; |
Describes the layer of a component
| ATK_LAYER_INVALID | The object does not have a layer |
| ATK_LAYER_BACKGROUND | This layer is reserved for the desktop background |
| ATK_LAYER_CANVAS | This layer is used for Canvas components |
| ATK_LAYER_WIDGET | This layer is normally used for components |
| ATK_LAYER_MDI | This layer is used for layered components |
| ATK_LAYER_POPUP | This layer is used for popup components, such as menus |
| ATK_LAYER_OVERLAY | This layer is reserved for future use. |
struct AtkImplementorIface
{
GTypeInterface parent;
AtkObject* (*ref_accessible) (AtkImplementor *implementor);
}; |
struct AtkPropertyValues
{
const gchar *property_name;
GValue old_value;
GValue new_value;
}; |
void (*AtkPropertyChangeHandler) (AtkObject*, AtkPropertyValues*); |
| Param1 : | |
| Param2 : |
AtkObject* atk_implementor_ref_accessible (AtkImplementor *implementor); |
Gets a reference to an object's AtkObject implementation, if the object implements AtkObjectIface
| implementor : | The GObject instance which should implement AtkImplementorIface if a non-null return value is required. |
| Returns : | a reference to an object's AtkObject implementation |
G_CONST_RETURN gchar* atk_object_get_name (AtkObject *accessible); |
Gets the accessible name of the accessible.
| accessible : | an AtkObject |
| Returns : | a character string representing the accessible name of the object. |
G_CONST_RETURN gchar* atk_object_get_description (AtkObject *accessible); |
Gets the accessible description of the accessible.
| accessible : | an AtkObject |
| Returns : | a character string representing the accessible description of the accessible. |
AtkObject* atk_object_get_parent (AtkObject *accessible); |
Gets the accessible parent of the accessible.
gint atk_object_get_n_accessible_children (AtkObject *accessible); |
Gets the number of accessible children of the accessible.
| accessible : | an AtkObject |
| Returns : | an integer representing the number of accessible children of the accessible. |
AtkObject* atk_object_ref_accessible_child (AtkObject *accessible, gint i); |
Gets a reference to the specified accessible child of the object. The accessible children are 0-based so the first accessible child is at index 0, the second at index 1 and so on.
AtkRelationSet* atk_object_ref_relation_set (AtkObject *accessible); |
Gets the AtkRelationSet associated with the object.
| accessible : | an AtkObject |
| Returns : | an AtkRelationSet representing the relation set of the object. |
AtkLayer atk_object_get_layer (AtkObject *accessible); |
Gets the layer of the accessible.
gint atk_object_get_mdi_zorder (AtkObject *accessible); |
Gets the zorder of the accessible. The value G_MININT will be returned if the layer of the accessible is not ATK_LAYER_MDI.
| accessible : | an AtkObject |
| Returns : | a gint which is the zorder of the accessible, i.e. the depth at which the component is shown in relation to other components in the same container. |
AtkRole atk_object_get_role (AtkObject *accessible); |
Gets the role of the accessible.
AtkStateSet* atk_object_ref_state_set (AtkObject *accessible); |
Gets a reference to the state set of the accessible; the caller must unreference it when it is no longer needed.
| accessible : | an AtkObject |
| Returns : | a reference to an AtkStateSet which is the state set of the accessible |
gint atk_object_get_index_in_parent (AtkObject *accessible); |
Gets the 0-based index of this accessible in its parent; returns -1 if the accessible does not have an accessible parent.
| accessible : | an AtkObject |
| Returns : | an integer which is the index of the accessible in its parent |
void atk_object_set_name (AtkObject *accessible, const gchar *name); |
Sets the accessible name of the accessible.
| accessible : | an AtkObject |
| name : | a character string to be set as the accessible name |
void atk_object_set_description (AtkObject *accessible, const gchar *description); |
Sets the accessible description of the accessible.
| accessible : | an AtkObject |
| description : | a character string to be set as the accessible description |
void atk_object_set_parent (AtkObject *accessible, AtkObject *parent); |
Sets the accessible parent of the accessible.
void atk_object_set_role (AtkObject *accessible, AtkRole role); |
Sets the role of the accessible.
guint atk_object_connect_property_change_handler (AtkObject *accessible, AtkPropertyChangeHandler *handler); |
Specifies a function to be called when a property changes value.
| accessible : | an AtkObject |
| handler : | a function to be called when a property changes its value |
| Returns : | a guint which is the handler id used in atk_object_remove_property_change_handler() |
void atk_object_remove_property_change_handler
(AtkObject *accessible,
guint handler_id); |
Removes a property change handler.
| accessible : | an AtkObject |
| handler_id : | a guint which identifies the handler to be removed. |
void atk_object_notify_state_change (AtkObject *accessible, AtkState state, gboolean value); |
Emits a state-change signal for the specified state.
void atk_object_initialize (AtkObject *accessible, gpointer data); |
This function is called when implementing subclasses of AtkObject. It does initialization required for the new object. It is intended that this function should called only in the ..._new() functions used to create an instance of a subclass of AtkObject
G_CONST_RETURN gchar* atk_role_get_name (AtkRole role); |
Gets the description string describing the Roleype role.
| role : | The AtkRole whose name is required |
| Returns : | the string describing the AtkRole |
AtkRole atk_role_for_name (const gchar *name); |
Get the AtkRole type corresponding to a rolew name.
| name : | a string which is the (non-localized) name of an ATK role. |
| Returns : | the AtkRole enumerated type corresponding to the specified name, or ATK_ROLE_INVALID if no matching role is found. |