Provides a default (non-functioning stub)AtkObject.Application maintainers should not use this method.

Please see AtkObject for a full list of methods.

Please see GObject for a full list of methods.

Perform the specified action on the object.

Returns a description of the specified action of the object.

Gets the keybinding which can be used to activate this action, if oneexists. The string returned should contain localized, human-readable,key sequences as they would appear when displayed on screen. It mustbe in the format “mnemonic;sequence;shortcut”.

Returns the localized name of the specified action of the object.

Gets the number of accessible actions available on the object.If there are more than one, the first one is considered the“default” action of the object.

Returns a non-localized string naming the specified action of theobject. This name is generally not descriptive of the end resultof the action, but instead names the ‘interaction type’ which theobject supports. By convention, the above strings should be used torepresent the actions which correspond to the common point-and-clickinteraction techniques of the same name: i.e.“click”, “press”, “release”, “drag”, “drop”, “popup”, etc.The “popup” action should be used to pop up a context menu for theobject, if one exists.

Sets a description of the specified action of the object.

Add the specified handler to the set of functions to be calledwhen this object receives focus events (in or out). If the handler isalready added it is not added again.

deprecated: 2.9.4 

Checks whether the specified point is within the extent of thecomponent.

Returns the alpha value (i.e. the opacity) for thiscomponent, on a scale from 0 (fully transparent) to 1.0(fully opaque).

since: 1.12

Gets the rectangle which gives the extent of thecomponent.

Gets the layer of the component.

Gets the zorder of the component. The value G_MININT will be returnedif the layer of the component is not ATK_LAYER_MDI or ATK_LAYER_WINDOW.

Gets the position ofcomponent in the form ofa point specifyingcomponent‘s top-left corner.

deprecated: Unknown 

Gets the size of thecomponent in terms of width and height.

deprecated: Unknown 

Grabs focus for thiscomponent.

Gets a reference to the accessible child, if one exists, at thecoordinate point specified byx andy.

Remove the handler specified byhandler_id from the list offunctions to be executed when this object receives focus events(in or out).

deprecated: 2.9.4 

Makescomponent visible on the screen by scrolling all necessary parents.

since: 2.30

Move the top-left ofcomponent to a given position of the screen byscrolling all necessary parents.

since: 2.30

Sets the extents ofcomponent.

Sets the position ofcomponent.

Set the size of thecomponent in terms of width and height.

Retrieves the value of the givenattribute_name insidedocument.

since: 1.12

Gets an AtkAttributeSet which describes document-wide attributes as name-value pairs.

since: 1.12

Retrieves the current page number insidedocument.

since: 2.12

Gets a %gpointer that points to an instance of theDOM. It isup to the caller to check atk_document_get_type to determinehow to cast this pointer.

deprecated: Unknown 

Gets a string indicating the document type.

deprecated: Unknown 

Gets aUTF-8 string indicating thePOSIX-style LC_MESSAGES locale of the content of this document instance. Individual text substrings or images within this document may have a different locale, see atk_text_get_attributes and atk_image_get_image_locale.

deprecated: 2.7.90 

Retrieves the total number of pages insidedocument.

since: 2.12

Returns an array of AtkTextSelections within this document.

since: 2.52

Sets the value for the givenattribute_name insidedocument.

since: 1.12

Makes 1 or more selections within this document denoted by the givenarray of AtkTextSelections. Any existing physical selection (inside oroutside this document) is replaced by the new selections. All objects withinthe given selection ranges must be descendants of this document. OtherwiseFALSE will be returned.

since: 2.52

Copy text fromstart_pos up to, but not includingend_posto the clipboard.

Copy text fromstart_pos up to, but not includingend_posto the clipboard and then delete from the widget.

Delete textstart_pos up to, but not includingend_pos.

Insert text at a given position.

Paste text from clipboard to specifiedposition.

Sets the attributes for a specified range. See the ATK_ATTRIBUTEmacros (such as #ATK_ATTRIBUTE_LEFT_MARGIN) for examples of attributesthat can be set. Note that other attributes that do not have correspondingATK_ATTRIBUTE macros may also be set for certain text widgets.

Set text contents oftext.

Gets the link in this hypertext document at indexlink_index.

Gets the index into the array of hyperlinks that is associated withthe character specified bychar_index.

Gets the number of links within this hypertext document.

Get a textual description of this image.

Retrieves the locale identifier associated to theAtkImage.

since: 1.12

Gets the position of the image in the form of a point specifying theimages top-left corner.

Get the width and height in pixels for the specified image.The values ofwidth andheight are returned as -1 if thevalues cannot be obtained (for instance, if the object is not onscreen).

Sets the textual description for this image.

Adds the specified accessible child of the object to theobject’s selection.

Clears the selection in the object so that no children in the objectare selected.

Gets the number of accessible children currently selected.Note: callers should not rely onNULL or on a zero value forindication of whether AtkSelectionIface is implemented, they shoulduse type checking/interface checking macros or theatk_get_accessible_value() convenience method.

Determines if the current child of this object is selectedNote: callers should not rely onNULL or on a zero value forindication of whether AtkSelectionIface is implemented, they shoulduse type checking/interface checking macros or theatk_get_accessible_value() convenience method.

Gets a reference to the accessible object representing the specifiedselected child of the object.Note: callers should not rely onNULL or on a zero value forindication of whether AtkSelectionIface is implemented, they shoulduse type checking/interface checking macros or theatk_get_accessible_value() convenience method.

Removes the specified child of the object from the object’s selection.

Causes every child of the object to be selected if the objectsupports multiple selections.

Please see AtkTable for a full list of methods.

Returns the column headers as an array of cell accessibles.

since: 2.12

Returns the number of columns occupied by this cell accessible.

since: 2.12

Retrieves the tabular position of this cell.

since: 2.12

Gets the row and column indexes and span of this cell accessible.

since: 2.12

Returns the row headers as an array of cell accessibles.

since: 2.12

Returns the number of rows occupied by this cell accessible.

since: 2.12

Returns a reference to the accessible of the containing table.

since: 2.12

Adds a selection bounded by the specified offsets.

Get the ranges of text in the specified bounding box.

since: 1.3

Gets the offset of the position of the caret (cursor).

Gets the specified text.

Gets the character count.

If the extent can not be obtained (e.g. missing support), all of x, y, width,height are set to -1.

Creates anAtkAttributeSet which consists of the default values ofattributes for the text. See the enum AtkTextAttribute for types of textattributes that can be returned. Note that other attributes may also be returned.

Gets the number of selected regions.

Gets the offset of the character located at coordinatesx andy.x andyare interpreted as being relative to the screen or this widget’s windowdepending oncoords.

Get the bounding box for text within the specified range.

since: 1.3

Creates anAtkAttributeSet which consists of the attributes explicitlyset at the positionoffset in the text.start_offset andend_offset areset to the start and end of the range aroundoffset where the attributes areinvariant. Note thatend_offset is the offset of the first characterafter the range. See the enum AtkTextAttribute for types of textattributes that can be returned. Note that other attributes may also be returned.

Gets the text from the specified selection.

Gets a portion of the text exposed through anAtkText according to a givenoffsetand a specificgranularity, along with the start and end offsets defining theboundaries of such a portion of text.

since: 2.10

Gets the specified text.

Gets the specified text.

deprecated: 2.9.3 

Gets the specified text.

deprecated: Unknown 

Gets the specified text.

deprecated: 2.9.3 

Removes the specified selection.

Makes a substring oftext visible on the screen by scrolling all necessary parents.

since: 2.32

Move the top-left of a substring oftext to a given position of the screenby scrolling all necessary parents.

since: 2.32

Sets the caret (cursor) position to the specifiedoffset.

Changes the start and end offset of the specified selection.

Gets the value of this object.

deprecated: Unknown 

Gets the minimum increment by which the value of this object may bechanged. If zero, the minimum increment is undefined, which maymean that it is limited only by the floating point precision of the platform.

since: 2.12

Gets the maximum value of this object.

deprecated: Unknown 

Gets the minimum increment by which the value of this object may be changed. If zero,the minimum increment is undefined, which may mean that it is limited only by thefloating point precision of the platform.

deprecated: Unknown since: 1.12

Gets the minimum value of this object.

deprecated: Unknown 

Gets the range of this object.

since: 2.12

Gets the list of subranges defined for this object. SeeAtkValueintroduction for examples of subranges and when to expose them.

since: 2.12

Gets the current value and the human readable text alternative ofobj.text is a newly created string, that must be freed by thecaller. Can beNULL if no descriptor is available.

since: 2.12

Sets the value of this object.

deprecated: Unknown 

Sets the value of this object.

since: 2.12

Table caption.

deprecated: Unknown 

Accessible table column description.

deprecated: Unknown 

Accessible table column header.

deprecated: Unknown 

Accessible table row description.

deprecated: Unknown 

Accessible table row header.

deprecated: Unknown 

Numeric value of this object, in case being and AtkValue.

deprecated: Unknown 

The “active-descendant-changed” signal is emitted by an objectwhich has the state ATK_STATE_MANAGES_DESCENDANTS when the focusobject in the object changes. For instance, a table will emit thesignal when the cell in the table which has focus changes.

The “announcement” signal can be emitted to pass an announcement on tobe read by a screen reader.

since: 2.46

The “attribute-changed” signal should be emitted when one of an object’sattributes changes.

since: 2.52

The signal “children-changed” is emitted when a child is added orremoved from an object. It supports two details: “add” and “remove”.

The signal “focus-event” is emitted when an object gained or lost focus.

deprecated: 2.9.4 

The “notification” signal can be emitted to pass an announcement on tobe read by a screen reader.

since: 2.50

The signal “property-change” is emitted when an object’s propertyvalue changes.arg1 contains anAtkPropertyValues with the nameand the new value of the property whose value has changed. Notethat, as with GObject notify, getting this signal does notguarantee that the value of the property has actually changed; itmay also be emitted when the setter of the property is called toreinstate the previous value.

The “state-change” signal is emitted when an object’s statechanges. The detail value identifies the state type which has changed.

The “visible-data-changed” signal is emitted when the visualappearance of the object changed.

The notify signal is emitted on an object when one of its properties hasits value set through g_object_set_property(), g_object_set(), et al.

The ‘bounds-changed” signal is emitted when the position orsize of the component changes.

The “document-attribute-changed” signal should be emitted when there is achange to one of the document attributes returned by atk_document_get_attributes.

since: 2.52

The ‘load-complete’ signal is emitted when a pending load ofa static document has completed. This signal is to beexpected byATK clients if and when AtkDocument implementorsexpose ATK_STATE_BUSY. If the state of an AtkObject whichimplements AtkDocument does not include ATK_STATE_BUSY, itshould be safe for clients to assume that the AtkDocument’sstatic contents are fully loaded into the container.(Dynamic document contents should be exposed via other signals.).

The ‘load-stopped’ signal is emitted when a pending load ofdocument contents is cancelled, paused, or otherwiseinterrupted by the user or application logic. It should nothowever be emitted while waiting for a resource (for instancewhile blocking on a file or network read) unless auser-significant timeout has occurred.

The ‘page-changed’ signal is emitted when the current page ofa document changes, e.g. pressing page up/down in a document viewer.

since: 2.12

The ‘reload’ signal is emitted when the contents of adocument is refreshed from its source. Once ‘reload’ hasbeen emitted, a matching ‘load-complete’ or ‘load-stopped’signal should follow, which clients may await beforeinterrogatingATK for the latest document content.

The “link-selected” signal is emitted by an AtkHyperTextobject when one of the hyperlinks associated with the objectis selected.

The “selection-changed” signal is emitted by an object whichimplements AtkSelection interface when the selection changes.

The “column-deleted” signal is emitted by an object whichimplements the AtkTable interface when a column is deleted.

The “column-inserted” signal is emitted by an object whichimplements the AtkTable interface when a column is inserted.

The “column-reordered” signal is emitted by an object whichimplements the AtkTable interface when the columns are reordered.

The “model-changed” signal is emitted by an object whichimplements the AtkTable interface when the model displayed bythe table changes.

The “row-deleted” signal is emitted by an object whichimplements the AtkTable interface when a row is deleted.

The “row-inserted” signal is emitted by an object whichimplements the AtkTable interface when a row is inserted.

The “row-reordered” signal is emitted by an object whichimplements the AtkTable interface when the rows are reordered.

The “text-attributes-changed” signal is emitted when the textattributes of the text of an object which implements AtkText changes.

The “text-caret-moved” signal is emitted when the caretposition of the text of an object which implements AtkText changes.

The “text-changed” signal is emitted when the text of theobject which implements the AtkText interface changes, Thissignal will have a detail which is either “insert” or“delete” which identifies whether the text change was aninsertion or a deletion.

deprecated: 2.9.4 

The “text-insert” signal is emitted when a new text isinserted. If the signal was not triggered by the user(e.g. typing or pasting text), the “system” detail should be included.

The “text-remove” signal is emitted when a new text isremoved. If the signal was not triggered by the user(e.g. typing or pasting text), the “system” detail should be included.

The “text-selection-changed” signal is emitted when theselected text of an object which implements AtkText changes.

The ‘value-changed’ signal is emitted when the current valuethat represent the object changes.value is the numericalrepresentation of this new value.text is the humanreadable text alternative ofvalue, and can beNULL if it isnot available. Note that if there is a textual descriptionassociated with the new numeric value, that descriptionshould be included regardless of whether or not it has also changed.

since: 2.12

The signalAtkWindow::activate is emitted when a windowbecomes the active window of the application or session.

since: 2.2

The signalAtkWindow::create is emitted when a new windowis created.

since: 2.2

The signalAtkWindow::deactivate is emitted when a window isno longer the active window of the application or session.

since: 2.2

The signalAtkWindow::destroy is emitted when a window is destroyed.

since: 2.2

The signalAtkWindow::maximize is emitted when a windowis maximized.

since: 2.2

The signalAtkWindow::minimize is emitted when a windowis minimized.

since: 2.2

The signalAtkWindow::move is emitted when a windowis moved.

since: 2.2

The signalAtkWindow::resize is emitted when a windowis resized.

since: 2.2

The signalAtkWindow::restore is emitted when a windowis restored.

since: 2.2