mirror of
https://github.com/Theaninova/TheaninovOS.git
synced 2025-12-13 03:56:24 +00:00
8272 lines
338 KiB
TypeScript
8272 lines
338 KiB
TypeScript
|
|
/*
|
|
* Type Definitions for Gjs (https://gjs.guide/)
|
|
*
|
|
* These type definitions are automatically generated, do not edit them by hand.
|
|
* If you found a bug fix it in `ts-for-gir` or create a bug report on https://github.com/gjsify/ts-for-gir
|
|
*/
|
|
|
|
import './atk-1.0-ambient.d.ts';
|
|
import './atk-1.0-import.d.ts';
|
|
/**
|
|
* Atk-1.0
|
|
*/
|
|
|
|
import type GObject from '@girs/gobject-2.0';
|
|
import type GLib from '@girs/glib-2.0';
|
|
|
|
/**
|
|
* Specifies how xy coordinates are to be interpreted. Used by functions such
|
|
* as atk_component_get_position() and atk_text_get_character_extents()
|
|
*/
|
|
export enum CoordType {
|
|
/**
|
|
* specifies xy coordinates relative to the screen
|
|
*/
|
|
SCREEN,
|
|
/**
|
|
* specifies xy coordinates relative to the widget's
|
|
* top-level window
|
|
*/
|
|
WINDOW,
|
|
/**
|
|
* specifies xy coordinates relative to the widget's
|
|
* immediate parent. Since: 2.30
|
|
*/
|
|
PARENT,
|
|
}
|
|
/**
|
|
* Specifies the type of a keyboard evemt.
|
|
*/
|
|
export enum KeyEventType {
|
|
/**
|
|
* specifies a key press event
|
|
*/
|
|
PRESS,
|
|
/**
|
|
* specifies a key release event
|
|
*/
|
|
RELEASE,
|
|
/**
|
|
* Not a valid value; specifies end of enumeration
|
|
*/
|
|
LAST_DEFINED,
|
|
}
|
|
/**
|
|
* Describes the layer of a component
|
|
*
|
|
* These enumerated "layer values" are used when determining which UI
|
|
* rendering layer a component is drawn into, which can help in making
|
|
* determinations of when components occlude one another.
|
|
*/
|
|
export enum Layer {
|
|
/**
|
|
* The object does not have a layer
|
|
*/
|
|
INVALID,
|
|
/**
|
|
* This layer is reserved for the desktop background
|
|
*/
|
|
BACKGROUND,
|
|
/**
|
|
* This layer is used for Canvas components
|
|
*/
|
|
CANVAS,
|
|
/**
|
|
* This layer is normally used for components
|
|
*/
|
|
WIDGET,
|
|
/**
|
|
* This layer is used for layered components
|
|
*/
|
|
MDI,
|
|
/**
|
|
* This layer is used for popup components, such as menus
|
|
*/
|
|
POPUP,
|
|
/**
|
|
* This layer is reserved for future use.
|
|
*/
|
|
OVERLAY,
|
|
/**
|
|
* This layer is used for toplevel windows.
|
|
*/
|
|
WINDOW,
|
|
}
|
|
/**
|
|
* Enumeration used to indicate a type of live region and how assertive it
|
|
* should be in terms of speaking notifications. Currently, this is only used
|
|
* for "notification" events, but it may be used for additional purposes
|
|
* in the future.
|
|
*/
|
|
export enum Live {
|
|
/**
|
|
* No live region.
|
|
*/
|
|
NONE,
|
|
/**
|
|
* This live region should be considered polite.
|
|
*/
|
|
POLITE,
|
|
/**
|
|
* This live region should be considered assertive.
|
|
*/
|
|
ASSERTIVE,
|
|
}
|
|
/**
|
|
* Describes the type of the relation
|
|
*/
|
|
export enum RelationType {
|
|
/**
|
|
* Not used, represens "no relationship" or an error condition.
|
|
*/
|
|
NULL,
|
|
/**
|
|
* Indicates an object controlled by one or more target objects.
|
|
*/
|
|
CONTROLLED_BY,
|
|
/**
|
|
* Indicates an object is an controller for one or more target objects.
|
|
*/
|
|
CONTROLLER_FOR,
|
|
/**
|
|
* Indicates an object is a label for one or more target objects.
|
|
*/
|
|
LABEL_FOR,
|
|
/**
|
|
* Indicates an object is labelled by one or more target objects.
|
|
*/
|
|
LABELLED_BY,
|
|
/**
|
|
* Indicates an object is a member of a group of one or more target objects.
|
|
*/
|
|
MEMBER_OF,
|
|
/**
|
|
* Indicates an object is a cell in a treetable which is displayed because a cell in the same column is expanded and identifies that cell.
|
|
*/
|
|
NODE_CHILD_OF,
|
|
/**
|
|
* Indicates that the object has content that flows logically to another
|
|
* AtkObject in a sequential way, (for instance text-flow).
|
|
*/
|
|
FLOWS_TO,
|
|
/**
|
|
* Indicates that the object has content that flows logically from
|
|
* another AtkObject in a sequential way, (for instance text-flow).
|
|
*/
|
|
FLOWS_FROM,
|
|
/**
|
|
* Indicates a subwindow attached to a component but otherwise has no connection in the UI heirarchy to that component.
|
|
*/
|
|
SUBWINDOW_OF,
|
|
/**
|
|
* Indicates that the object visually embeds
|
|
* another object's content, i.e. this object's content flows around
|
|
* another's content.
|
|
*/
|
|
EMBEDS,
|
|
/**
|
|
* Reciprocal of %ATK_RELATION_EMBEDS, indicates that
|
|
* this object's content is visualy embedded in another object.
|
|
*/
|
|
EMBEDDED_BY,
|
|
/**
|
|
* Indicates that an object is a popup for another object.
|
|
*/
|
|
POPUP_FOR,
|
|
/**
|
|
* Indicates that an object is a parent window of another object.
|
|
*/
|
|
PARENT_WINDOW_OF,
|
|
/**
|
|
* Reciprocal of %ATK_RELATION_DESCRIPTION_FOR. Indicates that one
|
|
* or more target objects provide descriptive information about this object. This relation
|
|
* type is most appropriate for information that is not essential as its presentation may
|
|
* be user-configurable and/or limited to an on-demand mechanism such as an assistive
|
|
* technology command. For brief, essential information such as can be found in a widget's
|
|
* on-screen label, use %ATK_RELATION_LABELLED_BY. For an on-screen error message, use
|
|
* %ATK_RELATION_ERROR_MESSAGE. For lengthy extended descriptive information contained in
|
|
* an on-screen object, consider using %ATK_RELATION_DETAILS as assistive technologies may
|
|
* provide a means for the user to navigate to objects containing detailed descriptions so
|
|
* that their content can be more closely reviewed.
|
|
*/
|
|
DESCRIBED_BY,
|
|
/**
|
|
* Reciprocal of %ATK_RELATION_DESCRIBED_BY. Indicates that this
|
|
* object provides descriptive information about the target object(s). See also
|
|
* %ATK_RELATION_DETAILS_FOR and %ATK_RELATION_ERROR_FOR.
|
|
*/
|
|
DESCRIPTION_FOR,
|
|
/**
|
|
* Indicates an object is a cell in a treetable and is expanded to display other cells in the same column.
|
|
*/
|
|
NODE_PARENT_OF,
|
|
/**
|
|
* Reciprocal of %ATK_RELATION_DETAILS_FOR. Indicates that this object
|
|
* has a detailed or extended description, the contents of which can be found in the target
|
|
* object(s). This relation type is most appropriate for information that is sufficiently
|
|
* lengthy as to make navigation to the container of that information desirable. For less
|
|
* verbose information suitable for announcement only, see %ATK_RELATION_DESCRIBED_BY. If
|
|
* the detailed information describes an error condition, %ATK_RELATION_ERROR_FOR should be
|
|
* used instead. `Since:` ATK-2.26.
|
|
*/
|
|
DETAILS,
|
|
/**
|
|
* Reciprocal of %ATK_RELATION_DETAILS. Indicates that this object
|
|
* provides a detailed or extended description about the target object(s). See also
|
|
* %ATK_RELATION_DESCRIPTION_FOR and %ATK_RELATION_ERROR_FOR. `Since:` ATK-2.26.
|
|
*/
|
|
DETAILS_FOR,
|
|
/**
|
|
* Reciprocal of %ATK_RELATION_ERROR_FOR. Indicates that this object
|
|
* has one or more errors, the nature of which is described in the contents of the target
|
|
* object(s). Objects that have this relation type should also contain %ATK_STATE_INVALID_ENTRY
|
|
* in their #AtkStateSet. `Since:` ATK-2.26.
|
|
*/
|
|
ERROR_MESSAGE,
|
|
/**
|
|
* Reciprocal of %ATK_RELATION_ERROR_MESSAGE. Indicates that this object
|
|
* contains an error message describing an invalid condition in the target object(s). `Since:`
|
|
* ATK_2.26.
|
|
*/
|
|
ERROR_FOR,
|
|
/**
|
|
* Not used, this value indicates the end of the enumeration.
|
|
*/
|
|
LAST_DEFINED,
|
|
}
|
|
/**
|
|
* Describes the role of an object
|
|
*
|
|
* These are the built-in enumerated roles that UI components can have
|
|
* in ATK. Other roles may be added at runtime, so an AtkRole >=
|
|
* %ATK_ROLE_LAST_DEFINED is not necessarily an error.
|
|
*/
|
|
export enum Role {
|
|
/**
|
|
* Invalid role
|
|
*/
|
|
INVALID,
|
|
/**
|
|
* A label which represents an accelerator
|
|
*/
|
|
ACCELERATOR_LABEL,
|
|
/**
|
|
* An object which is an alert to the user. Assistive Technologies typically respond to ATK_ROLE_ALERT by reading the entire onscreen contents of containers advertising this role. Should be used for warning dialogs, etc.
|
|
*/
|
|
ALERT,
|
|
/**
|
|
* An object which is an animated image
|
|
*/
|
|
ANIMATION,
|
|
/**
|
|
* An arrow in one of the four cardinal directions
|
|
*/
|
|
ARROW,
|
|
/**
|
|
* An object that displays a calendar and allows the user to select a date
|
|
*/
|
|
CALENDAR,
|
|
/**
|
|
* An object that can be drawn into and is used to trap events
|
|
*/
|
|
CANVAS,
|
|
/**
|
|
* A choice that can be checked or unchecked and provides a separate indicator for the current state
|
|
*/
|
|
CHECK_BOX,
|
|
/**
|
|
* A menu item with a check box
|
|
*/
|
|
CHECK_MENU_ITEM,
|
|
/**
|
|
* A specialized dialog that lets the user choose a color
|
|
*/
|
|
COLOR_CHOOSER,
|
|
/**
|
|
* The header for a column of data
|
|
*/
|
|
COLUMN_HEADER,
|
|
/**
|
|
* A collapsible list of choices the user can select from
|
|
*/
|
|
COMBO_BOX,
|
|
/**
|
|
* An object whose purpose is to allow a user to edit a date
|
|
*/
|
|
DATE_EDITOR,
|
|
/**
|
|
* An inconifed internal frame within a DESKTOP_PANE
|
|
*/
|
|
DESKTOP_ICON,
|
|
/**
|
|
* A pane that supports internal frames and iconified versions of those internal frames
|
|
*/
|
|
DESKTOP_FRAME,
|
|
/**
|
|
* An object whose purpose is to allow a user to set a value
|
|
*/
|
|
DIAL,
|
|
/**
|
|
* A top level window with title bar and a border
|
|
*/
|
|
DIALOG,
|
|
/**
|
|
* A pane that allows the user to navigate through and select the contents of a directory
|
|
*/
|
|
DIRECTORY_PANE,
|
|
/**
|
|
* An object used for drawing custom user interface elements
|
|
*/
|
|
DRAWING_AREA,
|
|
/**
|
|
* A specialized dialog that lets the user choose a file
|
|
*/
|
|
FILE_CHOOSER,
|
|
/**
|
|
* A object that fills up space in a user interface
|
|
*/
|
|
FILLER,
|
|
/**
|
|
* A specialized dialog that lets the user choose a font
|
|
*/
|
|
FONT_CHOOSER,
|
|
/**
|
|
* A top level window with a title bar, border, menubar, etc.
|
|
*/
|
|
FRAME,
|
|
/**
|
|
* A pane that is guaranteed to be painted on top of all panes beneath it
|
|
*/
|
|
GLASS_PANE,
|
|
/**
|
|
* A document container for HTML, whose children represent the document content
|
|
*/
|
|
HTML_CONTAINER,
|
|
/**
|
|
* A small fixed size picture, typically used to decorate components
|
|
*/
|
|
ICON,
|
|
/**
|
|
* An object whose primary purpose is to display an image
|
|
*/
|
|
IMAGE,
|
|
/**
|
|
* A frame-like object that is clipped by a desktop pane
|
|
*/
|
|
INTERNAL_FRAME,
|
|
/**
|
|
* An object used to present an icon or short string in an interface
|
|
*/
|
|
LABEL,
|
|
/**
|
|
* A specialized pane that allows its children to be drawn in layers, providing a form of stacking order
|
|
*/
|
|
LAYERED_PANE,
|
|
/**
|
|
* An object that presents a list of objects to the user and allows the user to select one or more of them
|
|
*/
|
|
LIST,
|
|
/**
|
|
* An object that represents an element of a list
|
|
*/
|
|
LIST_ITEM,
|
|
/**
|
|
* An object usually found inside a menu bar that contains a list of actions the user can choose from
|
|
*/
|
|
MENU,
|
|
/**
|
|
* 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
|
|
*/
|
|
MENU_BAR,
|
|
/**
|
|
* An object usually contained in a menu that presents an action the user can choose
|
|
*/
|
|
MENU_ITEM,
|
|
/**
|
|
* A specialized pane whose primary use is inside a DIALOG
|
|
*/
|
|
OPTION_PANE,
|
|
/**
|
|
* An object that is a child of a page tab list
|
|
*/
|
|
PAGE_TAB,
|
|
/**
|
|
* An object that presents a series of panels (or page tabs), one at a time, through some mechanism provided by the object
|
|
*/
|
|
PAGE_TAB_LIST,
|
|
/**
|
|
* A generic container that is often used to group objects
|
|
*/
|
|
PANEL,
|
|
/**
|
|
* A text object uses for passwords, or other places where the text content is not shown visibly to the user
|
|
*/
|
|
PASSWORD_TEXT,
|
|
/**
|
|
* 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
|
|
*/
|
|
POPUP_MENU,
|
|
/**
|
|
* An object used to indicate how much of a task has been completed
|
|
*/
|
|
PROGRESS_BAR,
|
|
/**
|
|
* An object the user can manipulate to tell the application to do something
|
|
*/
|
|
PUSH_BUTTON,
|
|
/**
|
|
* A specialized check box that will cause other radio buttons in the same group to become unchecked when this one is checked
|
|
*/
|
|
RADIO_BUTTON,
|
|
/**
|
|
* A check menu item which belongs to a group. At each instant exactly one of the radio menu items from a group is selected
|
|
*/
|
|
RADIO_MENU_ITEM,
|
|
/**
|
|
* A specialized pane that has a glass pane and a layered pane as its children
|
|
*/
|
|
ROOT_PANE,
|
|
/**
|
|
* The header for a row of data
|
|
*/
|
|
ROW_HEADER,
|
|
/**
|
|
* An object usually used to allow a user to incrementally view a large amount of data.
|
|
*/
|
|
SCROLL_BAR,
|
|
/**
|
|
* An object that allows a user to incrementally view a large amount of information
|
|
*/
|
|
SCROLL_PANE,
|
|
/**
|
|
* An object usually contained in a menu to provide a visible and logical separation of the contents in a menu
|
|
*/
|
|
SEPARATOR,
|
|
/**
|
|
* An object that allows the user to select from a bounded range
|
|
*/
|
|
SLIDER,
|
|
/**
|
|
* A specialized panel that presents two other panels at the same time
|
|
*/
|
|
SPLIT_PANE,
|
|
/**
|
|
* An object used to get an integer or floating point number from the user
|
|
*/
|
|
SPIN_BUTTON,
|
|
/**
|
|
* An object which reports messages of minor importance to the user
|
|
*/
|
|
STATUSBAR,
|
|
/**
|
|
* An object used to represent information in terms of rows and columns
|
|
*/
|
|
TABLE,
|
|
/**
|
|
* A cell in a table
|
|
*/
|
|
TABLE_CELL,
|
|
/**
|
|
* The header for a column of a table
|
|
*/
|
|
TABLE_COLUMN_HEADER,
|
|
/**
|
|
* The header for a row of a table
|
|
*/
|
|
TABLE_ROW_HEADER,
|
|
/**
|
|
* A menu item used to tear off and reattach its menu
|
|
*/
|
|
TEAR_OFF_MENU_ITEM,
|
|
/**
|
|
* An object that represents an accessible terminal. (Since: 0.6)
|
|
*/
|
|
TERMINAL,
|
|
/**
|
|
* An interactive widget that supports multiple lines of text and
|
|
* optionally accepts user input, but whose purpose is not to solicit user input.
|
|
* Thus ATK_ROLE_TEXT is appropriate for the text view in a plain text editor
|
|
* but inappropriate for an input field in a dialog box or web form. For widgets
|
|
* whose purpose is to solicit input from the user, see ATK_ROLE_ENTRY and
|
|
* ATK_ROLE_PASSWORD_TEXT. For generic objects which display a brief amount of
|
|
* textual information, see ATK_ROLE_STATIC.
|
|
*/
|
|
TEXT,
|
|
/**
|
|
* A specialized push button that can be checked or unchecked, but does not provide a separate indicator for the current state
|
|
*/
|
|
TOGGLE_BUTTON,
|
|
/**
|
|
* A bar or palette usually composed of push buttons or toggle buttons
|
|
*/
|
|
TOOL_BAR,
|
|
/**
|
|
* An object that provides information about another object
|
|
*/
|
|
TOOL_TIP,
|
|
/**
|
|
* An object used to represent hierarchical information to the user
|
|
*/
|
|
TREE,
|
|
/**
|
|
* An object capable of expanding and collapsing rows as well as showing multiple columns of data. (Since: 0.7)
|
|
*/
|
|
TREE_TABLE,
|
|
/**
|
|
* The object contains some Accessible information, but its role is not known
|
|
*/
|
|
UNKNOWN,
|
|
/**
|
|
* An object usually used in a scroll pane
|
|
*/
|
|
VIEWPORT,
|
|
/**
|
|
* A top level window with no title or border.
|
|
*/
|
|
WINDOW,
|
|
/**
|
|
* An object that serves as a document header. (Since: 1.1.1)
|
|
*/
|
|
HEADER,
|
|
/**
|
|
* An object that serves as a document footer. (Since: 1.1.1)
|
|
*/
|
|
FOOTER,
|
|
/**
|
|
* An object which is contains a paragraph of text content. (Since: 1.1.1)
|
|
*/
|
|
PARAGRAPH,
|
|
/**
|
|
* An object which describes margins and tab stops, etc. for text objects which it controls (should have CONTROLLER_FOR relation to such). (Since: 1.1.1)
|
|
*/
|
|
RULER,
|
|
/**
|
|
* The object is an application object, which may contain `ATK_ROLE_FRAME` objects or other types of accessibles. The root accessible of any application's ATK hierarchy should have ATK_ROLE_APPLICATION. (Since: 1.1.4)
|
|
*/
|
|
APPLICATION,
|
|
/**
|
|
* The object is a dialog or list containing items for insertion into an entry widget, for instance a list of words for completion of a text entry. (Since: 1.3)
|
|
*/
|
|
AUTOCOMPLETE,
|
|
/**
|
|
* The object is an editable text object in a toolbar. (Since: 1.5)
|
|
*/
|
|
EDIT_BAR,
|
|
/**
|
|
* The object is an embedded container within a document or panel. This role is a grouping "hint" indicating that the contained objects share a context. (Since: 1.7.2)
|
|
*/
|
|
EMBEDDED,
|
|
/**
|
|
* The object is a component whose textual content may be entered or modified by the user, provided `ATK_STATE_EDITABLE` is present. (Since: 1.11)
|
|
*/
|
|
ENTRY,
|
|
/**
|
|
* The object is a graphical depiction of quantitative data. It may contain multiple subelements whose attributes and/or description may be queried to obtain both the quantitative data and information about how the data is being presented. The LABELLED_BY relation is particularly important in interpreting objects of this type, as is the accessible-description property. (Since: 1.11)
|
|
*/
|
|
CHART,
|
|
/**
|
|
* The object contains descriptive information, usually textual, about another user interface element such as a table, chart, or image. (Since: 1.11)
|
|
*/
|
|
CAPTION,
|
|
/**
|
|
* The object is a visual frame or container which contains a view of document content. Document frames may occur within another Document instance, in which case the second document may be said to be embedded in the containing instance. HTML frames are often ROLE_DOCUMENT_FRAME. Either this object, or a singleton descendant, should implement the Document interface. (Since: 1.11)
|
|
*/
|
|
DOCUMENT_FRAME,
|
|
/**
|
|
* The object serves as a heading for content which follows it in a document. The 'heading level' of the heading, if availabe, may be obtained by querying the object's attributes.
|
|
*/
|
|
HEADING,
|
|
/**
|
|
* The object is a containing instance which encapsulates a page of information. `ATK_ROLE_PAGE` is used in documents and content which support a paginated navigation model. (Since: 1.11)
|
|
*/
|
|
PAGE,
|
|
/**
|
|
* The object is a containing instance of document content which constitutes a particular 'logical' section of the document. The type of content within a section, and the nature of the section division itself, may be obtained by querying the object's attributes. Sections may be nested. (Since: 1.11)
|
|
*/
|
|
SECTION,
|
|
/**
|
|
* The object is redundant with another object in the hierarchy, and is exposed for purely technical reasons. Objects of this role should normally be ignored by clients. (Since: 1.11)
|
|
*/
|
|
REDUNDANT_OBJECT,
|
|
/**
|
|
* The object is a container for form controls, for instance as part of a
|
|
* web form or user-input form within a document. This role is primarily a tag/convenience for
|
|
* clients when navigating complex documents, it is not expected that ordinary GUI containers will
|
|
* always have ATK_ROLE_FORM. (Since: 1.12.0)
|
|
*/
|
|
FORM,
|
|
/**
|
|
* The object is a hypertext anchor, i.e. a "link" in a
|
|
* hypertext document. Such objects are distinct from 'inline'
|
|
* content which may also use the Hypertext/Hyperlink interfaces
|
|
* to indicate the range/location within a text object where
|
|
* an inline or embedded object lies. (Since: 1.12.1)
|
|
*/
|
|
LINK,
|
|
/**
|
|
* The object is a window or similar viewport
|
|
* which is used to allow composition or input of a 'complex character',
|
|
* in other words it is an "input method window." (Since: 1.12.1)
|
|
*/
|
|
INPUT_METHOD_WINDOW,
|
|
/**
|
|
* A row in a table. (Since: 2.1.0)
|
|
*/
|
|
TABLE_ROW,
|
|
/**
|
|
* An object that represents an element of a tree. (Since: 2.1.0)
|
|
*/
|
|
TREE_ITEM,
|
|
/**
|
|
* A document frame which contains a spreadsheet. (Since: 2.1.0)
|
|
*/
|
|
DOCUMENT_SPREADSHEET,
|
|
/**
|
|
* A document frame which contains a presentation or slide content. (Since: 2.1.0)
|
|
*/
|
|
DOCUMENT_PRESENTATION,
|
|
/**
|
|
* A document frame which contains textual content, such as found in a word processing application. (Since: 2.1.0)
|
|
*/
|
|
DOCUMENT_TEXT,
|
|
/**
|
|
* A document frame which contains HTML or other markup suitable for display in a web browser. (Since: 2.1.0)
|
|
*/
|
|
DOCUMENT_WEB,
|
|
/**
|
|
* A document frame which contains email content to be displayed or composed either in plain text or HTML. (Since: 2.1.0)
|
|
*/
|
|
DOCUMENT_EMAIL,
|
|
/**
|
|
* An object found within a document and designed to present a comment, note, or other annotation. In some cases, this object might not be visible until activated. (Since: 2.1.0)
|
|
*/
|
|
COMMENT,
|
|
/**
|
|
* A non-collapsible list of choices the user can select from. (Since: 2.1.0)
|
|
*/
|
|
LIST_BOX,
|
|
/**
|
|
* A group of related widgets. This group typically has a label. (Since: 2.1.0)
|
|
*/
|
|
GROUPING,
|
|
/**
|
|
* An image map object. Usually a graphic with multiple hotspots, where each hotspot can be activated resulting in the loading of another document or section of a document. (Since: 2.1.0)
|
|
*/
|
|
IMAGE_MAP,
|
|
/**
|
|
* A transitory object designed to present a message to the user, typically at the desktop level rather than inside a particular application. (Since: 2.1.0)
|
|
*/
|
|
NOTIFICATION,
|
|
/**
|
|
* An object designed to present a message to the user within an existing window. (Since: 2.1.0)
|
|
*/
|
|
INFO_BAR,
|
|
/**
|
|
* A bar that serves as a level indicator to, for instance, show the strength of a password or the state of a battery. (Since: 2.7.3)
|
|
*/
|
|
LEVEL_BAR,
|
|
/**
|
|
* A bar that serves as the title of a window or a
|
|
* dialog. (Since: 2.12)
|
|
*/
|
|
TITLE_BAR,
|
|
/**
|
|
* An object which contains a text section
|
|
* that is quoted from another source. (Since: 2.12)
|
|
*/
|
|
BLOCK_QUOTE,
|
|
/**
|
|
* An object which represents an audio element. (Since: 2.12)
|
|
*/
|
|
AUDIO,
|
|
/**
|
|
* An object which represents a video element. (Since: 2.12)
|
|
*/
|
|
VIDEO,
|
|
/**
|
|
* A definition of a term or concept. (Since: 2.12)
|
|
*/
|
|
DEFINITION,
|
|
/**
|
|
* A section of a page that consists of a
|
|
* composition that forms an independent part of a document, page, or
|
|
* site. Examples: A blog entry, a news story, a forum post. (Since: 2.12)
|
|
*/
|
|
ARTICLE,
|
|
/**
|
|
* A region of a web page intended as a
|
|
* navigational landmark. This is designed to allow Assistive
|
|
* Technologies to provide quick navigation among key regions within a
|
|
* document. (Since: 2.12)
|
|
*/
|
|
LANDMARK,
|
|
/**
|
|
* A text widget or container holding log content, such
|
|
* as chat history and error logs. In this role there is a
|
|
* relationship between the arrival of new items in the log and the
|
|
* reading order. The log contains a meaningful sequence and new
|
|
* information is added only to the end of the log, not at arbitrary
|
|
* points. (Since: 2.12)
|
|
*/
|
|
LOG,
|
|
/**
|
|
* A container where non-essential information
|
|
* changes frequently. Common usages of marquee include stock tickers
|
|
* and ad banners. The primary difference between a marquee and a log
|
|
* is that logs usually have a meaningful order or sequence of
|
|
* important content changes. (Since: 2.12)
|
|
*/
|
|
MARQUEE,
|
|
/**
|
|
* A text widget or container that holds a mathematical
|
|
* expression. (Since: 2.12)
|
|
*/
|
|
MATH,
|
|
/**
|
|
* A widget whose purpose is to display a rating,
|
|
* such as the number of stars associated with a song in a media
|
|
* player. Objects of this role should also implement
|
|
* AtkValue. (Since: 2.12)
|
|
*/
|
|
RATING,
|
|
/**
|
|
* An object containing a numerical counter which
|
|
* indicates an amount of elapsed time from a start point, or the time
|
|
* remaining until an end point. (Since: 2.12)
|
|
*/
|
|
TIMER,
|
|
/**
|
|
* An object that represents a list of
|
|
* term-value groups. A term-value group represents a individual
|
|
* description and consist of one or more names
|
|
* (ATK_ROLE_DESCRIPTION_TERM) followed by one or more values
|
|
* (ATK_ROLE_DESCRIPTION_VALUE). For each list, there should not be
|
|
* more than one group with the same term name. (Since: 2.12)
|
|
*/
|
|
DESCRIPTION_LIST,
|
|
/**
|
|
* An object that represents a term or phrase
|
|
* with a corresponding definition. (Since: 2.12)
|
|
*/
|
|
DESCRIPTION_TERM,
|
|
/**
|
|
* An object that represents the
|
|
* description, definition or value of a term. (Since: 2.12)
|
|
*/
|
|
DESCRIPTION_VALUE,
|
|
/**
|
|
* A generic non-container object whose purpose is to display a
|
|
* brief amount of information to the user and whose role is known by the
|
|
* implementor but lacks semantic value for the user. Examples in which
|
|
* %ATK_ROLE_STATIC is appropriate include the message displayed in a message box
|
|
* and an image used as an alternative means to display text. %ATK_ROLE_STATIC
|
|
* should not be applied to widgets which are traditionally interactive, objects
|
|
* which display a significant amount of content, or any object which has an
|
|
* accessible relation pointing to another object. Implementors should expose the
|
|
* displayed information through the accessible name of the object. If doing so seems
|
|
* inappropriate, it may indicate that a different role should be used. For
|
|
* labels which describe another widget, see %ATK_ROLE_LABEL. For text views, see
|
|
* %ATK_ROLE_TEXT. For generic containers, see %ATK_ROLE_PANEL. For objects whose
|
|
* role is not known by the implementor, see %ATK_ROLE_UNKNOWN. (Since: 2.16)
|
|
*/
|
|
STATIC,
|
|
/**
|
|
* An object that represents a mathematical fraction.
|
|
* (Since: 2.16)
|
|
*/
|
|
MATH_FRACTION,
|
|
/**
|
|
* An object that represents a mathematical expression
|
|
* displayed with a radical. (Since: 2.16)
|
|
*/
|
|
MATH_ROOT,
|
|
/**
|
|
* An object that contains text that is displayed as a
|
|
* subscript. (Since: 2.16)
|
|
*/
|
|
SUBSCRIPT,
|
|
/**
|
|
* An object that contains text that is displayed as a
|
|
* superscript. (Since: 2.16)
|
|
*/
|
|
SUPERSCRIPT,
|
|
/**
|
|
* An object that contains the text of a footnote. (Since: 2.26)
|
|
*/
|
|
FOOTNOTE,
|
|
/**
|
|
* Content previously deleted or proposed to be
|
|
* deleted, e.g. in revision history or a content view providing suggestions
|
|
* from reviewers. (Since: 2.34)
|
|
*/
|
|
CONTENT_DELETION,
|
|
/**
|
|
* Content previously inserted or proposed to be
|
|
* inserted, e.g. in revision history or a content view providing suggestions
|
|
* from reviewers. (Since: 2.34)
|
|
*/
|
|
CONTENT_INSERTION,
|
|
/**
|
|
* A run of content that is marked or highlighted, such as for
|
|
* reference purposes, or to call it out as having a special purpose. If the
|
|
* marked content has an associated section in the document elaborating on the
|
|
* reason for the mark, then %ATK_RELATION_DETAILS should be used on the mark
|
|
* to point to that associated section. In addition, the reciprocal relation
|
|
* %ATK_RELATION_DETAILS_FOR should be used on the associated content section
|
|
* to point back to the mark. (Since: 2.36)
|
|
*/
|
|
MARK,
|
|
/**
|
|
* A container for content that is called out as a proposed
|
|
* change from the current version of the document, such as by a reviewer of the
|
|
* content. This role should include either %ATK_ROLE_CONTENT_DELETION and/or
|
|
* %ATK_ROLE_CONTENT_INSERTION children, in any order, to indicate what the
|
|
* actual change is. (Since: 2.36)
|
|
*/
|
|
SUGGESTION,
|
|
/**
|
|
* A specialized push button to open a menu.
|
|
* (Since: 2.46)
|
|
*/
|
|
PUSH_BUTTON_MENU,
|
|
/**
|
|
* not a valid role, used for finding end of the enumeration
|
|
*/
|
|
LAST_DEFINED,
|
|
}
|
|
/**
|
|
* Specifies where an object should be placed on the screen when using scroll_to.
|
|
*/
|
|
export enum ScrollType {
|
|
/**
|
|
* Scroll the object vertically and horizontally to bring
|
|
* its top left corner to the top left corner of the window.
|
|
*/
|
|
TOP_LEFT,
|
|
/**
|
|
* Scroll the object vertically and horizontally to
|
|
* bring its bottom right corner to the bottom right corner of the window.
|
|
*/
|
|
BOTTOM_RIGHT,
|
|
/**
|
|
* Scroll the object vertically to bring its top edge to
|
|
* the top edge of the window.
|
|
*/
|
|
TOP_EDGE,
|
|
/**
|
|
* Scroll the object vertically to bring its bottom
|
|
* edge to the bottom edge of the window.
|
|
*/
|
|
BOTTOM_EDGE,
|
|
/**
|
|
* Scroll the object vertically and horizontally to bring
|
|
* its left edge to the left edge of the window.
|
|
*/
|
|
LEFT_EDGE,
|
|
/**
|
|
* Scroll the object vertically and horizontally to
|
|
* bring its right edge to the right edge of the window.
|
|
*/
|
|
RIGHT_EDGE,
|
|
/**
|
|
* Scroll the object vertically and horizontally so that
|
|
* as much as possible of the object becomes visible. The exact placement is
|
|
* determined by the application.
|
|
*/
|
|
ANYWHERE,
|
|
}
|
|
/**
|
|
* The possible types of states of an object
|
|
*/
|
|
export enum StateType {
|
|
/**
|
|
* Indicates an invalid state - probably an error condition.
|
|
*/
|
|
INVALID,
|
|
/**
|
|
* Indicates a window is currently the active window, or an object is the active subelement within a container or table. ATK_STATE_ACTIVE should not be used for objects which have ATK_STATE_FOCUSABLE or ATK_STATE_SELECTABLE: Those objects should use ATK_STATE_FOCUSED and ATK_STATE_SELECTED respectively. ATK_STATE_ACTIVE is a means to indicate that an object which is not focusable and not selectable is the currently-active item within its parent container.
|
|
*/
|
|
ACTIVE,
|
|
/**
|
|
* Indicates that the object is 'armed', i.e. will be activated by if a pointer button-release event occurs within its bounds. Buttons often enter this state when a pointer click occurs within their bounds, as a precursor to activation. ATK_STATE_ARMED has been deprecated since ATK-2.16 and should not be used in newly-written code.
|
|
*/
|
|
ARMED,
|
|
/**
|
|
* Indicates the current object is busy, i.e. onscreen representation is in the process of changing, or the object is temporarily unavailable for interaction due to activity already in progress. This state may be used by implementors of Document to indicate that content loading is underway. It also may indicate other 'pending' conditions; clients may wish to interrogate this object when the ATK_STATE_BUSY flag is removed.
|
|
*/
|
|
BUSY,
|
|
/**
|
|
* Indicates this object is currently checked, for instance a checkbox is 'non-empty'.
|
|
*/
|
|
CHECKED,
|
|
/**
|
|
* Indicates that this object no longer has a valid backing widget (for instance, if its peer object has been destroyed)
|
|
*/
|
|
DEFUNCT,
|
|
/**
|
|
* Indicates that this object can contain text, and that the
|
|
* user can change the textual contents of this object by editing those contents
|
|
* directly. For an object which is expected to be editable due to its type, but
|
|
* which cannot be edited due to the application or platform preventing the user
|
|
* from doing so, that object's #AtkStateSet should lack ATK_STATE_EDITABLE and
|
|
* should contain ATK_STATE_READ_ONLY.
|
|
*/
|
|
EDITABLE,
|
|
/**
|
|
* Indicates that this object is enabled, i.e. that it currently reflects some application state. Objects that are "greyed out" may lack this state, and may lack the STATE_SENSITIVE if direct user interaction cannot cause them to acquire STATE_ENABLED. See also: ATK_STATE_SENSITIVE
|
|
*/
|
|
ENABLED,
|
|
/**
|
|
* Indicates this object allows progressive disclosure of its children
|
|
*/
|
|
EXPANDABLE,
|
|
/**
|
|
* Indicates this object its expanded - see ATK_STATE_EXPANDABLE above
|
|
*/
|
|
EXPANDED,
|
|
/**
|
|
* Indicates this object can accept keyboard focus, which means all events resulting from typing on the keyboard will normally be passed to it when it has focus
|
|
*/
|
|
FOCUSABLE,
|
|
/**
|
|
* Indicates this object currently has the keyboard focus
|
|
*/
|
|
FOCUSED,
|
|
/**
|
|
* Indicates the orientation of this object is horizontal; used, for instance, by objects of ATK_ROLE_SCROLL_BAR. For objects where vertical/horizontal orientation is especially meaningful.
|
|
*/
|
|
HORIZONTAL,
|
|
/**
|
|
* Indicates this object is minimized and is represented only by an icon
|
|
*/
|
|
ICONIFIED,
|
|
/**
|
|
* Indicates something must be done with this object before the user can interact with an object in a different window
|
|
*/
|
|
MODAL,
|
|
/**
|
|
* Indicates this (text) object can contain multiple lines of text
|
|
*/
|
|
MULTI_LINE,
|
|
/**
|
|
* Indicates this object allows more than one of its children to be selected at the same time, or in the case of text objects, that the object supports non-contiguous text selections.
|
|
*/
|
|
MULTISELECTABLE,
|
|
/**
|
|
* Indicates this object paints every pixel within its rectangular region.
|
|
*/
|
|
OPAQUE,
|
|
/**
|
|
* Indicates this object is currently pressed.
|
|
*/
|
|
PRESSED,
|
|
/**
|
|
* Indicates the size of this object is not fixed
|
|
*/
|
|
RESIZABLE,
|
|
/**
|
|
* Indicates this object is the child of an object that allows its children to be selected and that this child is one of those children that can be selected
|
|
*/
|
|
SELECTABLE,
|
|
/**
|
|
* Indicates this object is the child of an object that allows its children to be selected and that this child is one of those children that has been selected
|
|
*/
|
|
SELECTED,
|
|
/**
|
|
* Indicates this object is sensitive, e.g. to user interaction.
|
|
* STATE_SENSITIVE usually accompanies STATE_ENABLED for user-actionable controls,
|
|
* but may be found in the absence of STATE_ENABLED if the current visible state of the
|
|
* control is "disconnected" from the application state. In such cases, direct user interaction
|
|
* can often result in the object gaining STATE_SENSITIVE, for instance if a user makes
|
|
* an explicit selection using an object whose current state is ambiguous or undefined.
|
|
* `see` STATE_ENABLED, STATE_INDETERMINATE.
|
|
*/
|
|
SENSITIVE,
|
|
/**
|
|
* Indicates this object, the object's parent, the object's parent's parent, and so on,
|
|
* are all 'shown' to the end-user, i.e. subject to "exposure" if blocking or obscuring objects do not interpose
|
|
* between this object and the top of the window stack.
|
|
*/
|
|
SHOWING,
|
|
/**
|
|
* Indicates this (text) object can contain only a single line of text
|
|
*/
|
|
SINGLE_LINE,
|
|
/**
|
|
* Indicates that the information returned for this object may no longer be
|
|
* synchronized with the application state. This is implied if the object has STATE_TRANSIENT,
|
|
* and can also occur towards the end of the object peer's lifecycle. It can also be used to indicate that
|
|
* the index associated with this object has changed since the user accessed the object (in lieu of
|
|
* "index-in-parent-changed" events).
|
|
*/
|
|
STALE,
|
|
/**
|
|
* Indicates this object is transient, i.e. a snapshot which may not emit events when its
|
|
* state changes. Data from objects with ATK_STATE_TRANSIENT should not be cached, since there may be no
|
|
* notification given when the cached data becomes obsolete.
|
|
*/
|
|
TRANSIENT,
|
|
/**
|
|
* Indicates the orientation of this object is vertical
|
|
*/
|
|
VERTICAL,
|
|
/**
|
|
* Indicates this object is visible, e.g. has been explicitly marked for exposure to the user.
|
|
* **note**: %ATK_STATE_VISIBLE is no guarantee that the object is actually unobscured on the screen, only
|
|
* that it is 'potentially' visible, barring obstruction, being scrolled or clipped out of the
|
|
* field of view, or having an ancestor container that has not yet made visible.
|
|
* A widget is potentially onscreen if it has both %ATK_STATE_VISIBLE and %ATK_STATE_SHOWING.
|
|
* The absence of %ATK_STATE_VISIBLE and %ATK_STATE_SHOWING is semantically equivalent to saying
|
|
* that an object is 'hidden'. See also %ATK_STATE_TRUNCATED, which applies if an object with
|
|
* %ATK_STATE_VISIBLE and %ATK_STATE_SHOWING set lies within a viewport which means that its
|
|
* contents are clipped, e.g. a truncated spreadsheet cell or
|
|
* an image within a scrolling viewport. Mostly useful for screen-review and magnification
|
|
* algorithms.
|
|
*/
|
|
VISIBLE,
|
|
/**
|
|
* Indicates that "active-descendant-changed" event
|
|
* is sent when children become 'active' (i.e. are selected or navigated to onscreen).
|
|
* Used to prevent need to enumerate all children in very large containers, like tables.
|
|
* The presence of STATE_MANAGES_DESCENDANTS is an indication to the client.
|
|
* that the children should not, and need not, be enumerated by the client.
|
|
* Objects implementing this state are expected to provide relevant state
|
|
* notifications to listening clients, for instance notifications of visibility
|
|
* changes and activation of their contained child objects, without the client
|
|
* having previously requested references to those children.
|
|
*/
|
|
MANAGES_DESCENDANTS,
|
|
/**
|
|
* Indicates that the value, or some other quantifiable
|
|
* property, of this AtkObject cannot be fully determined. In the case of a large
|
|
* data set in which the total number of items in that set is unknown (e.g. 1 of
|
|
* 999+), implementors should expose the currently-known set size (999) along
|
|
* with this state. In the case of a check box, this state should be used to
|
|
* indicate that the check box is a tri-state check box which is currently
|
|
* neither checked nor unchecked.
|
|
*/
|
|
INDETERMINATE,
|
|
/**
|
|
* Indicates that an object is truncated, e.g. a text value in a speradsheet cell.
|
|
*/
|
|
TRUNCATED,
|
|
/**
|
|
* Indicates that explicit user interaction with an object is required by the user interface, e.g. a required field in a "web-form" interface.
|
|
*/
|
|
REQUIRED,
|
|
/**
|
|
* Indicates that the object has encountered an error condition due to failure of input validation. For instance, a form control may acquire this state in response to invalid or malformed user input.
|
|
*/
|
|
INVALID_ENTRY,
|
|
/**
|
|
* Indicates that the object in question implements some form of ¨typeahead¨ or
|
|
* pre-selection behavior whereby entering the first character of one or more sub-elements
|
|
* causes those elements to scroll into view or become selected. Subsequent character input
|
|
* may narrow the selection further as long as one or more sub-elements match the string.
|
|
* This state is normally only useful and encountered on objects that implement Selection.
|
|
* In some cases the typeahead behavior may result in full or partial ¨completion¨ of
|
|
* the data in the input field, in which case these input events may trigger text-changed
|
|
* events from the AtkText interface. This state supplants `ATK_ROLE_AUTOCOMPLETE`.
|
|
*/
|
|
SUPPORTS_AUTOCOMPLETION,
|
|
/**
|
|
* Indicates that the object in question supports text selection. It should only be exposed on objects which implement the Text interface, in order to distinguish this state from `ATK_STATE_SELECTABLE,` which infers that the object in question is a selectable child of an object which implements Selection. While similar, text selection and subelement selection are distinct operations.
|
|
*/
|
|
SELECTABLE_TEXT,
|
|
/**
|
|
* Indicates that the object is the "default" active component, i.e. the object which is activated by an end-user press of the "Enter" or "Return" key. Typically a "close" or "submit" button.
|
|
*/
|
|
DEFAULT,
|
|
/**
|
|
* Indicates that the object changes its appearance dynamically as an inherent part of its presentation. This state may come and go if an object is only temporarily animated on the way to a 'final' onscreen presentation.
|
|
* **note**: some applications, notably content viewers, may not be able to detect
|
|
* all kinds of animated content. Therefore the absence of this state should not
|
|
* be taken as definitive evidence that the object's visual representation is
|
|
* static; this state is advisory.
|
|
*/
|
|
ANIMATED,
|
|
/**
|
|
* Indicates that the object (typically a hyperlink) has already been 'activated', and/or its backing data has already been downloaded, rendered, or otherwise "visited".
|
|
*/
|
|
VISITED,
|
|
/**
|
|
* Indicates this object has the potential to be
|
|
* checked, such as a checkbox or toggle-able table cell. `Since:`
|
|
* ATK-2.12
|
|
*/
|
|
CHECKABLE,
|
|
/**
|
|
* Indicates that the object has a popup context
|
|
* menu or sub-level menu which may or may not be showing. This means
|
|
* that activation renders conditional content. Note that ordinary
|
|
* tooltips are not considered popups in this context. `Since:` ATK-2.12
|
|
*/
|
|
HAS_POPUP,
|
|
/**
|
|
* Indicates this object has a tooltip. `Since:` ATK-2.16
|
|
*/
|
|
HAS_TOOLTIP,
|
|
/**
|
|
* Indicates that a widget which is ENABLED and SENSITIVE
|
|
* has a value which can be read, but not modified, by the user. Note that this
|
|
* state should only be applied to widget types whose value is normally directly
|
|
* user modifiable, such as check boxes, radio buttons, spin buttons, text input
|
|
* fields, and combo boxes, as a means to convey that the expected interaction
|
|
* with that widget is not possible. When the expected interaction with a
|
|
* widget does not include modification by the user, as is the case with
|
|
* labels and containers, ATK_STATE_READ_ONLY should not be applied. See also
|
|
* ATK_STATE_EDITABLE. `Since:` ATK-2-16
|
|
*/
|
|
READ_ONLY,
|
|
/**
|
|
* Indicates this object is collapsed. `Since:` ATK-2.38
|
|
*/
|
|
COLLAPSED,
|
|
/**
|
|
* Not a valid state, used for finding end of enumeration
|
|
*/
|
|
LAST_DEFINED,
|
|
}
|
|
/**
|
|
* Describes the text attributes supported
|
|
*/
|
|
export enum TextAttribute {
|
|
/**
|
|
* Invalid attribute, like bad spelling or grammar.
|
|
*/
|
|
INVALID,
|
|
/**
|
|
* The pixel width of the left margin
|
|
*/
|
|
LEFT_MARGIN,
|
|
/**
|
|
* The pixel width of the right margin
|
|
*/
|
|
RIGHT_MARGIN,
|
|
/**
|
|
* The number of pixels that the text is indented
|
|
*/
|
|
INDENT,
|
|
/**
|
|
* Either "true" or "false" indicating whether text is visible or not
|
|
*/
|
|
INVISIBLE,
|
|
/**
|
|
* Either "true" or "false" indicating whether text is editable or not
|
|
*/
|
|
EDITABLE,
|
|
/**
|
|
* Pixels of blank space to leave above each newline-terminated line.
|
|
*/
|
|
PIXELS_ABOVE_LINES,
|
|
/**
|
|
* Pixels of blank space to leave below each newline-terminated line.
|
|
*/
|
|
PIXELS_BELOW_LINES,
|
|
/**
|
|
* Pixels of blank space to leave between wrapped lines inside the same newline-terminated line (paragraph).
|
|
*/
|
|
PIXELS_INSIDE_WRAP,
|
|
/**
|
|
* "true" or "false" whether to make the background color for each character the height of the highest font used on the current line, or the height of the font used for the current character.
|
|
*/
|
|
BG_FULL_HEIGHT,
|
|
/**
|
|
* Number of pixels that the characters are risen above the baseline. See also ATK_TEXT_ATTR_TEXT_POSITION.
|
|
*/
|
|
RISE,
|
|
/**
|
|
* "none", "single", "double", "low", or "error"
|
|
*/
|
|
UNDERLINE,
|
|
/**
|
|
* "true" or "false" whether the text is strikethrough
|
|
*/
|
|
STRIKETHROUGH,
|
|
/**
|
|
* The size of the characters in points. eg: 10
|
|
*/
|
|
SIZE,
|
|
/**
|
|
* The scale of the characters. The value is a string representation of a double
|
|
*/
|
|
SCALE,
|
|
/**
|
|
* The weight of the characters.
|
|
*/
|
|
WEIGHT,
|
|
/**
|
|
* The language used
|
|
*/
|
|
LANGUAGE,
|
|
/**
|
|
* The font family name
|
|
*/
|
|
FAMILY_NAME,
|
|
/**
|
|
* The background color. The value is an RGB value of the format "%u,%u,%u"
|
|
*/
|
|
BG_COLOR,
|
|
/**
|
|
* The foreground color. The value is an RGB value of the format "%u,%u,%u"
|
|
*/
|
|
FG_COLOR,
|
|
/**
|
|
* "true" if a #GdkBitmap is set for stippling the background color.
|
|
*/
|
|
BG_STIPPLE,
|
|
/**
|
|
* "true" if a #GdkBitmap is set for stippling the foreground color.
|
|
*/
|
|
FG_STIPPLE,
|
|
/**
|
|
* The wrap mode of the text, if any. Values are "none", "char", "word", or "word_char".
|
|
*/
|
|
WRAP_MODE,
|
|
/**
|
|
* The direction of the text, if set. Values are "none", "ltr" or "rtl"
|
|
*/
|
|
DIRECTION,
|
|
/**
|
|
* The justification of the text, if set. Values are "left", "right", "center" or "fill"
|
|
*/
|
|
JUSTIFICATION,
|
|
/**
|
|
* The stretch of the text, if set. Values are "ultra_condensed", "extra_condensed", "condensed", "semi_condensed", "normal", "semi_expanded", "expanded", "extra_expanded" or "ultra_expanded"
|
|
*/
|
|
STRETCH,
|
|
/**
|
|
* The capitalization variant of the text, if set. Values are "normal" or "small_caps"
|
|
*/
|
|
VARIANT,
|
|
/**
|
|
* The slant style of the text, if set. Values are "normal", "oblique" or "italic"
|
|
*/
|
|
STYLE,
|
|
/**
|
|
* The vertical position with respect to the baseline. Values are "baseline", "super", or "sub". Note that a super or sub text attribute refers to position with respect to the baseline of the prior character.
|
|
*/
|
|
TEXT_POSITION,
|
|
/**
|
|
* not a valid text attribute, used for finding end of enumeration
|
|
*/
|
|
LAST_DEFINED,
|
|
}
|
|
/**
|
|
* Text boundary types used for specifying boundaries for regions of text.
|
|
* This enumeration is deprecated since 2.9.4 and should not be used. Use
|
|
* AtkTextGranularity with #atk_text_get_string_at_offset instead.
|
|
*/
|
|
export enum TextBoundary {
|
|
/**
|
|
* Boundary is the boundary between characters
|
|
* (including non-printing characters)
|
|
*/
|
|
CHAR,
|
|
/**
|
|
* Boundary is the start (i.e. first character) of a word.
|
|
*/
|
|
WORD_START,
|
|
/**
|
|
* Boundary is the end (i.e. last
|
|
* character) of a word.
|
|
*/
|
|
WORD_END,
|
|
/**
|
|
* Boundary is the first character in a sentence.
|
|
*/
|
|
SENTENCE_START,
|
|
/**
|
|
* Boundary is the last (terminal)
|
|
* character in a sentence; in languages which use "sentence stop"
|
|
* punctuation such as English, the boundary is thus the '.', '?', or
|
|
* similar terminal punctuation character.
|
|
*/
|
|
SENTENCE_END,
|
|
/**
|
|
* Boundary is the initial character of the content or a
|
|
* character immediately following a newline, linefeed, or return character.
|
|
*/
|
|
LINE_START,
|
|
/**
|
|
* Boundary is the linefeed, or return
|
|
* character.
|
|
*/
|
|
LINE_END,
|
|
}
|
|
/**
|
|
* Describes the type of clipping required.
|
|
*/
|
|
export enum TextClipType {
|
|
/**
|
|
* No clipping to be done
|
|
*/
|
|
NONE,
|
|
/**
|
|
* Text clipped by min coordinate is omitted
|
|
*/
|
|
MIN,
|
|
/**
|
|
* Text clipped by max coordinate is omitted
|
|
*/
|
|
MAX,
|
|
/**
|
|
* Only text fully within mix/max bound is retained
|
|
*/
|
|
BOTH,
|
|
}
|
|
/**
|
|
* Text granularity types used for specifying the granularity of the region of
|
|
* text we are interested in.
|
|
*/
|
|
export enum TextGranularity {
|
|
/**
|
|
* Granularity is defined by the boundaries between characters
|
|
* (including non-printing characters)
|
|
*/
|
|
CHAR,
|
|
/**
|
|
* Granularity is defined by the boundaries of a word,
|
|
* starting at the beginning of the current word and finishing at the beginning of
|
|
* the following one, if present.
|
|
*/
|
|
WORD,
|
|
/**
|
|
* Granularity is defined by the boundaries of a sentence,
|
|
* starting at the beginning of the current sentence and finishing at the beginning of
|
|
* the following one, if present.
|
|
*/
|
|
SENTENCE,
|
|
/**
|
|
* Granularity is defined by the boundaries of a line,
|
|
* starting at the beginning of the current line and finishing at the beginning of
|
|
* the following one, if present.
|
|
*/
|
|
LINE,
|
|
/**
|
|
* Granularity is defined by the boundaries of a paragraph,
|
|
* starting at the beginning of the current paragraph and finishing at the beginning of
|
|
* the following one, if present.
|
|
*/
|
|
PARAGRAPH,
|
|
}
|
|
/**
|
|
* Default types for a given value. Those are defined in order to
|
|
* easily get localized strings to describe a given value or a given
|
|
* subrange, using atk_value_type_get_localized_name().
|
|
*/
|
|
export enum ValueType {
|
|
VERY_WEAK,
|
|
WEAK,
|
|
ACCEPTABLE,
|
|
STRONG,
|
|
VERY_STRONG,
|
|
VERY_LOW,
|
|
LOW,
|
|
MEDIUM,
|
|
HIGH,
|
|
VERY_HIGH,
|
|
VERY_BAD,
|
|
BAD,
|
|
GOOD,
|
|
VERY_GOOD,
|
|
BEST,
|
|
LAST_DEFINED,
|
|
}
|
|
/**
|
|
* Describes the type of link
|
|
* @bitfield
|
|
*/
|
|
export enum HyperlinkStateFlags {
|
|
/**
|
|
* Link is inline
|
|
*/
|
|
INLINE,
|
|
}
|
|
/**
|
|
* Like atk_get_binary_age(), but from the headers used at
|
|
* application compile time, rather than from the library linked
|
|
* against at application run time.
|
|
*/
|
|
export const BINARY_AGE: number
|
|
/**
|
|
* Like atk_get_interface_age(), but from the headers used at
|
|
* application compile time, rather than from the library linked
|
|
* against at application run time.
|
|
*/
|
|
export const INTERFACE_AGE: number
|
|
/**
|
|
* Like atk_get_major_version(), but from the headers used at
|
|
* application compile time, rather than from the library linked
|
|
* against at application run time.
|
|
*/
|
|
export const MAJOR_VERSION: number
|
|
/**
|
|
* Like atk_get_micro_version(), but from the headers used at
|
|
* application compile time, rather than from the library linked
|
|
* against at application run time.
|
|
*/
|
|
export const MICRO_VERSION: number
|
|
/**
|
|
* Like atk_get_minor_version(), but from the headers used at
|
|
* application compile time, rather than from the library linked
|
|
* against at application run time.
|
|
*/
|
|
export const MINOR_VERSION: number
|
|
/**
|
|
* A macro that should be defined by the user prior to including
|
|
* the atk/atk.h header.
|
|
* The definition should be one of the predefined ATK version
|
|
* macros: %ATK_VERSION_2_12, %ATK_VERSION_2_14,...
|
|
*
|
|
* This macro defines the earliest version of ATK that the package is
|
|
* required to be able to compile against.
|
|
*
|
|
* If the compiler is configured to warn about the use of deprecated
|
|
* functions, then using functions that were deprecated in version
|
|
* %ATK_VERSION_MIN_REQUIRED or earlier will cause warnings (but
|
|
* using functions deprecated in later releases will not).
|
|
*/
|
|
export const VERSION_MIN_REQUIRED: number
|
|
/**
|
|
* Frees the memory used by an #AtkAttributeSet, including all its
|
|
* #AtkAttributes.
|
|
* @param attrib_set The #AtkAttributeSet to free
|
|
*/
|
|
export function attribute_set_free(attrib_set: AttributeSet): void
|
|
/**
|
|
* Cause the focus tracker functions which have been specified to be
|
|
* executed for the object.
|
|
* @param object an #AtkObject
|
|
*/
|
|
export function focus_tracker_notify(object: Object): void
|
|
/**
|
|
* Returns the binary age as passed to libtool when building the ATK
|
|
* library the process is running against.
|
|
* @returns the binary age of the ATK library
|
|
*/
|
|
export function get_binary_age(): number
|
|
/**
|
|
* Gets a default implementation of the #AtkObjectFactory/type
|
|
* registry.
|
|
* Note: For most toolkit maintainers, this will be the correct
|
|
* registry for registering new #AtkObject factories. Following
|
|
* a call to this function, maintainers may call atk_registry_set_factory_type()
|
|
* to associate an #AtkObjectFactory subclass with the GType of objects
|
|
* for whom accessibility information will be provided.
|
|
* @returns a default implementation of the #AtkObjectFactory/type registry
|
|
*/
|
|
export function get_default_registry(): Registry
|
|
/**
|
|
* Gets the currently focused object.
|
|
* @returns the currently focused object for the current application
|
|
*/
|
|
export function get_focus_object(): Object
|
|
/**
|
|
* Returns the interface age as passed to libtool when building the
|
|
* ATK library the process is running against.
|
|
* @returns the interface age of the ATK library
|
|
*/
|
|
export function get_interface_age(): number
|
|
/**
|
|
* Returns the major version number of the ATK library. (e.g. in ATK
|
|
* version 2.7.4 this is 2.)
|
|
*
|
|
* This function is in the library, so it represents the ATK library
|
|
* your code is running against. In contrast, the #ATK_MAJOR_VERSION
|
|
* macro represents the major version of the ATK headers you have
|
|
* included when compiling your code.
|
|
* @returns the major version number of the ATK library
|
|
*/
|
|
export function get_major_version(): number
|
|
/**
|
|
* Returns the micro version number of the ATK library. (e.g. in ATK
|
|
* version 2.7.4 this is 4.)
|
|
*
|
|
* This function is in the library, so it represents the ATK library
|
|
* your code is are running against. In contrast, the
|
|
* #ATK_MICRO_VERSION macro represents the micro version of the ATK
|
|
* headers you have included when compiling your code.
|
|
* @returns the micro version number of the ATK library
|
|
*/
|
|
export function get_micro_version(): number
|
|
/**
|
|
* Returns the minor version number of the ATK library. (e.g. in ATK
|
|
* version 2.7.4 this is 7.)
|
|
*
|
|
* This function is in the library, so it represents the ATK library
|
|
* your code is are running against. In contrast, the
|
|
* #ATK_MINOR_VERSION macro represents the minor version of the ATK
|
|
* headers you have included when compiling your code.
|
|
* @returns the minor version number of the ATK library
|
|
*/
|
|
export function get_minor_version(): number
|
|
/**
|
|
* Gets the root accessible container for the current application.
|
|
* @returns the root accessible container for the current application
|
|
*/
|
|
export function get_root(): Object
|
|
/**
|
|
* Gets name string for the GUI toolkit implementing ATK for this application.
|
|
* @returns name string for the GUI toolkit implementing ATK for this application
|
|
*/
|
|
export function get_toolkit_name(): string | null
|
|
/**
|
|
* Gets version string for the GUI toolkit implementing ATK for this application.
|
|
* @returns version string for the GUI toolkit implementing ATK for this application
|
|
*/
|
|
export function get_toolkit_version(): string | null
|
|
/**
|
|
* Gets the current version for ATK.
|
|
* @returns version string for ATK
|
|
*/
|
|
export function get_version(): string | null
|
|
/**
|
|
* Get the #AtkRelationType type corresponding to a relation name.
|
|
* @param name a string which is the (non-localized) name of an ATK relation type.
|
|
* @returns the #AtkRelationType enumerated type corresponding to the specified name, or #ATK_RELATION_NULL if no matching relation type is found.
|
|
*/
|
|
export function relation_type_for_name(name: string | null): RelationType
|
|
/**
|
|
* Gets the description string describing the #AtkRelationType `type`.
|
|
* @param type The #AtkRelationType whose name is required
|
|
* @returns the string describing the AtkRelationType
|
|
*/
|
|
export function relation_type_get_name(type: RelationType): string | null
|
|
/**
|
|
* Associate `name` with a new #AtkRelationType
|
|
* @param name a name string
|
|
* @returns an #AtkRelationType associated with @name
|
|
*/
|
|
export function relation_type_register(name: string | null): RelationType
|
|
/**
|
|
* Removes the specified focus tracker from the list of functions
|
|
* to be called when any object receives focus.
|
|
* @param tracker_id the id of the focus tracker to remove
|
|
*/
|
|
export function remove_focus_tracker(tracker_id: number): void
|
|
/**
|
|
* `listener_id` is the value returned by #atk_add_global_event_listener
|
|
* when you registered that event listener.
|
|
*
|
|
* Toolkit implementor note: ATK provides a default implementation for
|
|
* this virtual method. ATK implementors are discouraged from
|
|
* reimplementing this method.
|
|
*
|
|
* Toolkit implementor note: this method is not intended to be used by
|
|
* ATK implementors but by ATK consumers.
|
|
*
|
|
* Removes the specified event listener
|
|
* @param listener_id the id of the event listener to remove
|
|
*/
|
|
export function remove_global_event_listener(listener_id: number): void
|
|
/**
|
|
* `listener_id` is the value returned by #atk_add_key_event_listener
|
|
* when you registered that event listener.
|
|
*
|
|
* Removes the specified event listener.
|
|
* @param listener_id the id of the event listener to remove
|
|
*/
|
|
export function remove_key_event_listener(listener_id: number): void
|
|
/**
|
|
* Get the #AtkRole type corresponding to a rolew name.
|
|
* @param 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.
|
|
*/
|
|
export function role_for_name(name: string | null): Role
|
|
/**
|
|
* Gets the localized description string describing the #AtkRole `role`.
|
|
* @param role The #AtkRole whose localized name is required
|
|
* @returns the localized string describing the AtkRole
|
|
*/
|
|
export function role_get_localized_name(role: Role): string | null
|
|
/**
|
|
* Gets the description string describing the #AtkRole `role`.
|
|
* @param role The #AtkRole whose name is required
|
|
* @returns the string describing the AtkRole
|
|
*/
|
|
export function role_get_name(role: Role): string | null
|
|
/**
|
|
* Registers the role specified by `name`. `name` must be a meaningful
|
|
* name. So it should not be empty, or consisting on whitespaces.
|
|
* @param name a character string describing the new role.
|
|
* @returns an #AtkRole for the new role if added properly. ATK_ROLE_INVALID in case of error.
|
|
*/
|
|
export function role_register(name: string | null): Role
|
|
/**
|
|
* Gets the #AtkStateType corresponding to the description string `name`.
|
|
* @param name a character string state name
|
|
* @returns an #AtkStateType corresponding to @name
|
|
*/
|
|
export function state_type_for_name(name: string | null): StateType
|
|
/**
|
|
* Gets the description string describing the #AtkStateType `type`.
|
|
* @param type The #AtkStateType whose name is required
|
|
* @returns the string describing the AtkStateType
|
|
*/
|
|
export function state_type_get_name(type: StateType): string | null
|
|
/**
|
|
* Register a new object state.
|
|
* @param name a character string describing the new state.
|
|
* @returns an #AtkState value for the new state.
|
|
*/
|
|
export function state_type_register(name: string | null): StateType
|
|
/**
|
|
* Get the #AtkTextAttribute type corresponding to a text attribute name.
|
|
* @param name a string which is the (non-localized) name of an ATK text attribute.
|
|
* @returns the #AtkTextAttribute enumerated type corresponding to the specified name, or #ATK_TEXT_ATTRIBUTE_INVALID if no matching text attribute is found.
|
|
*/
|
|
export function text_attribute_for_name(name: string | null): TextAttribute
|
|
/**
|
|
* Gets the name corresponding to the #AtkTextAttribute
|
|
* @param attr The #AtkTextAttribute whose name is required
|
|
* @returns a string containing the name; this string should not be freed
|
|
*/
|
|
export function text_attribute_get_name(attr: TextAttribute): string | null
|
|
/**
|
|
* Gets the value for the index of the #AtkTextAttribute
|
|
* @param attr The #AtkTextAttribute for which a value is required
|
|
* @param index_ The index of the required value
|
|
* @returns a string containing the value; this string should not be freed; %NULL is returned if there are no values maintained for the attr value.
|
|
*/
|
|
export function text_attribute_get_value(attr: TextAttribute, index_: number): string | null
|
|
/**
|
|
* Associate `name` with a new #AtkTextAttribute
|
|
* @param name a name string
|
|
* @returns an #AtkTextAttribute associated with @name
|
|
*/
|
|
export function text_attribute_register(name: string | null): TextAttribute
|
|
/**
|
|
* Frees the memory associated with an array of AtkTextRange. It is assumed
|
|
* that the array was returned by the function atk_text_get_bounded_ranges
|
|
* and is NULL terminated.
|
|
* @param ranges A pointer to an array of #AtkTextRange which is to be freed.
|
|
*/
|
|
export function text_free_ranges(ranges: TextRange[]): void
|
|
/**
|
|
* Gets the localized description string describing the #AtkValueType `value_type`.
|
|
* @param value_type The #AtkValueType whose localized name is required
|
|
* @returns the localized string describing the #AtkValueType
|
|
*/
|
|
export function value_type_get_localized_name(value_type: ValueType): string | null
|
|
/**
|
|
* Gets the description string describing the #AtkValueType `value_type`.
|
|
* @param value_type The #AtkValueType whose name is required
|
|
* @returns the string describing the #AtkValueType
|
|
*/
|
|
export function value_type_get_name(value_type: ValueType): string | null
|
|
/**
|
|
* A function which is called when an object emits a matching event,
|
|
* as used in #atk_add_focus_tracker.
|
|
* Currently the only events for which object-specific handlers are
|
|
* supported are events of type "focus:". Most clients of ATK will prefer to
|
|
* attach signal handlers for the various ATK signals instead.
|
|
*
|
|
* see [id`atk_add_focus_tracker]`
|
|
* @callback
|
|
* @param obj An #AtkObject instance for whom the callback will be called when the specified event (e.g. 'focus:') takes place.
|
|
*/
|
|
export interface EventListener {
|
|
(obj: Object): void
|
|
}
|
|
/**
|
|
* An #AtkEventListenerInit function is a special function that is
|
|
* called in order to initialize the per-object event registration system
|
|
* used by #AtkEventListener, if any preparation is required.
|
|
*
|
|
* see [id`atk_focus_tracker_init]`
|
|
* @callback
|
|
*/
|
|
export interface EventListenerInit {
|
|
(): void
|
|
}
|
|
/**
|
|
* The type of callback function used for
|
|
* atk_component_add_focus_handler() and
|
|
* atk_component_remove_focus_handler()
|
|
* @callback
|
|
* @param object the #AtkObject that receives/lose the focus
|
|
* @param focus_in TRUE if the object receives the focus
|
|
*/
|
|
export interface FocusHandler {
|
|
(object: Object, focus_in: boolean): void
|
|
}
|
|
/**
|
|
* An AtkFunction is a function definition used for padding which has
|
|
* been added to class and interface structures to allow for expansion
|
|
* in the future.
|
|
* @callback
|
|
* @returns not used
|
|
*/
|
|
export interface Function {
|
|
(): boolean
|
|
}
|
|
/**
|
|
* An #AtkKeySnoopFunc is a type of callback which is called whenever a key event occurs,
|
|
* if registered via atk_add_key_event_listener. It allows for pre-emptive
|
|
* interception of key events via the return code as described below.
|
|
* @callback
|
|
* @param event an AtkKeyEventStruct containing information about the key event for which notification is being given.
|
|
* @returns TRUE (nonzero) if the event emission should be stopped and the event discarded without being passed to the normal GUI recipient; FALSE (zero) if the event dispatch to the client application should proceed as normal. see [id@atk_add_key_event_listener]
|
|
*/
|
|
export interface KeySnoopFunc {
|
|
(event: KeyEventStruct): number
|
|
}
|
|
/**
|
|
* An AtkPropertyChangeHandler is a function which is executed when an
|
|
* AtkObject's property changes value. It is specified in a call to
|
|
* atk_object_connect_property_change_handler().
|
|
* @callback
|
|
* @param obj atkobject which property changes
|
|
* @param vals values changed
|
|
*/
|
|
export interface PropertyChangeHandler {
|
|
(obj: Object, vals: PropertyValues): void
|
|
}
|
|
export module Action {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface Action {
|
|
|
|
// Owm methods of Atk-1.0.Atk.Action
|
|
|
|
/**
|
|
* Perform the specified action on the object.
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @returns %TRUE if success, %FALSE otherwise
|
|
*/
|
|
do_action(i: number): boolean
|
|
/**
|
|
* Returns a description of the specified action of the object.
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @returns a description string, or %NULL if @action does not implement this interface.
|
|
*/
|
|
get_description(i: number): string | null
|
|
/**
|
|
* Gets the keybinding which can be used to activate this action, if one
|
|
* exists. The string returned should contain localized, human-readable,
|
|
* key sequences as they would appear when displayed on screen. It must
|
|
* be in the format "mnemonic;sequence;shortcut".
|
|
*
|
|
* - The mnemonic key activates the object if it is presently enabled onscreen.
|
|
* This typically corresponds to the underlined letter within the widget.
|
|
* Example: "n" in a traditional "New..." menu item or the "a" in "Apply" for
|
|
* a button.
|
|
* - The sequence is the full list of keys which invoke the action even if the
|
|
* relevant element is not currently shown on screen. For instance, for a menu
|
|
* item the sequence is the keybindings used to open the parent menus before
|
|
* invoking. The sequence string is colon-delimited. Example: "Alt+F:N" in a
|
|
* traditional "New..." menu item.
|
|
* - The shortcut, if it exists, will invoke the same action without showing
|
|
* the component or its enclosing menus or dialogs. Example: "Ctrl+N" in a
|
|
* traditional "New..." menu item.
|
|
*
|
|
* Example: For a traditional "New..." menu item, the expected return value
|
|
* would be: "N;Alt+F:N;Ctrl+N" for the English locale and "N;Alt+D:N;Strg+N"
|
|
* for the German locale. If, hypothetically, this menu item lacked a mnemonic,
|
|
* it would be represented by ";;Ctrl+N" and ";;Strg+N" respectively.
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @returns the keybinding which can be used to activate this action, or %NULL if there is no keybinding for this action.
|
|
*/
|
|
get_keybinding(i: number): string | null
|
|
/**
|
|
* Returns the localized name of the specified action of the object.
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @returns a name string, or %NULL if @action does not implement this interface.
|
|
*/
|
|
get_localized_name(i: number): string | null
|
|
/**
|
|
* 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 the number of actions, or 0 if @action does not implement this interface.
|
|
*/
|
|
get_n_actions(): number
|
|
/**
|
|
* Returns a non-localized string naming the specified action of the
|
|
* object. This name is generally not descriptive of the end result
|
|
* of the action, but instead names the 'interaction type' which the
|
|
* object supports. By convention, the above strings should be used to
|
|
* represent the actions which correspond to the common point-and-click
|
|
* interaction 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 the
|
|
* object, if one exists.
|
|
*
|
|
* For technical reasons, some toolkits cannot guarantee that the
|
|
* reported action is actually 'bound' to a nontrivial user event;
|
|
* i.e. the result of some actions via atk_action_do_action() may be
|
|
* NIL.
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @returns a name string, or %NULL if @action does not implement this interface.
|
|
*/
|
|
get_name(i: number): string | null
|
|
/**
|
|
* Sets a description of the specified action of the object.
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @param desc the description to be assigned to this action
|
|
* @returns a gboolean representing if the description was successfully set;
|
|
*/
|
|
set_description(i: number, desc: string | null): boolean
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.Action
|
|
|
|
/**
|
|
* Perform the specified action on the object.
|
|
* @virtual
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @returns %TRUE if success, %FALSE otherwise
|
|
*/
|
|
vfunc_do_action(i: number): boolean
|
|
/**
|
|
* Returns a description of the specified action of the object.
|
|
* @virtual
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @returns a description string, or %NULL if @action does not implement this interface.
|
|
*/
|
|
vfunc_get_description(i: number): string | null
|
|
/**
|
|
* Gets the keybinding which can be used to activate this action, if one
|
|
* exists. The string returned should contain localized, human-readable,
|
|
* key sequences as they would appear when displayed on screen. It must
|
|
* be in the format "mnemonic;sequence;shortcut".
|
|
*
|
|
* - The mnemonic key activates the object if it is presently enabled onscreen.
|
|
* This typically corresponds to the underlined letter within the widget.
|
|
* Example: "n" in a traditional "New..." menu item or the "a" in "Apply" for
|
|
* a button.
|
|
* - The sequence is the full list of keys which invoke the action even if the
|
|
* relevant element is not currently shown on screen. For instance, for a menu
|
|
* item the sequence is the keybindings used to open the parent menus before
|
|
* invoking. The sequence string is colon-delimited. Example: "Alt+F:N" in a
|
|
* traditional "New..." menu item.
|
|
* - The shortcut, if it exists, will invoke the same action without showing
|
|
* the component or its enclosing menus or dialogs. Example: "Ctrl+N" in a
|
|
* traditional "New..." menu item.
|
|
*
|
|
* Example: For a traditional "New..." menu item, the expected return value
|
|
* would be: "N;Alt+F:N;Ctrl+N" for the English locale and "N;Alt+D:N;Strg+N"
|
|
* for the German locale. If, hypothetically, this menu item lacked a mnemonic,
|
|
* it would be represented by ";;Ctrl+N" and ";;Strg+N" respectively.
|
|
* @virtual
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @returns the keybinding which can be used to activate this action, or %NULL if there is no keybinding for this action.
|
|
*/
|
|
vfunc_get_keybinding(i: number): string | null
|
|
/**
|
|
* Returns the localized name of the specified action of the object.
|
|
* @virtual
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @returns a name string, or %NULL if @action does not implement this interface.
|
|
*/
|
|
vfunc_get_localized_name(i: number): string | null
|
|
/**
|
|
* 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.
|
|
* @virtual
|
|
* @returns a the number of actions, or 0 if @action does not implement this interface.
|
|
*/
|
|
vfunc_get_n_actions(): number
|
|
/**
|
|
* Returns a non-localized string naming the specified action of the
|
|
* object. This name is generally not descriptive of the end result
|
|
* of the action, but instead names the 'interaction type' which the
|
|
* object supports. By convention, the above strings should be used to
|
|
* represent the actions which correspond to the common point-and-click
|
|
* interaction 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 the
|
|
* object, if one exists.
|
|
*
|
|
* For technical reasons, some toolkits cannot guarantee that the
|
|
* reported action is actually 'bound' to a nontrivial user event;
|
|
* i.e. the result of some actions via atk_action_do_action() may be
|
|
* NIL.
|
|
* @virtual
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @returns a name string, or %NULL if @action does not implement this interface.
|
|
*/
|
|
vfunc_get_name(i: number): string | null
|
|
/**
|
|
* Sets a description of the specified action of the object.
|
|
* @virtual
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @param desc the description to be assigned to this action
|
|
* @returns a gboolean representing if the description was successfully set;
|
|
*/
|
|
vfunc_set_description(i: number, desc: string | null): boolean
|
|
|
|
// Class property signals of Atk-1.0.Atk.Action
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The ATK interface provided by UI components
|
|
* which the user can activate/interact with.
|
|
*
|
|
* #AtkAction should be implemented by instances of #AtkObject classes
|
|
* with which the user can interact directly, i.e. buttons,
|
|
* checkboxes, scrollbars, e.g. components which are not "passive"
|
|
* providers of UI information.
|
|
*
|
|
* Exceptions: when the user interaction is already covered by another
|
|
* appropriate interface such as #AtkEditableText (insert/delete text,
|
|
* etc.) or #AtkValue (set value) then these actions should not be
|
|
* exposed by #AtkAction as well.
|
|
*
|
|
* Though most UI interactions on components should be invocable via
|
|
* keyboard as well as mouse, there will generally be a close mapping
|
|
* between "mouse actions" that are possible on a component and the
|
|
* AtkActions. Where mouse and keyboard actions are redundant in
|
|
* effect, #AtkAction should expose only one action rather than
|
|
* exposing redundant actions if possible. By convention we have been
|
|
* using "mouse centric" terminology for #AtkAction names.
|
|
* @interface
|
|
*/
|
|
export class Action extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Action
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Action>
|
|
|
|
// Constructors of Atk-1.0.Atk.Action
|
|
|
|
constructor(config?: Action.ConstructorProperties)
|
|
_init(config?: Action.ConstructorProperties): void
|
|
}
|
|
|
|
export module Component {
|
|
|
|
// Signal callback interfaces
|
|
|
|
/**
|
|
* Signal callback interface for `bounds-changed`
|
|
*/
|
|
export interface BoundsChangedSignalCallback {
|
|
($obj: Component, arg1: Rectangle): void
|
|
}
|
|
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface Component {
|
|
|
|
// Owm methods of Atk-1.0.Atk.Component
|
|
|
|
/**
|
|
* Checks whether the specified point is within the extent of the `component`.
|
|
*
|
|
* Toolkit implementor note: ATK provides a default implementation for
|
|
* this virtual method. In general there are little reason to
|
|
* re-implement it.
|
|
* @param x x coordinate
|
|
* @param y y coordinate
|
|
* @param coord_type specifies whether the coordinates are relative to the screen or to the components top level window
|
|
* @returns %TRUE or %FALSE indicating whether the specified point is within the extent of the @component or not
|
|
*/
|
|
contains(x: number, y: number, coord_type: CoordType): boolean
|
|
/**
|
|
* Returns the alpha value (i.e. the opacity) for this
|
|
* `component,` on a scale from 0 (fully transparent) to 1.0
|
|
* (fully opaque).
|
|
* @returns An alpha value from 0 to 1.0, inclusive.
|
|
*/
|
|
get_alpha(): number
|
|
/**
|
|
* Gets the rectangle which gives the extent of the `component`.
|
|
*
|
|
* If the extent can not be obtained (e.g. a non-embedded plug or missing
|
|
* support), all of x, y, width, height are set to -1.
|
|
* @param coord_type specifies whether the coordinates are relative to the screen or to the components top level window
|
|
*/
|
|
get_extents(coord_type: CoordType): [ /* x */ number, /* y */ number, /* width */ number, /* height */ number ]
|
|
/**
|
|
* Gets the layer of the component.
|
|
* @returns an #AtkLayer which is the layer of the component
|
|
*/
|
|
get_layer(): Layer
|
|
/**
|
|
* 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.
|
|
* @returns a gint 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.
|
|
*/
|
|
get_mdi_zorder(): number
|
|
/**
|
|
* Gets the position of `component` in the form of
|
|
* a point specifying `component'`s top-left corner.
|
|
*
|
|
* If the position can not be obtained (e.g. a non-embedded plug or missing
|
|
* support), x and y are set to -1.
|
|
* @param coord_type specifies whether the coordinates are relative to the screen or to the components top level window
|
|
*/
|
|
get_position(coord_type: CoordType): [ /* x */ number, /* y */ number ]
|
|
/**
|
|
* Gets the size of the `component` in terms of width and height.
|
|
*
|
|
* If the size can not be obtained (e.g. a non-embedded plug or missing
|
|
* support), width and height are set to -1.
|
|
*/
|
|
get_size(): [ /* width */ number, /* height */ number ]
|
|
/**
|
|
* Grabs focus for this `component`.
|
|
* @returns %TRUE if successful, %FALSE otherwise.
|
|
*/
|
|
grab_focus(): boolean
|
|
/**
|
|
* Gets a reference to the accessible child, if one exists, at the
|
|
* coordinate point specified by `x` and `y`.
|
|
* @param x x coordinate
|
|
* @param y y coordinate
|
|
* @param coord_type specifies whether the coordinates are relative to the screen or to the components top level window
|
|
* @returns a reference to the accessible child, if one exists
|
|
*/
|
|
ref_accessible_at_point(x: number, y: number, coord_type: CoordType): Object | null
|
|
/**
|
|
* Remove the handler specified by `handler_id` from the list of
|
|
* functions to be executed when this object receives focus events
|
|
* (in or out).
|
|
* @param handler_id the handler id of the focus handler to be removed from `component`
|
|
*/
|
|
remove_focus_handler(handler_id: number): void
|
|
/**
|
|
* Makes `component` visible on the screen by scrolling all necessary parents.
|
|
*
|
|
* Contrary to atk_component_set_position, this does not actually move
|
|
* `component` in its parent, this only makes the parents scroll so that the
|
|
* object shows up on the screen, given its current position within the parents.
|
|
* @param type specify where the object should be made visible.
|
|
* @returns whether scrolling was successful.
|
|
*/
|
|
scroll_to(type: ScrollType): boolean
|
|
/**
|
|
* Move the top-left of `component` to a given position of the screen by
|
|
* scrolling all necessary parents.
|
|
* @param coords specify whether coordinates are relative to the screen or to the parent object.
|
|
* @param x x-position where to scroll to
|
|
* @param y y-position where to scroll to
|
|
* @returns whether scrolling was successful.
|
|
*/
|
|
scroll_to_point(coords: CoordType, x: number, y: number): boolean
|
|
/**
|
|
* Sets the extents of `component`.
|
|
* @param x x coordinate
|
|
* @param y y coordinate
|
|
* @param width width to set for `component`
|
|
* @param height height to set for `component`
|
|
* @param coord_type specifies whether the coordinates are relative to the screen or to the components top level window
|
|
* @returns %TRUE or %FALSE whether the extents were set or not
|
|
*/
|
|
set_extents(x: number, y: number, width: number, height: number, coord_type: CoordType): boolean
|
|
/**
|
|
* Sets the position of `component`.
|
|
*
|
|
* Contrary to atk_component_scroll_to, this does not trigger any scrolling,
|
|
* this just moves `component` in its parent.
|
|
* @param x x coordinate
|
|
* @param y y coordinate
|
|
* @param coord_type specifies whether the coordinates are relative to the screen or to the component's top level window
|
|
* @returns %TRUE or %FALSE whether or not the position was set or not
|
|
*/
|
|
set_position(x: number, y: number, coord_type: CoordType): boolean
|
|
/**
|
|
* Set the size of the `component` in terms of width and height.
|
|
* @param width width to set for `component`
|
|
* @param height height to set for `component`
|
|
* @returns %TRUE or %FALSE whether the size was set or not
|
|
*/
|
|
set_size(width: number, height: number): boolean
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.Component
|
|
|
|
vfunc_bounds_changed(bounds: Rectangle): void
|
|
/**
|
|
* Checks whether the specified point is within the extent of the `component`.
|
|
*
|
|
* Toolkit implementor note: ATK provides a default implementation for
|
|
* this virtual method. In general there are little reason to
|
|
* re-implement it.
|
|
* @virtual
|
|
* @param x x coordinate
|
|
* @param y y coordinate
|
|
* @param coord_type specifies whether the coordinates are relative to the screen or to the components top level window
|
|
* @returns %TRUE or %FALSE indicating whether the specified point is within the extent of the @component or not
|
|
*/
|
|
vfunc_contains(x: number, y: number, coord_type: CoordType): boolean
|
|
/**
|
|
* Returns the alpha value (i.e. the opacity) for this
|
|
* `component,` on a scale from 0 (fully transparent) to 1.0
|
|
* (fully opaque).
|
|
* @virtual
|
|
* @returns An alpha value from 0 to 1.0, inclusive.
|
|
*/
|
|
vfunc_get_alpha(): number
|
|
/**
|
|
* Gets the rectangle which gives the extent of the `component`.
|
|
*
|
|
* If the extent can not be obtained (e.g. a non-embedded plug or missing
|
|
* support), all of x, y, width, height are set to -1.
|
|
* @virtual
|
|
* @param coord_type specifies whether the coordinates are relative to the screen or to the components top level window
|
|
*/
|
|
vfunc_get_extents(coord_type: CoordType): [ /* x */ number, /* y */ number, /* width */ number, /* height */ number ]
|
|
/**
|
|
* Gets the layer of the component.
|
|
* @virtual
|
|
* @returns an #AtkLayer which is the layer of the component
|
|
*/
|
|
vfunc_get_layer(): Layer
|
|
/**
|
|
* 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.
|
|
* @virtual
|
|
* @returns a gint 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.
|
|
*/
|
|
vfunc_get_mdi_zorder(): number
|
|
/**
|
|
* Gets the position of `component` in the form of
|
|
* a point specifying `component'`s top-left corner.
|
|
*
|
|
* If the position can not be obtained (e.g. a non-embedded plug or missing
|
|
* support), x and y are set to -1.
|
|
* @virtual
|
|
* @param coord_type specifies whether the coordinates are relative to the screen or to the components top level window
|
|
*/
|
|
vfunc_get_position(coord_type: CoordType): [ /* x */ number, /* y */ number ]
|
|
/**
|
|
* Gets the size of the `component` in terms of width and height.
|
|
*
|
|
* If the size can not be obtained (e.g. a non-embedded plug or missing
|
|
* support), width and height are set to -1.
|
|
* @virtual
|
|
*/
|
|
vfunc_get_size(): [ /* width */ number, /* height */ number ]
|
|
/**
|
|
* Grabs focus for this `component`.
|
|
* @virtual
|
|
* @returns %TRUE if successful, %FALSE otherwise.
|
|
*/
|
|
vfunc_grab_focus(): boolean
|
|
/**
|
|
* Gets a reference to the accessible child, if one exists, at the
|
|
* coordinate point specified by `x` and `y`.
|
|
* @virtual
|
|
* @param x x coordinate
|
|
* @param y y coordinate
|
|
* @param coord_type specifies whether the coordinates are relative to the screen or to the components top level window
|
|
* @returns a reference to the accessible child, if one exists
|
|
*/
|
|
vfunc_ref_accessible_at_point(x: number, y: number, coord_type: CoordType): Object | null
|
|
/**
|
|
* Remove the handler specified by `handler_id` from the list of
|
|
* functions to be executed when this object receives focus events
|
|
* (in or out).
|
|
* @virtual
|
|
* @param handler_id the handler id of the focus handler to be removed from `component`
|
|
*/
|
|
vfunc_remove_focus_handler(handler_id: number): void
|
|
/**
|
|
* Makes `component` visible on the screen by scrolling all necessary parents.
|
|
*
|
|
* Contrary to atk_component_set_position, this does not actually move
|
|
* `component` in its parent, this only makes the parents scroll so that the
|
|
* object shows up on the screen, given its current position within the parents.
|
|
* @virtual
|
|
* @param type specify where the object should be made visible.
|
|
* @returns whether scrolling was successful.
|
|
*/
|
|
vfunc_scroll_to(type: ScrollType): boolean
|
|
/**
|
|
* Move the top-left of `component` to a given position of the screen by
|
|
* scrolling all necessary parents.
|
|
* @virtual
|
|
* @param coords specify whether coordinates are relative to the screen or to the parent object.
|
|
* @param x x-position where to scroll to
|
|
* @param y y-position where to scroll to
|
|
* @returns whether scrolling was successful.
|
|
*/
|
|
vfunc_scroll_to_point(coords: CoordType, x: number, y: number): boolean
|
|
/**
|
|
* Sets the extents of `component`.
|
|
* @virtual
|
|
* @param x x coordinate
|
|
* @param y y coordinate
|
|
* @param width width to set for `component`
|
|
* @param height height to set for `component`
|
|
* @param coord_type specifies whether the coordinates are relative to the screen or to the components top level window
|
|
* @returns %TRUE or %FALSE whether the extents were set or not
|
|
*/
|
|
vfunc_set_extents(x: number, y: number, width: number, height: number, coord_type: CoordType): boolean
|
|
/**
|
|
* Sets the position of `component`.
|
|
*
|
|
* Contrary to atk_component_scroll_to, this does not trigger any scrolling,
|
|
* this just moves `component` in its parent.
|
|
* @virtual
|
|
* @param x x coordinate
|
|
* @param y y coordinate
|
|
* @param coord_type specifies whether the coordinates are relative to the screen or to the component's top level window
|
|
* @returns %TRUE or %FALSE whether or not the position was set or not
|
|
*/
|
|
vfunc_set_position(x: number, y: number, coord_type: CoordType): boolean
|
|
/**
|
|
* Set the size of the `component` in terms of width and height.
|
|
* @virtual
|
|
* @param width width to set for `component`
|
|
* @param height height to set for `component`
|
|
* @returns %TRUE or %FALSE whether the size was set or not
|
|
*/
|
|
vfunc_set_size(width: number, height: number): boolean
|
|
|
|
// Own signals of Atk-1.0.Atk.Component
|
|
|
|
connect(sigName: "bounds-changed", callback: Component.BoundsChangedSignalCallback): number
|
|
connect_after(sigName: "bounds-changed", callback: Component.BoundsChangedSignalCallback): number
|
|
emit(sigName: "bounds-changed", arg1: Rectangle, ...args: any[]): void
|
|
|
|
// Class property signals of Atk-1.0.Atk.Component
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The ATK interface provided by UI components
|
|
* which occupy a physical area on the screen.
|
|
* which the user can activate/interact with.
|
|
*
|
|
* #AtkComponent 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 #AtkComponent implementations provided
|
|
* for their corresponding #AtkObject 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 #AtkText.
|
|
* @interface
|
|
*/
|
|
export class Component extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Component
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Component>
|
|
|
|
// Constructors of Atk-1.0.Atk.Component
|
|
|
|
constructor(config?: Component.ConstructorProperties)
|
|
_init(config?: Component.ConstructorProperties): void
|
|
}
|
|
|
|
export module Document {
|
|
|
|
// Signal callback interfaces
|
|
|
|
/**
|
|
* Signal callback interface for `load-complete`
|
|
*/
|
|
export interface LoadCompleteSignalCallback {
|
|
($obj: Document): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `load-stopped`
|
|
*/
|
|
export interface LoadStoppedSignalCallback {
|
|
($obj: Document): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `page-changed`
|
|
*/
|
|
export interface PageChangedSignalCallback {
|
|
($obj: Document, page_number: number): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `reload`
|
|
*/
|
|
export interface ReloadSignalCallback {
|
|
($obj: Document): void
|
|
}
|
|
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface Document {
|
|
|
|
// Owm methods of Atk-1.0.Atk.Document
|
|
|
|
/**
|
|
* Retrieves the value of the given `attribute_name` inside `document`.
|
|
* @param attribute_name a character string representing the name of the attribute whose value is being queried.
|
|
* @returns a string value associated with the named attribute for this document, or %NULL if a value for @attribute_name has not been specified for this document.
|
|
*/
|
|
get_attribute_value(attribute_name: string | null): string | null
|
|
/**
|
|
* Gets an AtkAttributeSet which describes document-wide
|
|
* attributes as name-value pairs.
|
|
* @returns An AtkAttributeSet containing the explicitly set name-value-pair attributes associated with this document as a whole.
|
|
*/
|
|
get_attributes(): AttributeSet
|
|
/**
|
|
* Retrieves the current page number inside `document`.
|
|
* @returns the current page number inside @document, or -1 if not implemented, not know by the implementor, or irrelevant.
|
|
*/
|
|
get_current_page_number(): number
|
|
/**
|
|
* Gets a %gpointer that points to an instance of the DOM. It is
|
|
* up to the caller to check atk_document_get_type to determine
|
|
* how to cast this pointer.
|
|
* @returns a %gpointer that points to an instance of the DOM.
|
|
*/
|
|
get_document(): any | null
|
|
/**
|
|
* Gets a string indicating the document type.
|
|
* @returns a string indicating the document type
|
|
*/
|
|
get_document_type(): string | null
|
|
/**
|
|
* Gets a UTF-8 string indicating the POSIX-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.
|
|
* @returns a UTF-8 string indicating the POSIX-style LC_MESSAGES locale of the document content as a whole, or NULL if the document content does not specify a locale.
|
|
*/
|
|
get_locale(): string | null
|
|
/**
|
|
* Retrieves the total number of pages inside `document`.
|
|
* @returns total page count of @document, or -1 if not implemented, not know by the implementor or irrelevant.
|
|
*/
|
|
get_page_count(): number
|
|
/**
|
|
* Sets the value for the given `attribute_name` inside `document`.
|
|
* @param attribute_name a character string representing the name of the attribute whose value is being set.
|
|
* @param attribute_value a string value to be associated with `attribute_name`.
|
|
* @returns %TRUE if @attribute_value is successfully associated with @attribute_name for this @document, and %FALSE if if the document does not allow the attribute to be modified
|
|
*/
|
|
set_attribute_value(attribute_name: string | null, attribute_value: string | null): boolean
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.Document
|
|
|
|
/**
|
|
* Retrieves the current page number inside `document`.
|
|
* @virtual
|
|
* @returns the current page number inside @document, or -1 if not implemented, not know by the implementor, or irrelevant.
|
|
*/
|
|
vfunc_get_current_page_number(): number
|
|
/**
|
|
* Gets a %gpointer that points to an instance of the DOM. It is
|
|
* up to the caller to check atk_document_get_type to determine
|
|
* how to cast this pointer.
|
|
* @virtual
|
|
* @returns a %gpointer that points to an instance of the DOM.
|
|
*/
|
|
vfunc_get_document(): any | null
|
|
/**
|
|
* Retrieves the value of the given `attribute_name` inside `document`.
|
|
* @virtual
|
|
* @param attribute_name a character string representing the name of the attribute whose value is being queried.
|
|
* @returns a string value associated with the named attribute for this document, or %NULL if a value for @attribute_name has not been specified for this document.
|
|
*/
|
|
vfunc_get_document_attribute_value(attribute_name: string | null): string | null
|
|
/**
|
|
* Gets an AtkAttributeSet which describes document-wide
|
|
* attributes as name-value pairs.
|
|
* @virtual
|
|
* @returns An AtkAttributeSet containing the explicitly set name-value-pair attributes associated with this document as a whole.
|
|
*/
|
|
vfunc_get_document_attributes(): AttributeSet
|
|
/**
|
|
* Gets a UTF-8 string indicating the POSIX-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.
|
|
* @virtual
|
|
* @returns a UTF-8 string indicating the POSIX-style LC_MESSAGES locale of the document content as a whole, or NULL if the document content does not specify a locale.
|
|
*/
|
|
vfunc_get_document_locale(): string | null
|
|
/**
|
|
* Gets a string indicating the document type.
|
|
* @virtual
|
|
* @returns a string indicating the document type
|
|
*/
|
|
vfunc_get_document_type(): string | null
|
|
/**
|
|
* Retrieves the total number of pages inside `document`.
|
|
* @virtual
|
|
* @returns total page count of @document, or -1 if not implemented, not know by the implementor or irrelevant.
|
|
*/
|
|
vfunc_get_page_count(): number
|
|
/**
|
|
* Sets the value for the given `attribute_name` inside `document`.
|
|
* @virtual
|
|
* @param attribute_name a character string representing the name of the attribute whose value is being set.
|
|
* @param attribute_value a string value to be associated with `attribute_name`.
|
|
* @returns %TRUE if @attribute_value is successfully associated with @attribute_name for this @document, and %FALSE if if the document does not allow the attribute to be modified
|
|
*/
|
|
vfunc_set_document_attribute(attribute_name: string | null, attribute_value: string | null): boolean
|
|
|
|
// Own signals of Atk-1.0.Atk.Document
|
|
|
|
connect(sigName: "load-complete", callback: Document.LoadCompleteSignalCallback): number
|
|
connect_after(sigName: "load-complete", callback: Document.LoadCompleteSignalCallback): number
|
|
emit(sigName: "load-complete", ...args: any[]): void
|
|
connect(sigName: "load-stopped", callback: Document.LoadStoppedSignalCallback): number
|
|
connect_after(sigName: "load-stopped", callback: Document.LoadStoppedSignalCallback): number
|
|
emit(sigName: "load-stopped", ...args: any[]): void
|
|
connect(sigName: "page-changed", callback: Document.PageChangedSignalCallback): number
|
|
connect_after(sigName: "page-changed", callback: Document.PageChangedSignalCallback): number
|
|
emit(sigName: "page-changed", page_number: number, ...args: any[]): void
|
|
connect(sigName: "reload", callback: Document.ReloadSignalCallback): number
|
|
connect_after(sigName: "reload", callback: Document.ReloadSignalCallback): number
|
|
emit(sigName: "reload", ...args: any[]): void
|
|
|
|
// Class property signals of Atk-1.0.Atk.Document
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The ATK interface which represents the toplevel
|
|
* container for document content.
|
|
*
|
|
* The AtkDocument interface should be supported by any object whose
|
|
* content is a representation or view of a document. The AtkDocument
|
|
* interface should appear on the toplevel container for the document
|
|
* content; however AtkDocument instances may be nested (i.e. an
|
|
* AtkDocument may be a descendant of another AtkDocument) in those
|
|
* cases where one document contains "embedded content" which can
|
|
* reasonably be considered a document in its own right.
|
|
* @interface
|
|
*/
|
|
export class Document extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Document
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Document>
|
|
|
|
// Constructors of Atk-1.0.Atk.Document
|
|
|
|
constructor(config?: Document.ConstructorProperties)
|
|
_init(config?: Document.ConstructorProperties): void
|
|
}
|
|
|
|
export module EditableText {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface EditableText {
|
|
|
|
// Owm methods of Atk-1.0.Atk.EditableText
|
|
|
|
/**
|
|
* Copy text from `start_pos` up to, but not including `end_pos`
|
|
* to the clipboard.
|
|
* @param start_pos start position
|
|
* @param end_pos end position
|
|
*/
|
|
copy_text(start_pos: number, end_pos: number): void
|
|
/**
|
|
* Copy text from `start_pos` up to, but not including `end_pos`
|
|
* to the clipboard and then delete from the widget.
|
|
* @param start_pos start position
|
|
* @param end_pos end position
|
|
*/
|
|
cut_text(start_pos: number, end_pos: number): void
|
|
/**
|
|
* Delete text `start_pos` up to, but not including `end_pos`.
|
|
* @param start_pos start position
|
|
* @param end_pos end position
|
|
*/
|
|
delete_text(start_pos: number, end_pos: number): void
|
|
/**
|
|
* Insert text at a given position.
|
|
* @param string the text to insert
|
|
* @param length the length of text to insert, in bytes
|
|
* @param position The caller initializes this to the position at which to insert the text. After the call it points at the position after the newly inserted text.
|
|
*/
|
|
insert_text(string: string | null, length: number, position: number): void
|
|
/**
|
|
* Paste text from clipboard to specified `position`.
|
|
* @param position position to paste
|
|
*/
|
|
paste_text(position: number): void
|
|
/**
|
|
* Sets the attributes for a specified range. See the ATK_ATTRIBUTE
|
|
* macros (such as #ATK_ATTRIBUTE_LEFT_MARGIN) for examples of attributes
|
|
* that can be set. Note that other attributes that do not have corresponding
|
|
* ATK_ATTRIBUTE macros may also be set for certain text widgets.
|
|
* @param attrib_set an #AtkAttributeSet
|
|
* @param start_offset start of range in which to set attributes
|
|
* @param end_offset end of range in which to set attributes
|
|
* @returns %TRUE if attributes successfully set for the specified range, otherwise %FALSE
|
|
*/
|
|
set_run_attributes(attrib_set: AttributeSet, start_offset: number, end_offset: number): boolean
|
|
/**
|
|
* Set text contents of `text`.
|
|
* @param string string to set for text contents of `text`
|
|
*/
|
|
set_text_contents(string: string | null): void
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.EditableText
|
|
|
|
/**
|
|
* Copy text from `start_pos` up to, but not including `end_pos`
|
|
* to the clipboard.
|
|
* @virtual
|
|
* @param start_pos start position
|
|
* @param end_pos end position
|
|
*/
|
|
vfunc_copy_text(start_pos: number, end_pos: number): void
|
|
/**
|
|
* Copy text from `start_pos` up to, but not including `end_pos`
|
|
* to the clipboard and then delete from the widget.
|
|
* @virtual
|
|
* @param start_pos start position
|
|
* @param end_pos end position
|
|
*/
|
|
vfunc_cut_text(start_pos: number, end_pos: number): void
|
|
/**
|
|
* Delete text `start_pos` up to, but not including `end_pos`.
|
|
* @virtual
|
|
* @param start_pos start position
|
|
* @param end_pos end position
|
|
*/
|
|
vfunc_delete_text(start_pos: number, end_pos: number): void
|
|
/**
|
|
* Insert text at a given position.
|
|
* @virtual
|
|
* @param string the text to insert
|
|
* @param length the length of text to insert, in bytes
|
|
* @param position The caller initializes this to the position at which to insert the text. After the call it points at the position after the newly inserted text.
|
|
*/
|
|
vfunc_insert_text(string: string | null, length: number, position: number): void
|
|
/**
|
|
* Paste text from clipboard to specified `position`.
|
|
* @virtual
|
|
* @param position position to paste
|
|
*/
|
|
vfunc_paste_text(position: number): void
|
|
/**
|
|
* Sets the attributes for a specified range. See the ATK_ATTRIBUTE
|
|
* macros (such as #ATK_ATTRIBUTE_LEFT_MARGIN) for examples of attributes
|
|
* that can be set. Note that other attributes that do not have corresponding
|
|
* ATK_ATTRIBUTE macros may also be set for certain text widgets.
|
|
* @virtual
|
|
* @param attrib_set an #AtkAttributeSet
|
|
* @param start_offset start of range in which to set attributes
|
|
* @param end_offset end of range in which to set attributes
|
|
* @returns %TRUE if attributes successfully set for the specified range, otherwise %FALSE
|
|
*/
|
|
vfunc_set_run_attributes(attrib_set: AttributeSet, start_offset: number, end_offset: number): boolean
|
|
/**
|
|
* Set text contents of `text`.
|
|
* @virtual
|
|
* @param string string to set for text contents of `text`
|
|
*/
|
|
vfunc_set_text_contents(string: string | null): void
|
|
|
|
// Class property signals of Atk-1.0.Atk.EditableText
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The ATK interface implemented by components containing user-editable text content.
|
|
*
|
|
* #AtkEditableText should be implemented by UI components which
|
|
* contain text which the user can edit, via the #AtkObject
|
|
* corresponding to that component (see #AtkObject).
|
|
*
|
|
* #AtkEditableText is a subclass of #AtkText, and as such, an object
|
|
* which implements #AtkEditableText is by definition an #AtkText
|
|
* implementor as well.
|
|
*
|
|
* See [iface`AtkText]`
|
|
* @interface
|
|
*/
|
|
export class EditableText extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.EditableText
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<EditableText>
|
|
|
|
// Constructors of Atk-1.0.Atk.EditableText
|
|
|
|
constructor(config?: EditableText.ConstructorProperties)
|
|
_init(config?: EditableText.ConstructorProperties): void
|
|
}
|
|
|
|
export module HyperlinkImpl {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface HyperlinkImpl {
|
|
|
|
// Owm methods of Atk-1.0.Atk.HyperlinkImpl
|
|
|
|
/**
|
|
* Gets the hyperlink associated with this object.
|
|
* @returns an AtkHyperlink object which points to this implementing AtkObject.
|
|
*/
|
|
get_hyperlink(): Hyperlink
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.HyperlinkImpl
|
|
|
|
/**
|
|
* Gets the hyperlink associated with this object.
|
|
* @virtual
|
|
* @returns an AtkHyperlink object which points to this implementing AtkObject.
|
|
*/
|
|
vfunc_get_hyperlink(): Hyperlink
|
|
|
|
// Class property signals of Atk-1.0.Atk.HyperlinkImpl
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* A queryable interface which allows AtkHyperlink instances
|
|
* associated with an AtkObject to be obtained. AtkHyperlinkImpl
|
|
* corresponds to AT-SPI's Hyperlink interface, and differs from
|
|
* AtkHyperlink in that AtkHyperlink is an object type, rather than an
|
|
* interface, and thus cannot be directly queried. FTW
|
|
* @interface
|
|
*/
|
|
export class HyperlinkImpl extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.HyperlinkImpl
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<HyperlinkImpl>
|
|
|
|
// Constructors of Atk-1.0.Atk.HyperlinkImpl
|
|
|
|
constructor(config?: HyperlinkImpl.ConstructorProperties)
|
|
_init(config?: HyperlinkImpl.ConstructorProperties): void
|
|
}
|
|
|
|
export module Hypertext {
|
|
|
|
// Signal callback interfaces
|
|
|
|
/**
|
|
* Signal callback interface for `link-selected`
|
|
*/
|
|
export interface LinkSelectedSignalCallback {
|
|
($obj: Hypertext, arg1: number): void
|
|
}
|
|
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface Hypertext {
|
|
|
|
// Owm methods of Atk-1.0.Atk.Hypertext
|
|
|
|
/**
|
|
* Gets the link in this hypertext document at index
|
|
* `link_index`
|
|
* @param link_index an integer specifying the desired link
|
|
* @returns the link in this hypertext document at index @link_index
|
|
*/
|
|
get_link(link_index: number): Hyperlink
|
|
/**
|
|
* Gets the index into the array of hyperlinks that is associated with
|
|
* the character specified by `char_index`.
|
|
* @param char_index a character index
|
|
* @returns an index into the array of hyperlinks in @hypertext, or -1 if there is no hyperlink associated with this character.
|
|
*/
|
|
get_link_index(char_index: number): number
|
|
/**
|
|
* Gets the number of links within this hypertext document.
|
|
* @returns the number of links within this hypertext document
|
|
*/
|
|
get_n_links(): number
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.Hypertext
|
|
|
|
/**
|
|
* Gets the link in this hypertext document at index
|
|
* `link_index`
|
|
* @virtual
|
|
* @param link_index an integer specifying the desired link
|
|
* @returns the link in this hypertext document at index @link_index
|
|
*/
|
|
vfunc_get_link(link_index: number): Hyperlink
|
|
/**
|
|
* Gets the index into the array of hyperlinks that is associated with
|
|
* the character specified by `char_index`.
|
|
* @virtual
|
|
* @param char_index a character index
|
|
* @returns an index into the array of hyperlinks in @hypertext, or -1 if there is no hyperlink associated with this character.
|
|
*/
|
|
vfunc_get_link_index(char_index: number): number
|
|
/**
|
|
* Gets the number of links within this hypertext document.
|
|
* @virtual
|
|
* @returns the number of links within this hypertext document
|
|
*/
|
|
vfunc_get_n_links(): number
|
|
vfunc_link_selected(link_index: number): void
|
|
|
|
// Own signals of Atk-1.0.Atk.Hypertext
|
|
|
|
connect(sigName: "link-selected", callback: Hypertext.LinkSelectedSignalCallback): number
|
|
connect_after(sigName: "link-selected", callback: Hypertext.LinkSelectedSignalCallback): number
|
|
emit(sigName: "link-selected", arg1: number, ...args: any[]): void
|
|
|
|
// Class property signals of Atk-1.0.Atk.Hypertext
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The ATK interface which provides standard mechanism for manipulating hyperlinks.
|
|
*
|
|
* An interface used for objects which implement linking between
|
|
* multiple resource or content locations, or multiple 'markers'
|
|
* within a single document. A Hypertext instance is associated with
|
|
* one or more Hyperlinks, which are associated with particular
|
|
* offsets within the Hypertext's included content. While this
|
|
* interface is derived from Text, there is no requirement that
|
|
* Hypertext instances have textual content; they may implement Image
|
|
* as well, and Hyperlinks need not have non-zero text offsets.
|
|
* @interface
|
|
*/
|
|
export class Hypertext extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Hypertext
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Hypertext>
|
|
|
|
// Constructors of Atk-1.0.Atk.Hypertext
|
|
|
|
constructor(config?: Hypertext.ConstructorProperties)
|
|
_init(config?: Hypertext.ConstructorProperties): void
|
|
}
|
|
|
|
export module Image {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface Image {
|
|
|
|
// Owm methods of Atk-1.0.Atk.Image
|
|
|
|
/**
|
|
* Get a textual description of this image.
|
|
* @returns a string representing the image description
|
|
*/
|
|
get_image_description(): string | null
|
|
/**
|
|
* Retrieves the locale identifier associated to the #AtkImage.
|
|
* @returns a string corresponding to the POSIX `LC_MESSAGES` locale used by the image description, or %NULL if the image does not specify a locale.
|
|
*/
|
|
get_image_locale(): string | null
|
|
/**
|
|
* Gets the position of the image in the form of a point specifying the
|
|
* images top-left corner.
|
|
*
|
|
* If the position can not be obtained (e.g. missing support), x and y are set
|
|
* to -1.
|
|
* @param coord_type specifies whether the coordinates are relative to the screen or to the components top level window
|
|
*/
|
|
get_image_position(coord_type: CoordType): [ /* x */ number, /* y */ number ]
|
|
/**
|
|
* Get the width and height in pixels for the specified image.
|
|
* The values of `width` and `height` are returned as -1 if the
|
|
* values cannot be obtained (for instance, if the object is not onscreen).
|
|
*
|
|
* If the size can not be obtained (e.g. missing support), x and y are set
|
|
* to -1.
|
|
*/
|
|
get_image_size(): [ /* width */ number, /* height */ number ]
|
|
/**
|
|
* Sets the textual description for this image.
|
|
* @param description a string description to set for `image`
|
|
* @returns boolean TRUE, or FALSE if operation could not be completed.
|
|
*/
|
|
set_image_description(description: string | null): boolean
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.Image
|
|
|
|
/**
|
|
* Get a textual description of this image.
|
|
* @virtual
|
|
* @returns a string representing the image description
|
|
*/
|
|
vfunc_get_image_description(): string | null
|
|
/**
|
|
* Retrieves the locale identifier associated to the #AtkImage.
|
|
* @virtual
|
|
* @returns a string corresponding to the POSIX `LC_MESSAGES` locale used by the image description, or %NULL if the image does not specify a locale.
|
|
*/
|
|
vfunc_get_image_locale(): string | null
|
|
/**
|
|
* Gets the position of the image in the form of a point specifying the
|
|
* images top-left corner.
|
|
*
|
|
* If the position can not be obtained (e.g. missing support), x and y are set
|
|
* to -1.
|
|
* @virtual
|
|
* @param coord_type specifies whether the coordinates are relative to the screen or to the components top level window
|
|
*/
|
|
vfunc_get_image_position(coord_type: CoordType): [ /* x */ number, /* y */ number ]
|
|
/**
|
|
* Get the width and height in pixels for the specified image.
|
|
* The values of `width` and `height` are returned as -1 if the
|
|
* values cannot be obtained (for instance, if the object is not onscreen).
|
|
*
|
|
* If the size can not be obtained (e.g. missing support), x and y are set
|
|
* to -1.
|
|
* @virtual
|
|
*/
|
|
vfunc_get_image_size(): [ /* width */ number, /* height */ number ]
|
|
/**
|
|
* Sets the textual description for this image.
|
|
* @virtual
|
|
* @param description a string description to set for `image`
|
|
* @returns boolean TRUE, or FALSE if operation could not be completed.
|
|
*/
|
|
vfunc_set_image_description(description: string | null): boolean
|
|
|
|
// Class property signals of Atk-1.0.Atk.Image
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The ATK Interface implemented by components
|
|
* which expose image or pixmap content on-screen.
|
|
*
|
|
* #AtkImage should be implemented by #AtkObject subtypes on behalf of
|
|
* components which display image/pixmap information onscreen, and
|
|
* which provide information (other than just widget borders, etc.)
|
|
* via that image content. For instance, icons, buttons with icons,
|
|
* toolbar elements, and image viewing panes typically should
|
|
* implement #AtkImage.
|
|
*
|
|
* #AtkImage primarily provides two types of information: coordinate
|
|
* information (useful for screen review mode of screenreaders, and
|
|
* for use by onscreen magnifiers), and descriptive information. The
|
|
* descriptive information is provided for alternative, text-only
|
|
* presentation of the most significant information present in the
|
|
* image.
|
|
* @interface
|
|
*/
|
|
export class Image extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Image
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Image>
|
|
|
|
// Constructors of Atk-1.0.Atk.Image
|
|
|
|
constructor(config?: Image.ConstructorProperties)
|
|
_init(config?: Image.ConstructorProperties): void
|
|
}
|
|
|
|
export module ImplementorIface {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface ImplementorIface {
|
|
|
|
// Class property signals of Atk-1.0.Atk.ImplementorIface
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The AtkImplementor interface is implemented by objects for which
|
|
* AtkObject peers may be obtained via calls to
|
|
* iface->(ref_accessible)(implementor);
|
|
* @interface
|
|
*/
|
|
export class ImplementorIface extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.ImplementorIface
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<ImplementorIface>
|
|
|
|
// Constructors of Atk-1.0.Atk.ImplementorIface
|
|
|
|
constructor(config?: ImplementorIface.ConstructorProperties)
|
|
_init(config?: ImplementorIface.ConstructorProperties): void
|
|
}
|
|
|
|
export module Selection {
|
|
|
|
// Signal callback interfaces
|
|
|
|
/**
|
|
* Signal callback interface for `selection-changed`
|
|
*/
|
|
export interface SelectionChangedSignalCallback {
|
|
($obj: Selection): void
|
|
}
|
|
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface Selection {
|
|
|
|
// Owm methods of Atk-1.0.Atk.Selection
|
|
|
|
/**
|
|
* Adds the specified accessible child of the object to the
|
|
* object's selection.
|
|
* @param i a #gint specifying the child index.
|
|
* @returns TRUE if success, FALSE otherwise.
|
|
*/
|
|
add_selection(i: number): boolean
|
|
/**
|
|
* Clears the selection in the object so that no children in the object
|
|
* are selected.
|
|
* @returns TRUE if success, FALSE otherwise.
|
|
*/
|
|
clear_selection(): boolean
|
|
/**
|
|
* Gets the number of accessible children currently selected.
|
|
* Note: callers should not rely on %NULL or on a zero value for
|
|
* indication of whether AtkSelectionIface is implemented, they should
|
|
* use type checking/interface checking macros or the
|
|
* atk_get_accessible_value() convenience method.
|
|
* @returns a gint representing the number of items selected, or 0 if @selection does not implement this interface.
|
|
*/
|
|
get_selection_count(): number
|
|
/**
|
|
* Determines if the current child of this object is selected
|
|
* Note: callers should not rely on %NULL or on a zero value for
|
|
* indication of whether AtkSelectionIface is implemented, they should
|
|
* use type checking/interface checking macros or the
|
|
* atk_get_accessible_value() convenience method.
|
|
* @param i a #gint specifying the child index.
|
|
* @returns a gboolean representing the specified child is selected, or 0 if @selection does not implement this interface.
|
|
*/
|
|
is_child_selected(i: number): boolean
|
|
/**
|
|
* Gets a reference to the accessible object representing the specified
|
|
* selected child of the object.
|
|
* Note: callers should not rely on %NULL or on a zero value for
|
|
* indication of whether AtkSelectionIface is implemented, they should
|
|
* use type checking/interface checking macros or the
|
|
* atk_get_accessible_value() convenience method.
|
|
* @param i a #gint specifying the index in the selection set. (e.g. the ith selection as opposed to the ith child).
|
|
* @returns an #AtkObject representing the selected accessible, or %NULL if @selection does not implement this interface.
|
|
*/
|
|
ref_selection(i: number): Object | null
|
|
/**
|
|
* Removes the specified child of the object from the object's selection.
|
|
* @param i a #gint specifying the index in the selection set. (e.g. the ith selection as opposed to the ith child).
|
|
* @returns TRUE if success, FALSE otherwise.
|
|
*/
|
|
remove_selection(i: number): boolean
|
|
/**
|
|
* Causes every child of the object to be selected if the object
|
|
* supports multiple selections.
|
|
* @returns TRUE if success, FALSE otherwise.
|
|
*/
|
|
select_all_selection(): boolean
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.Selection
|
|
|
|
/**
|
|
* Adds the specified accessible child of the object to the
|
|
* object's selection.
|
|
* @virtual
|
|
* @param i a #gint specifying the child index.
|
|
* @returns TRUE if success, FALSE otherwise.
|
|
*/
|
|
vfunc_add_selection(i: number): boolean
|
|
/**
|
|
* Clears the selection in the object so that no children in the object
|
|
* are selected.
|
|
* @virtual
|
|
* @returns TRUE if success, FALSE otherwise.
|
|
*/
|
|
vfunc_clear_selection(): boolean
|
|
/**
|
|
* Gets the number of accessible children currently selected.
|
|
* Note: callers should not rely on %NULL or on a zero value for
|
|
* indication of whether AtkSelectionIface is implemented, they should
|
|
* use type checking/interface checking macros or the
|
|
* atk_get_accessible_value() convenience method.
|
|
* @virtual
|
|
* @returns a gint representing the number of items selected, or 0 if @selection does not implement this interface.
|
|
*/
|
|
vfunc_get_selection_count(): number
|
|
/**
|
|
* Determines if the current child of this object is selected
|
|
* Note: callers should not rely on %NULL or on a zero value for
|
|
* indication of whether AtkSelectionIface is implemented, they should
|
|
* use type checking/interface checking macros or the
|
|
* atk_get_accessible_value() convenience method.
|
|
* @virtual
|
|
* @param i a #gint specifying the child index.
|
|
* @returns a gboolean representing the specified child is selected, or 0 if @selection does not implement this interface.
|
|
*/
|
|
vfunc_is_child_selected(i: number): boolean
|
|
/**
|
|
* Gets a reference to the accessible object representing the specified
|
|
* selected child of the object.
|
|
* Note: callers should not rely on %NULL or on a zero value for
|
|
* indication of whether AtkSelectionIface is implemented, they should
|
|
* use type checking/interface checking macros or the
|
|
* atk_get_accessible_value() convenience method.
|
|
* @virtual
|
|
* @param i a #gint specifying the index in the selection set. (e.g. the ith selection as opposed to the ith child).
|
|
* @returns an #AtkObject representing the selected accessible, or %NULL if @selection does not implement this interface.
|
|
*/
|
|
vfunc_ref_selection(i: number): Object | null
|
|
/**
|
|
* Removes the specified child of the object from the object's selection.
|
|
* @virtual
|
|
* @param i a #gint specifying the index in the selection set. (e.g. the ith selection as opposed to the ith child).
|
|
* @returns TRUE if success, FALSE otherwise.
|
|
*/
|
|
vfunc_remove_selection(i: number): boolean
|
|
/**
|
|
* Causes every child of the object to be selected if the object
|
|
* supports multiple selections.
|
|
* @virtual
|
|
* @returns TRUE if success, FALSE otherwise.
|
|
*/
|
|
vfunc_select_all_selection(): boolean
|
|
vfunc_selection_changed(): void
|
|
|
|
// Own signals of Atk-1.0.Atk.Selection
|
|
|
|
connect(sigName: "selection-changed", callback: Selection.SelectionChangedSignalCallback): number
|
|
connect_after(sigName: "selection-changed", callback: Selection.SelectionChangedSignalCallback): number
|
|
emit(sigName: "selection-changed", ...args: any[]): void
|
|
|
|
// Class property signals of Atk-1.0.Atk.Selection
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The ATK interface implemented by container objects whose #AtkObject children can be selected.
|
|
*
|
|
* #AtkSelection should be implemented by UI components with children
|
|
* which are exposed by #atk_object_ref_child and
|
|
* #atk_object_get_n_children, if the use of the parent UI component
|
|
* ordinarily involves selection of one or more of the objects
|
|
* corresponding to those #AtkObject children - for example,
|
|
* selectable lists.
|
|
*
|
|
* Note that other types of "selection" (for instance text selection)
|
|
* are accomplished a other ATK interfaces - #AtkSelection is limited
|
|
* to the selection/deselection of children.
|
|
* @interface
|
|
*/
|
|
export class Selection extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Selection
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Selection>
|
|
|
|
// Constructors of Atk-1.0.Atk.Selection
|
|
|
|
constructor(config?: Selection.ConstructorProperties)
|
|
_init(config?: Selection.ConstructorProperties): void
|
|
}
|
|
|
|
export module StreamableContent {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface StreamableContent {
|
|
|
|
// Owm methods of Atk-1.0.Atk.StreamableContent
|
|
|
|
/**
|
|
* Gets the character string of the specified mime type. The first mime
|
|
* type is at position 0, the second at position 1, and so on.
|
|
* @param i a gint representing the position of the mime type starting from 0
|
|
* @returns a gchar* representing the specified mime type; the caller should not free the character string.
|
|
*/
|
|
get_mime_type(i: number): string | null
|
|
/**
|
|
* Gets the number of mime types supported by this object.
|
|
* @returns a gint which is the number of mime types supported by the object.
|
|
*/
|
|
get_n_mime_types(): number
|
|
/**
|
|
* Gets the content in the specified mime type.
|
|
* @param mime_type a gchar* representing the mime type
|
|
* @returns A #GIOChannel which contains the content in the specified mime type.
|
|
*/
|
|
get_stream(mime_type: string | null): GLib.IOChannel
|
|
/**
|
|
* Get a string representing a URI in IETF standard format
|
|
* (see http://www.ietf.org/rfc/rfc2396.txt) from which the object's content
|
|
* may be streamed in the specified mime-type, if one is available.
|
|
* If mime_type is NULL, the URI for the default (and possibly only) mime-type is
|
|
* returned.
|
|
*
|
|
* Note that it is possible for get_uri to return NULL but for
|
|
* get_stream to work nonetheless, since not all GIOChannels connect to URIs.
|
|
* @param mime_type a gchar* representing the mime type, or NULL to request a URI for the default mime type.
|
|
* @returns Returns a string representing a URI, or %NULL if no corresponding URI can be constructed.
|
|
*/
|
|
get_uri(mime_type: string | null): string | null
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.StreamableContent
|
|
|
|
/**
|
|
* Gets the character string of the specified mime type. The first mime
|
|
* type is at position 0, the second at position 1, and so on.
|
|
* @virtual
|
|
* @param i a gint representing the position of the mime type starting from 0
|
|
* @returns a gchar* representing the specified mime type; the caller should not free the character string.
|
|
*/
|
|
vfunc_get_mime_type(i: number): string | null
|
|
/**
|
|
* Gets the number of mime types supported by this object.
|
|
* @virtual
|
|
* @returns a gint which is the number of mime types supported by the object.
|
|
*/
|
|
vfunc_get_n_mime_types(): number
|
|
/**
|
|
* Gets the content in the specified mime type.
|
|
* @virtual
|
|
* @param mime_type a gchar* representing the mime type
|
|
* @returns A #GIOChannel which contains the content in the specified mime type.
|
|
*/
|
|
vfunc_get_stream(mime_type: string | null): GLib.IOChannel
|
|
/**
|
|
* Get a string representing a URI in IETF standard format
|
|
* (see http://www.ietf.org/rfc/rfc2396.txt) from which the object's content
|
|
* may be streamed in the specified mime-type, if one is available.
|
|
* If mime_type is NULL, the URI for the default (and possibly only) mime-type is
|
|
* returned.
|
|
*
|
|
* Note that it is possible for get_uri to return NULL but for
|
|
* get_stream to work nonetheless, since not all GIOChannels connect to URIs.
|
|
* @virtual
|
|
* @param mime_type a gchar* representing the mime type, or NULL to request a URI for the default mime type.
|
|
* @returns Returns a string representing a URI, or %NULL if no corresponding URI can be constructed.
|
|
*/
|
|
vfunc_get_uri(mime_type: string | null): string | null
|
|
|
|
// Class property signals of Atk-1.0.Atk.StreamableContent
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The ATK interface which provides access to streamable content.
|
|
*
|
|
* An interface whereby an object allows its backing content to be
|
|
* streamed to clients. Typical implementors would be images or
|
|
* icons, HTML content, or multimedia display/rendering widgets.
|
|
*
|
|
* Negotiation of content type is allowed. Clients may examine the
|
|
* backing data and transform, convert, or parse the content in order
|
|
* to present it in an alternate form to end-users.
|
|
*
|
|
* The AtkStreamableContent interface is particularly useful for
|
|
* saving, printing, or post-processing entire documents, or for
|
|
* persisting alternate views of a document. If document content
|
|
* itself is being serialized, stored, or converted, then use of the
|
|
* AtkStreamableContent interface can help address performance
|
|
* issues. Unlike most ATK interfaces, this interface is not strongly
|
|
* tied to the current user-agent view of the a particular document,
|
|
* but may in some cases give access to the underlying model data.
|
|
* @interface
|
|
*/
|
|
export class StreamableContent extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.StreamableContent
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<StreamableContent>
|
|
|
|
// Constructors of Atk-1.0.Atk.StreamableContent
|
|
|
|
constructor(config?: StreamableContent.ConstructorProperties)
|
|
_init(config?: StreamableContent.ConstructorProperties): void
|
|
}
|
|
|
|
export module Table {
|
|
|
|
// Signal callback interfaces
|
|
|
|
/**
|
|
* Signal callback interface for `column-deleted`
|
|
*/
|
|
export interface ColumnDeletedSignalCallback {
|
|
($obj: Table, arg1: number, arg2: number): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `column-inserted`
|
|
*/
|
|
export interface ColumnInsertedSignalCallback {
|
|
($obj: Table, arg1: number, arg2: number): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `column-reordered`
|
|
*/
|
|
export interface ColumnReorderedSignalCallback {
|
|
($obj: Table): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `model-changed`
|
|
*/
|
|
export interface ModelChangedSignalCallback {
|
|
($obj: Table): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `row-deleted`
|
|
*/
|
|
export interface RowDeletedSignalCallback {
|
|
($obj: Table, arg1: number, arg2: number): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `row-inserted`
|
|
*/
|
|
export interface RowInsertedSignalCallback {
|
|
($obj: Table, arg1: number, arg2: number): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `row-reordered`
|
|
*/
|
|
export interface RowReorderedSignalCallback {
|
|
($obj: Table): void
|
|
}
|
|
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface Table {
|
|
|
|
// Owm methods of Atk-1.0.Atk.Table
|
|
|
|
/**
|
|
* Adds the specified `column` to the selection.
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns a gboolean representing if the column was successfully added to the selection, or 0 if value does not implement this interface.
|
|
*/
|
|
add_column_selection(column: number): boolean
|
|
/**
|
|
* Adds the specified `row` to the selection.
|
|
* @param row a #gint representing a row in `table`
|
|
* @returns a gboolean representing if row was successfully added to selection, or 0 if value does not implement this interface.
|
|
*/
|
|
add_row_selection(row: number): boolean
|
|
/**
|
|
* Gets the caption for the `table`.
|
|
* @returns a AtkObject* representing the table caption, or %NULL if value does not implement this interface.
|
|
*/
|
|
get_caption(): Object | null
|
|
/**
|
|
* Gets a #gint representing the column at the specified `index_`.
|
|
* @param index_ a #gint representing an index in `table`
|
|
* @returns a gint representing the column at the specified index, or -1 if the table does not implement this method.
|
|
*/
|
|
get_column_at_index(index_: number): number
|
|
/**
|
|
* Gets the description text of the specified `column` in the table
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns a gchar* representing the column description, or %NULL if value does not implement this interface.
|
|
*/
|
|
get_column_description(column: number): string | null
|
|
/**
|
|
* Gets the number of columns occupied by the accessible object
|
|
* at the specified `row` and `column` in the `table`.
|
|
* @param row a #gint representing a row in `table`
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns a gint representing the column extent at specified position, or 0 if value does not implement this interface.
|
|
*/
|
|
get_column_extent_at(row: number, column: number): number
|
|
/**
|
|
* Gets the column header of a specified column in an accessible table.
|
|
* @param column a #gint representing a column in the table
|
|
* @returns a AtkObject* representing the specified column header, or %NULL if value does not implement this interface.
|
|
*/
|
|
get_column_header(column: number): Object | null
|
|
/**
|
|
* Gets a #gint representing the index at the specified `row` and
|
|
* `column`.
|
|
* @param row a #gint representing a row in `table`
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns a #gint representing the index at specified position. The value -1 is returned if the object at row,column is not a child of table or table does not implement this interface.
|
|
*/
|
|
get_index_at(row: number, column: number): number
|
|
/**
|
|
* Gets the number of columns in the table.
|
|
* @returns a gint representing the number of columns, or 0 if value does not implement this interface.
|
|
*/
|
|
get_n_columns(): number
|
|
/**
|
|
* Gets the number of rows in the table.
|
|
* @returns a gint representing the number of rows, or 0 if value does not implement this interface.
|
|
*/
|
|
get_n_rows(): number
|
|
/**
|
|
* Gets a #gint representing the row at the specified `index_`.
|
|
* @param index_ a #gint representing an index in `table`
|
|
* @returns a gint representing the row at the specified index, or -1 if the table does not implement this method.
|
|
*/
|
|
get_row_at_index(index_: number): number
|
|
/**
|
|
* Gets the description text of the specified row in the table
|
|
* @param row a #gint representing a row in `table`
|
|
* @returns a gchar* representing the row description, or %NULL if value does not implement this interface.
|
|
*/
|
|
get_row_description(row: number): string | null
|
|
/**
|
|
* Gets the number of rows occupied by the accessible object
|
|
* at a specified `row` and `column` in the `table`.
|
|
* @param row a #gint representing a row in `table`
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns a gint representing the row extent at specified position, or 0 if value does not implement this interface.
|
|
*/
|
|
get_row_extent_at(row: number, column: number): number
|
|
/**
|
|
* Gets the row header of a specified row in an accessible table.
|
|
* @param row a #gint representing a row in the table
|
|
* @returns a AtkObject* representing the specified row header, or %NULL if value does not implement this interface.
|
|
*/
|
|
get_row_header(row: number): Object | null
|
|
/**
|
|
* Gets the selected columns of the table by initializing **selected with
|
|
* the selected column numbers. This array should be freed by the caller.
|
|
* @param selected a #gint** that is to contain the selected columns numbers
|
|
* @returns a gint representing the number of selected columns, or %0 if value does not implement this interface.
|
|
*/
|
|
get_selected_columns(selected: number): number
|
|
/**
|
|
* Gets the selected rows of the table by initializing **selected with
|
|
* the selected row numbers. This array should be freed by the caller.
|
|
* @param selected a #gint** that is to contain the selected row numbers
|
|
* @returns a gint representing the number of selected rows, or zero if value does not implement this interface.
|
|
*/
|
|
get_selected_rows(selected: number): number
|
|
/**
|
|
* Gets the summary description of the table.
|
|
* @returns a AtkObject* representing a summary description of the table, or zero if value does not implement this interface.
|
|
*/
|
|
get_summary(): Object
|
|
/**
|
|
* Gets a boolean value indicating whether the specified `column`
|
|
* is selected
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns a gboolean representing if the column is selected, or 0 if value does not implement this interface.
|
|
*/
|
|
is_column_selected(column: number): boolean
|
|
/**
|
|
* Gets a boolean value indicating whether the specified `row`
|
|
* is selected
|
|
* @param row a #gint representing a row in `table`
|
|
* @returns a gboolean representing if the row is selected, or 0 if value does not implement this interface.
|
|
*/
|
|
is_row_selected(row: number): boolean
|
|
/**
|
|
* Gets a boolean value indicating whether the accessible object
|
|
* at the specified `row` and `column` is selected
|
|
* @param row a #gint representing a row in `table`
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns a gboolean representing if the cell is selected, or 0 if value does not implement this interface.
|
|
*/
|
|
is_selected(row: number, column: number): boolean
|
|
/**
|
|
* Get a reference to the table cell at `row,` `column`. This cell
|
|
* should implement the interface #AtkTableCell
|
|
* @param row a #gint representing a row in `table`
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns an #AtkObject representing the referred to accessible
|
|
*/
|
|
ref_at(row: number, column: number): Object
|
|
/**
|
|
* Adds the specified `column` to the selection.
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns a gboolean representing if the column was successfully removed from the selection, or 0 if value does not implement this interface.
|
|
*/
|
|
remove_column_selection(column: number): boolean
|
|
/**
|
|
* Removes the specified `row` from the selection.
|
|
* @param row a #gint representing a row in `table`
|
|
* @returns a gboolean representing if the row was successfully removed from the selection, or 0 if value does not implement this interface.
|
|
*/
|
|
remove_row_selection(row: number): boolean
|
|
/**
|
|
* Sets the caption for the table.
|
|
* @param caption a #AtkObject representing the caption to set for `table`
|
|
*/
|
|
set_caption(caption: Object): void
|
|
/**
|
|
* Sets the description text for the specified `column` of the `table`.
|
|
* @param column a #gint representing a column in `table`
|
|
* @param description a #gchar representing the description text to set for the specified `column` of the `table`
|
|
*/
|
|
set_column_description(column: number, description: string | null): void
|
|
/**
|
|
* Sets the specified column header to `header`.
|
|
* @param column a #gint representing a column in `table`
|
|
* @param header an #AtkTable
|
|
*/
|
|
set_column_header(column: number, header: Object): void
|
|
/**
|
|
* Sets the description text for the specified `row` of `table`.
|
|
* @param row a #gint representing a row in `table`
|
|
* @param description a #gchar representing the description text to set for the specified `row` of `table`
|
|
*/
|
|
set_row_description(row: number, description: string | null): void
|
|
/**
|
|
* Sets the specified row header to `header`.
|
|
* @param row a #gint representing a row in `table`
|
|
* @param header an #AtkTable
|
|
*/
|
|
set_row_header(row: number, header: Object): void
|
|
/**
|
|
* Sets the summary description of the table.
|
|
* @param accessible an #AtkObject representing the summary description to set for `table`
|
|
*/
|
|
set_summary(accessible: Object): void
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.Table
|
|
|
|
/**
|
|
* Adds the specified `column` to the selection.
|
|
* @virtual
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns a gboolean representing if the column was successfully added to the selection, or 0 if value does not implement this interface.
|
|
*/
|
|
vfunc_add_column_selection(column: number): boolean
|
|
/**
|
|
* Adds the specified `row` to the selection.
|
|
* @virtual
|
|
* @param row a #gint representing a row in `table`
|
|
* @returns a gboolean representing if row was successfully added to selection, or 0 if value does not implement this interface.
|
|
*/
|
|
vfunc_add_row_selection(row: number): boolean
|
|
vfunc_column_deleted(column: number, num_deleted: number): void
|
|
vfunc_column_inserted(column: number, num_inserted: number): void
|
|
vfunc_column_reordered(): void
|
|
/**
|
|
* Gets the caption for the `table`.
|
|
* @virtual
|
|
* @returns a AtkObject* representing the table caption, or %NULL if value does not implement this interface.
|
|
*/
|
|
vfunc_get_caption(): Object | null
|
|
/**
|
|
* Gets a #gint representing the column at the specified `index_`.
|
|
* @virtual
|
|
* @param index_ a #gint representing an index in `table`
|
|
* @returns a gint representing the column at the specified index, or -1 if the table does not implement this method.
|
|
*/
|
|
vfunc_get_column_at_index(index_: number): number
|
|
/**
|
|
* Gets the description text of the specified `column` in the table
|
|
* @virtual
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns a gchar* representing the column description, or %NULL if value does not implement this interface.
|
|
*/
|
|
vfunc_get_column_description(column: number): string | null
|
|
/**
|
|
* Gets the number of columns occupied by the accessible object
|
|
* at the specified `row` and `column` in the `table`.
|
|
* @virtual
|
|
* @param row a #gint representing a row in `table`
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns a gint representing the column extent at specified position, or 0 if value does not implement this interface.
|
|
*/
|
|
vfunc_get_column_extent_at(row: number, column: number): number
|
|
/**
|
|
* Gets the column header of a specified column in an accessible table.
|
|
* @virtual
|
|
* @param column a #gint representing a column in the table
|
|
* @returns a AtkObject* representing the specified column header, or %NULL if value does not implement this interface.
|
|
*/
|
|
vfunc_get_column_header(column: number): Object | null
|
|
/**
|
|
* Gets a #gint representing the index at the specified `row` and
|
|
* `column`.
|
|
* @virtual
|
|
* @param row a #gint representing a row in `table`
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns a #gint representing the index at specified position. The value -1 is returned if the object at row,column is not a child of table or table does not implement this interface.
|
|
*/
|
|
vfunc_get_index_at(row: number, column: number): number
|
|
/**
|
|
* Gets the number of columns in the table.
|
|
* @virtual
|
|
* @returns a gint representing the number of columns, or 0 if value does not implement this interface.
|
|
*/
|
|
vfunc_get_n_columns(): number
|
|
/**
|
|
* Gets the number of rows in the table.
|
|
* @virtual
|
|
* @returns a gint representing the number of rows, or 0 if value does not implement this interface.
|
|
*/
|
|
vfunc_get_n_rows(): number
|
|
/**
|
|
* Gets a #gint representing the row at the specified `index_`.
|
|
* @virtual
|
|
* @param index_ a #gint representing an index in `table`
|
|
* @returns a gint representing the row at the specified index, or -1 if the table does not implement this method.
|
|
*/
|
|
vfunc_get_row_at_index(index_: number): number
|
|
/**
|
|
* Gets the description text of the specified row in the table
|
|
* @virtual
|
|
* @param row a #gint representing a row in `table`
|
|
* @returns a gchar* representing the row description, or %NULL if value does not implement this interface.
|
|
*/
|
|
vfunc_get_row_description(row: number): string | null
|
|
/**
|
|
* Gets the number of rows occupied by the accessible object
|
|
* at a specified `row` and `column` in the `table`.
|
|
* @virtual
|
|
* @param row a #gint representing a row in `table`
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns a gint representing the row extent at specified position, or 0 if value does not implement this interface.
|
|
*/
|
|
vfunc_get_row_extent_at(row: number, column: number): number
|
|
/**
|
|
* Gets the row header of a specified row in an accessible table.
|
|
* @virtual
|
|
* @param row a #gint representing a row in the table
|
|
* @returns a AtkObject* representing the specified row header, or %NULL if value does not implement this interface.
|
|
*/
|
|
vfunc_get_row_header(row: number): Object | null
|
|
/**
|
|
* Gets the selected columns of the table by initializing **selected with
|
|
* the selected column numbers. This array should be freed by the caller.
|
|
* @virtual
|
|
* @param selected a #gint** that is to contain the selected columns numbers
|
|
* @returns a gint representing the number of selected columns, or %0 if value does not implement this interface.
|
|
*/
|
|
vfunc_get_selected_columns(selected: number): number
|
|
/**
|
|
* Gets the selected rows of the table by initializing **selected with
|
|
* the selected row numbers. This array should be freed by the caller.
|
|
* @virtual
|
|
* @param selected a #gint** that is to contain the selected row numbers
|
|
* @returns a gint representing the number of selected rows, or zero if value does not implement this interface.
|
|
*/
|
|
vfunc_get_selected_rows(selected: number): number
|
|
/**
|
|
* Gets the summary description of the table.
|
|
* @virtual
|
|
* @returns a AtkObject* representing a summary description of the table, or zero if value does not implement this interface.
|
|
*/
|
|
vfunc_get_summary(): Object
|
|
/**
|
|
* Gets a boolean value indicating whether the specified `column`
|
|
* is selected
|
|
* @virtual
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns a gboolean representing if the column is selected, or 0 if value does not implement this interface.
|
|
*/
|
|
vfunc_is_column_selected(column: number): boolean
|
|
/**
|
|
* Gets a boolean value indicating whether the specified `row`
|
|
* is selected
|
|
* @virtual
|
|
* @param row a #gint representing a row in `table`
|
|
* @returns a gboolean representing if the row is selected, or 0 if value does not implement this interface.
|
|
*/
|
|
vfunc_is_row_selected(row: number): boolean
|
|
/**
|
|
* Gets a boolean value indicating whether the accessible object
|
|
* at the specified `row` and `column` is selected
|
|
* @virtual
|
|
* @param row a #gint representing a row in `table`
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns a gboolean representing if the cell is selected, or 0 if value does not implement this interface.
|
|
*/
|
|
vfunc_is_selected(row: number, column: number): boolean
|
|
vfunc_model_changed(): void
|
|
/**
|
|
* Get a reference to the table cell at `row,` `column`. This cell
|
|
* should implement the interface #AtkTableCell
|
|
* @virtual
|
|
* @param row a #gint representing a row in `table`
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns an #AtkObject representing the referred to accessible
|
|
*/
|
|
vfunc_ref_at(row: number, column: number): Object
|
|
/**
|
|
* Adds the specified `column` to the selection.
|
|
* @virtual
|
|
* @param column a #gint representing a column in `table`
|
|
* @returns a gboolean representing if the column was successfully removed from the selection, or 0 if value does not implement this interface.
|
|
*/
|
|
vfunc_remove_column_selection(column: number): boolean
|
|
/**
|
|
* Removes the specified `row` from the selection.
|
|
* @virtual
|
|
* @param row a #gint representing a row in `table`
|
|
* @returns a gboolean representing if the row was successfully removed from the selection, or 0 if value does not implement this interface.
|
|
*/
|
|
vfunc_remove_row_selection(row: number): boolean
|
|
vfunc_row_deleted(row: number, num_deleted: number): void
|
|
vfunc_row_inserted(row: number, num_inserted: number): void
|
|
vfunc_row_reordered(): void
|
|
/**
|
|
* Sets the caption for the table.
|
|
* @virtual
|
|
* @param caption a #AtkObject representing the caption to set for `table`
|
|
*/
|
|
vfunc_set_caption(caption: Object): void
|
|
/**
|
|
* Sets the description text for the specified `column` of the `table`.
|
|
* @virtual
|
|
* @param column a #gint representing a column in `table`
|
|
* @param description a #gchar representing the description text to set for the specified `column` of the `table`
|
|
*/
|
|
vfunc_set_column_description(column: number, description: string | null): void
|
|
/**
|
|
* Sets the specified column header to `header`.
|
|
* @virtual
|
|
* @param column a #gint representing a column in `table`
|
|
* @param header an #AtkTable
|
|
*/
|
|
vfunc_set_column_header(column: number, header: Object): void
|
|
/**
|
|
* Sets the description text for the specified `row` of `table`.
|
|
* @virtual
|
|
* @param row a #gint representing a row in `table`
|
|
* @param description a #gchar representing the description text to set for the specified `row` of `table`
|
|
*/
|
|
vfunc_set_row_description(row: number, description: string | null): void
|
|
/**
|
|
* Sets the specified row header to `header`.
|
|
* @virtual
|
|
* @param row a #gint representing a row in `table`
|
|
* @param header an #AtkTable
|
|
*/
|
|
vfunc_set_row_header(row: number, header: Object): void
|
|
/**
|
|
* Sets the summary description of the table.
|
|
* @virtual
|
|
* @param accessible an #AtkObject representing the summary description to set for `table`
|
|
*/
|
|
vfunc_set_summary(accessible: Object): void
|
|
|
|
// Own signals of Atk-1.0.Atk.Table
|
|
|
|
connect(sigName: "column-deleted", callback: Table.ColumnDeletedSignalCallback): number
|
|
connect_after(sigName: "column-deleted", callback: Table.ColumnDeletedSignalCallback): number
|
|
emit(sigName: "column-deleted", arg1: number, arg2: number, ...args: any[]): void
|
|
connect(sigName: "column-inserted", callback: Table.ColumnInsertedSignalCallback): number
|
|
connect_after(sigName: "column-inserted", callback: Table.ColumnInsertedSignalCallback): number
|
|
emit(sigName: "column-inserted", arg1: number, arg2: number, ...args: any[]): void
|
|
connect(sigName: "column-reordered", callback: Table.ColumnReorderedSignalCallback): number
|
|
connect_after(sigName: "column-reordered", callback: Table.ColumnReorderedSignalCallback): number
|
|
emit(sigName: "column-reordered", ...args: any[]): void
|
|
connect(sigName: "model-changed", callback: Table.ModelChangedSignalCallback): number
|
|
connect_after(sigName: "model-changed", callback: Table.ModelChangedSignalCallback): number
|
|
emit(sigName: "model-changed", ...args: any[]): void
|
|
connect(sigName: "row-deleted", callback: Table.RowDeletedSignalCallback): number
|
|
connect_after(sigName: "row-deleted", callback: Table.RowDeletedSignalCallback): number
|
|
emit(sigName: "row-deleted", arg1: number, arg2: number, ...args: any[]): void
|
|
connect(sigName: "row-inserted", callback: Table.RowInsertedSignalCallback): number
|
|
connect_after(sigName: "row-inserted", callback: Table.RowInsertedSignalCallback): number
|
|
emit(sigName: "row-inserted", arg1: number, arg2: number, ...args: any[]): void
|
|
connect(sigName: "row-reordered", callback: Table.RowReorderedSignalCallback): number
|
|
connect_after(sigName: "row-reordered", callback: Table.RowReorderedSignalCallback): number
|
|
emit(sigName: "row-reordered", ...args: any[]): void
|
|
|
|
// Class property signals of Atk-1.0.Atk.Table
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The ATK interface implemented for UI components which contain tabular or row/column information.
|
|
*
|
|
* #AtkTable should be implemented by components which present
|
|
* elements ordered via rows and columns. It may also be used to
|
|
* present tree-structured information if the nodes of the trees can
|
|
* be said to contain multiple "columns". Individual elements of an
|
|
* #AtkTable are typically referred to as "cells". Those cells should
|
|
* implement the interface #AtkTableCell, but #Atk doesn't require
|
|
* them to be direct children of the current #AtkTable. They can be
|
|
* grand-children, grand-grand-children etc. #AtkTable provides the
|
|
* API needed to get a individual cell based on the row and column
|
|
* numbers.
|
|
*
|
|
* Children of #AtkTable are frequently "lightweight" objects, that
|
|
* is, they may not have backing widgets in the host UI toolkit. They
|
|
* are therefore often transient.
|
|
*
|
|
* Since tables are often very complex, #AtkTable includes provision
|
|
* for offering simplified summary information, as well as row and
|
|
* column headers and captions. Headers and captions are #AtkObjects
|
|
* which may implement other interfaces (#AtkText, #AtkImage, etc.) as
|
|
* appropriate. #AtkTable summaries may themselves be (simplified)
|
|
* #AtkTables, etc.
|
|
*
|
|
* Note for implementors: in the past, #AtkTable required that all the
|
|
* cells should be direct children of #AtkTable, and provided some
|
|
* index based methods to request the cells. The practice showed that
|
|
* that forcing made #AtkTable implementation complex, and hard to
|
|
* expose other kind of children, like rows or captions. Right now,
|
|
* index-based methods are deprecated.
|
|
* @interface
|
|
*/
|
|
export class Table extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Table
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Table>
|
|
|
|
// Constructors of Atk-1.0.Atk.Table
|
|
|
|
constructor(config?: Table.ConstructorProperties)
|
|
_init(config?: Table.ConstructorProperties): void
|
|
}
|
|
|
|
export module TableCell {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends Object.ConstructorProperties, GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface TableCell extends Object {
|
|
|
|
// Owm methods of Atk-1.0.Atk.TableCell
|
|
|
|
/**
|
|
* Returns the column headers as an array of cell accessibles.
|
|
* @returns a GPtrArray of AtkObjects representing the column header cells.
|
|
*/
|
|
get_column_header_cells(): Object[]
|
|
/**
|
|
* Returns the number of columns occupied by this cell accessible.
|
|
* @returns a gint representing the number of columns occupied by this cell, or 0 if the cell does not implement this method.
|
|
*/
|
|
get_column_span(): number
|
|
/**
|
|
* Retrieves the tabular position of this cell.
|
|
* @returns TRUE if successful; FALSE otherwise.
|
|
*/
|
|
get_position(): [ /* returnType */ boolean, /* row */ number, /* column */ number ]
|
|
/**
|
|
* Gets the row and column indexes and span of this cell accessible.
|
|
*
|
|
* Note: If the object does not implement this function, then, by default, atk
|
|
* will implement this function by calling get_row_span and get_column_span
|
|
* on the object.
|
|
* @returns TRUE if successful; FALSE otherwise.
|
|
*/
|
|
get_row_column_span(): [ /* returnType */ boolean, /* row */ number, /* column */ number, /* row_span */ number, /* column_span */ number ]
|
|
/**
|
|
* Returns the row headers as an array of cell accessibles.
|
|
* @returns a GPtrArray of AtkObjects representing the row header cells.
|
|
*/
|
|
get_row_header_cells(): Object[]
|
|
/**
|
|
* Returns the number of rows occupied by this cell accessible.
|
|
* @returns a gint representing the number of rows occupied by this cell, or 0 if the cell does not implement this method.
|
|
*/
|
|
get_row_span(): number
|
|
/**
|
|
* Returns a reference to the accessible of the containing table.
|
|
* @returns the atk object for the containing table.
|
|
*/
|
|
get_table(): Object
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.TableCell
|
|
|
|
/**
|
|
* Returns the column headers as an array of cell accessibles.
|
|
* @virtual
|
|
* @returns a GPtrArray of AtkObjects representing the column header cells.
|
|
*/
|
|
vfunc_get_column_header_cells(): Object[]
|
|
/**
|
|
* Returns the number of columns occupied by this cell accessible.
|
|
* @virtual
|
|
* @returns a gint representing the number of columns occupied by this cell, or 0 if the cell does not implement this method.
|
|
*/
|
|
vfunc_get_column_span(): number
|
|
/**
|
|
* Retrieves the tabular position of this cell.
|
|
* @virtual
|
|
* @returns TRUE if successful; FALSE otherwise.
|
|
*/
|
|
vfunc_get_position(): [ /* returnType */ boolean, /* row */ number, /* column */ number ]
|
|
/**
|
|
* Gets the row and column indexes and span of this cell accessible.
|
|
*
|
|
* Note: If the object does not implement this function, then, by default, atk
|
|
* will implement this function by calling get_row_span and get_column_span
|
|
* on the object.
|
|
* @virtual
|
|
* @returns TRUE if successful; FALSE otherwise.
|
|
*/
|
|
vfunc_get_row_column_span(): [ /* returnType */ boolean, /* row */ number, /* column */ number, /* row_span */ number, /* column_span */ number ]
|
|
/**
|
|
* Returns the row headers as an array of cell accessibles.
|
|
* @virtual
|
|
* @returns a GPtrArray of AtkObjects representing the row header cells.
|
|
*/
|
|
vfunc_get_row_header_cells(): Object[]
|
|
/**
|
|
* Returns the number of rows occupied by this cell accessible.
|
|
* @virtual
|
|
* @returns a gint representing the number of rows occupied by this cell, or 0 if the cell does not implement this method.
|
|
*/
|
|
vfunc_get_row_span(): number
|
|
/**
|
|
* Returns a reference to the accessible of the containing table.
|
|
* @virtual
|
|
* @returns the atk object for the containing table.
|
|
*/
|
|
vfunc_get_table(): Object
|
|
|
|
// Class property signals of Atk-1.0.Atk.TableCell
|
|
|
|
connect(sigName: "notify::accessible-component-layer", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-component-layer", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-component-layer", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-component-mdi-zorder", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-component-mdi-zorder", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-component-mdi-zorder", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-description", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-description", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-hypertext-nlinks", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-hypertext-nlinks", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-hypertext-nlinks", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-name", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-name", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-name", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-role", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-role", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-role", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-caption", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-caption", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-caption", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-caption-object", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-caption-object", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-caption-object", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-column-description", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-column-description", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-column-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-column-header", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-column-header", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-column-header", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-row-description", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-row-description", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-row-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-row-header", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-row-header", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-row-header", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-summary", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-summary", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-summary", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-value", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-value", callback: (($obj: TableCell, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-value", ...args: any[]): void
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The ATK interface implemented for a cell inside a two-dimentional #AtkTable
|
|
*
|
|
* Being #AtkTable a component which present elements ordered via rows
|
|
* and columns, an #AtkTableCell is the interface which each of those
|
|
* elements, so "cells" should implement.
|
|
*
|
|
* See [iface`AtkTable]`
|
|
* @interface
|
|
*/
|
|
export class TableCell extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.TableCell
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<TableCell>
|
|
|
|
// Constructors of Atk-1.0.Atk.TableCell
|
|
|
|
constructor(config?: TableCell.ConstructorProperties)
|
|
_init(config?: TableCell.ConstructorProperties): void
|
|
}
|
|
|
|
export module Text {
|
|
|
|
// Signal callback interfaces
|
|
|
|
/**
|
|
* Signal callback interface for `text-attributes-changed`
|
|
*/
|
|
export interface TextAttributesChangedSignalCallback {
|
|
($obj: Text): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `text-caret-moved`
|
|
*/
|
|
export interface TextCaretMovedSignalCallback {
|
|
($obj: Text, arg1: number): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `text-changed`
|
|
*/
|
|
export interface TextChangedSignalCallback {
|
|
($obj: Text, arg1: number, arg2: number): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `text-insert`
|
|
*/
|
|
export interface TextInsertSignalCallback {
|
|
($obj: Text, arg1: number, arg2: number, arg3: string | null): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `text-remove`
|
|
*/
|
|
export interface TextRemoveSignalCallback {
|
|
($obj: Text, arg1: number, arg2: number, arg3: string | null): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `text-selection-changed`
|
|
*/
|
|
export interface TextSelectionChangedSignalCallback {
|
|
($obj: Text): void
|
|
}
|
|
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface Text {
|
|
|
|
// Owm methods of Atk-1.0.Atk.Text
|
|
|
|
/**
|
|
* Adds a selection bounded by the specified offsets.
|
|
* @param start_offset the starting character offset of the selected region
|
|
* @param end_offset the offset of the first character after the selected region.
|
|
* @returns %TRUE if successful, %FALSE otherwise
|
|
*/
|
|
add_selection(start_offset: number, end_offset: number): boolean
|
|
/**
|
|
* Get the ranges of text in the specified bounding box.
|
|
* @param rect An AtkTextRectangle giving the dimensions of the bounding box.
|
|
* @param coord_type Specify whether coordinates are relative to the screen or widget window.
|
|
* @param x_clip_type Specify the horizontal clip type.
|
|
* @param y_clip_type Specify the vertical clip type.
|
|
* @returns Array of AtkTextRange. The last element of the array returned by this function will be NULL.
|
|
*/
|
|
get_bounded_ranges(rect: TextRectangle, coord_type: CoordType, x_clip_type: TextClipType, y_clip_type: TextClipType): TextRange[]
|
|
/**
|
|
* Gets the offset of the position of the caret (cursor).
|
|
* @returns the character offset of the position of the caret or -1 if the caret is not located inside the element or in the case of any other failure.
|
|
*/
|
|
get_caret_offset(): number
|
|
/**
|
|
* Gets the specified text.
|
|
* @param offset a character offset within `text`
|
|
* @returns the character at @offset or 0 in the case of failure.
|
|
*/
|
|
get_character_at_offset(offset: number): string
|
|
/**
|
|
* Gets the character count.
|
|
* @returns the number of characters or -1 in case of failure.
|
|
*/
|
|
get_character_count(): number
|
|
/**
|
|
* If the extent can not be obtained (e.g. missing support), all of x, y, width,
|
|
* height are set to -1.
|
|
*
|
|
* Get the bounding box containing the glyph representing the character at
|
|
* a particular text offset.
|
|
* @param offset The offset of the text character for which bounding information is required.
|
|
* @param coords specify whether coordinates are relative to the screen or widget window
|
|
*/
|
|
get_character_extents(offset: number, coords: CoordType): [ /* x */ number, /* y */ number, /* width */ number, /* height */ number ]
|
|
/**
|
|
* Creates an #AtkAttributeSet which consists of the default values of
|
|
* attributes for the text. See the enum AtkTextAttribute for types of text
|
|
* attributes that can be returned. Note that other attributes may also be
|
|
* returned.
|
|
* @returns an #AtkAttributeSet which contains the default text attributes for this #AtkText. This #AtkAttributeSet should be freed by a call to atk_attribute_set_free().
|
|
*/
|
|
get_default_attributes(): AttributeSet
|
|
/**
|
|
* Gets the number of selected regions.
|
|
* @returns The number of selected regions, or -1 in the case of failure.
|
|
*/
|
|
get_n_selections(): number
|
|
/**
|
|
* Gets the offset of the character located at coordinates `x` and `y`. `x` and `y`
|
|
* are interpreted as being relative to the screen or this widget's window
|
|
* depending on `coords`.
|
|
* @param x screen x-position of character
|
|
* @param y screen y-position of character
|
|
* @param coords specify whether coordinates are relative to the screen or widget window
|
|
* @returns the offset to the character which is located at the specified @x and @y coordinates of -1 in case of failure.
|
|
*/
|
|
get_offset_at_point(x: number, y: number, coords: CoordType): number
|
|
/**
|
|
* Get the bounding box for text within the specified range.
|
|
*
|
|
* If the extents can not be obtained (e.g. or missing support), the rectangle
|
|
* fields are set to -1.
|
|
* @param start_offset The offset of the first text character for which boundary information is required.
|
|
* @param end_offset The offset of the text character after the last character for which boundary information is required.
|
|
* @param coord_type Specify whether coordinates are relative to the screen or widget window.
|
|
*/
|
|
get_range_extents(start_offset: number, end_offset: number, coord_type: CoordType): /* rect */ TextRectangle
|
|
/**
|
|
* Creates an #AtkAttributeSet which consists of the attributes explicitly
|
|
* set at the position `offset` in the text. `start_offset` and `end_offset` are
|
|
* set to the start and end of the range around `offset` where the attributes are
|
|
* invariant. Note that `end_offset` is the offset of the first character
|
|
* after the range. See the enum AtkTextAttribute for types of text
|
|
* attributes that can be returned. Note that other attributes may also be
|
|
* returned.
|
|
* @param offset the character offset at which to get the attributes, -1 means the offset of the character to be inserted at the caret location.
|
|
* @returns an #AtkAttributeSet which contains the attributes explicitly set at @offset. This #AtkAttributeSet should be freed by a call to atk_attribute_set_free().
|
|
*/
|
|
get_run_attributes(offset: number): [ /* returnType */ AttributeSet, /* start_offset */ number, /* end_offset */ number ]
|
|
/**
|
|
* Gets the text from the specified selection.
|
|
* @param selection_num The selection number. The selected regions are assigned numbers that correspond to how far the region is from the start of the text. The selected region closest to the beginning of the text region is assigned the number 0, etc. Note that adding, moving or deleting a selected region can change the numbering.
|
|
* @returns a newly allocated string containing the selected text. Use g_free() to free the returned string.
|
|
*/
|
|
get_selection(selection_num: number): [ /* returnType */ string | null, /* start_offset */ number, /* end_offset */ number ]
|
|
/**
|
|
* Gets a portion of the text exposed through an #AtkText according to a given `offset`
|
|
* and a specific `granularity,` along with the start and end offsets defining the
|
|
* boundaries of such a portion of text.
|
|
*
|
|
* If `granularity` is ATK_TEXT_GRANULARITY_CHAR the character at the
|
|
* offset is returned.
|
|
*
|
|
* If `granularity` is ATK_TEXT_GRANULARITY_WORD the returned string
|
|
* is from the word start at or before the offset to the word start after
|
|
* the offset.
|
|
*
|
|
* The returned string will contain the word at the offset if the offset
|
|
* is inside a word and will contain the word before the offset if the
|
|
* offset is not inside a word.
|
|
*
|
|
* If `granularity` is ATK_TEXT_GRANULARITY_SENTENCE the returned string
|
|
* is from the sentence start at or before the offset to the sentence
|
|
* start after the offset.
|
|
*
|
|
* The returned string will contain the sentence at the offset if the offset
|
|
* is inside a sentence and will contain the sentence before the offset
|
|
* if the offset is not inside a sentence.
|
|
*
|
|
* If `granularity` is ATK_TEXT_GRANULARITY_LINE the returned string
|
|
* is from the line start at or before the offset to the line
|
|
* start after the offset.
|
|
*
|
|
* If `granularity` is ATK_TEXT_GRANULARITY_PARAGRAPH the returned string
|
|
* is from the start of the paragraph at or before the offset to the start
|
|
* of the following paragraph after the offset.
|
|
* @param offset position
|
|
* @param granularity An #AtkTextGranularity
|
|
* @returns a newly allocated string containing the text at the @offset bounded by the specified @granularity. Use g_free() to free the returned string. Returns %NULL if the offset is invalid or no implementation is available.
|
|
*/
|
|
get_string_at_offset(offset: number, granularity: TextGranularity): [ /* returnType */ string | null, /* start_offset */ number, /* end_offset */ number ]
|
|
/**
|
|
* Gets the specified text.
|
|
* @param start_offset a starting character offset within `text`
|
|
* @param end_offset an ending character offset within `text,` or -1 for the end of the string.
|
|
* @returns a newly allocated string containing the text from @start_offset up to, but not including @end_offset. Use g_free() to free the returned string.
|
|
*/
|
|
get_text(start_offset: number, end_offset: number): string | null
|
|
/**
|
|
* Gets the specified text.
|
|
* @param offset position
|
|
* @param boundary_type An #AtkTextBoundary
|
|
* @returns a newly allocated string containing the text after @offset bounded by the specified @boundary_type. Use g_free() to free the returned string.
|
|
*/
|
|
get_text_after_offset(offset: number, boundary_type: TextBoundary): [ /* returnType */ string | null, /* start_offset */ number, /* end_offset */ number ]
|
|
/**
|
|
* Gets the specified text.
|
|
*
|
|
* If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character at the
|
|
* offset is returned.
|
|
*
|
|
* If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string
|
|
* is from the word start at or before the offset to the word start after
|
|
* the offset.
|
|
*
|
|
* The returned string will contain the word at the offset if the offset
|
|
* is inside a word and will contain the word before the offset if the
|
|
* offset is not inside a word.
|
|
*
|
|
* If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned
|
|
* string is from the sentence start at or before the offset to the sentence
|
|
* start after the offset.
|
|
*
|
|
* The returned string will contain the sentence at the offset if the offset
|
|
* is inside a sentence and will contain the sentence before the offset
|
|
* if the offset is not inside a sentence.
|
|
*
|
|
* If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned
|
|
* string is from the line start at or before the offset to the line
|
|
* start after the offset.
|
|
* @param offset position
|
|
* @param boundary_type An #AtkTextBoundary
|
|
* @returns a newly allocated string containing the text at @offset bounded by the specified @boundary_type. Use g_free() to free the returned string.
|
|
*/
|
|
get_text_at_offset(offset: number, boundary_type: TextBoundary): [ /* returnType */ string | null, /* start_offset */ number, /* end_offset */ number ]
|
|
/**
|
|
* Gets the specified text.
|
|
* @param offset position
|
|
* @param boundary_type An #AtkTextBoundary
|
|
* @returns a newly allocated string containing the text before @offset bounded by the specified @boundary_type. Use g_free() to free the returned string.
|
|
*/
|
|
get_text_before_offset(offset: number, boundary_type: TextBoundary): [ /* returnType */ string | null, /* start_offset */ number, /* end_offset */ number ]
|
|
/**
|
|
* Removes the specified selection.
|
|
* @param selection_num The selection number. The selected regions are assigned numbers that correspond to how far the region is from the start of the text. The selected region closest to the beginning of the text region is assigned the number 0, etc. Note that adding, moving or deleting a selected region can change the numbering.
|
|
* @returns %TRUE if successful, %FALSE otherwise
|
|
*/
|
|
remove_selection(selection_num: number): boolean
|
|
/**
|
|
* Makes a substring of `text` visible on the screen by scrolling all necessary parents.
|
|
* @param start_offset start offset in the `text`
|
|
* @param end_offset end offset in the `text,` or -1 for the end of the text.
|
|
* @param type specify where the object should be made visible.
|
|
* @returns whether scrolling was successful.
|
|
*/
|
|
scroll_substring_to(start_offset: number, end_offset: number, type: ScrollType): boolean
|
|
/**
|
|
* Move the top-left of a substring of `text` to a given position of the screen
|
|
* by scrolling all necessary parents.
|
|
* @param start_offset start offset in the `text`
|
|
* @param end_offset end offset in the `text,` or -1 for the end of the text.
|
|
* @param coords specify whether coordinates are relative to the screen or to the parent object.
|
|
* @param x x-position where to scroll to
|
|
* @param y y-position where to scroll to
|
|
* @returns whether scrolling was successful.
|
|
*/
|
|
scroll_substring_to_point(start_offset: number, end_offset: number, coords: CoordType, x: number, y: number): boolean
|
|
/**
|
|
* Sets the caret (cursor) position to the specified `offset`.
|
|
*
|
|
* In the case of rich-text content, this method should either grab focus
|
|
* or move the sequential focus navigation starting point (if the application
|
|
* supports this concept) as if the user had clicked on the new caret position.
|
|
* Typically, this means that the target of this operation is the node containing
|
|
* the new caret position or one of its ancestors. In other words, after this
|
|
* method is called, if the user advances focus, it should move to the first
|
|
* focusable node following the new caret position.
|
|
*
|
|
* Calling this method should also scroll the application viewport in a way
|
|
* that matches the behavior of the application's typical caret motion or tab
|
|
* navigation as closely as possible. This also means that if the application's
|
|
* caret motion or focus navigation does not trigger a scroll operation, this
|
|
* method should not trigger one either. If the application does not have a caret
|
|
* motion or focus navigation operation, this method should try to scroll the new
|
|
* caret position into view while minimizing unnecessary scroll motion.
|
|
* @param offset the character offset of the new caret position
|
|
* @returns %TRUE if successful, %FALSE otherwise.
|
|
*/
|
|
set_caret_offset(offset: number): boolean
|
|
/**
|
|
* Changes the start and end offset of the specified selection.
|
|
* @param selection_num The selection number. The selected regions are assigned numbers that correspond to how far the region is from the start of the text. The selected region closest to the beginning of the text region is assigned the number 0, etc. Note that adding, moving or deleting a selected region can change the numbering.
|
|
* @param start_offset the new starting character offset of the selection
|
|
* @param end_offset the new end position of (e.g. offset immediately past) the selection
|
|
* @returns %TRUE if successful, %FALSE otherwise
|
|
*/
|
|
set_selection(selection_num: number, start_offset: number, end_offset: number): boolean
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.Text
|
|
|
|
/**
|
|
* Adds a selection bounded by the specified offsets.
|
|
* @virtual
|
|
* @param start_offset the starting character offset of the selected region
|
|
* @param end_offset the offset of the first character after the selected region.
|
|
* @returns %TRUE if successful, %FALSE otherwise
|
|
*/
|
|
vfunc_add_selection(start_offset: number, end_offset: number): boolean
|
|
/**
|
|
* Get the ranges of text in the specified bounding box.
|
|
* @virtual
|
|
* @param rect An AtkTextRectangle giving the dimensions of the bounding box.
|
|
* @param coord_type Specify whether coordinates are relative to the screen or widget window.
|
|
* @param x_clip_type Specify the horizontal clip type.
|
|
* @param y_clip_type Specify the vertical clip type.
|
|
* @returns Array of AtkTextRange. The last element of the array returned by this function will be NULL.
|
|
*/
|
|
vfunc_get_bounded_ranges(rect: TextRectangle, coord_type: CoordType, x_clip_type: TextClipType, y_clip_type: TextClipType): TextRange[]
|
|
/**
|
|
* Gets the offset of the position of the caret (cursor).
|
|
* @virtual
|
|
* @returns the character offset of the position of the caret or -1 if the caret is not located inside the element or in the case of any other failure.
|
|
*/
|
|
vfunc_get_caret_offset(): number
|
|
/**
|
|
* Gets the specified text.
|
|
* @virtual
|
|
* @param offset a character offset within `text`
|
|
* @returns the character at @offset or 0 in the case of failure.
|
|
*/
|
|
vfunc_get_character_at_offset(offset: number): string
|
|
/**
|
|
* Gets the character count.
|
|
* @virtual
|
|
* @returns the number of characters or -1 in case of failure.
|
|
*/
|
|
vfunc_get_character_count(): number
|
|
/**
|
|
* If the extent can not be obtained (e.g. missing support), all of x, y, width,
|
|
* height are set to -1.
|
|
*
|
|
* Get the bounding box containing the glyph representing the character at
|
|
* a particular text offset.
|
|
* @virtual
|
|
* @param offset The offset of the text character for which bounding information is required.
|
|
* @param coords specify whether coordinates are relative to the screen or widget window
|
|
*/
|
|
vfunc_get_character_extents(offset: number, coords: CoordType): [ /* x */ number, /* y */ number, /* width */ number, /* height */ number ]
|
|
/**
|
|
* Creates an #AtkAttributeSet which consists of the default values of
|
|
* attributes for the text. See the enum AtkTextAttribute for types of text
|
|
* attributes that can be returned. Note that other attributes may also be
|
|
* returned.
|
|
* @virtual
|
|
* @returns an #AtkAttributeSet which contains the default text attributes for this #AtkText. This #AtkAttributeSet should be freed by a call to atk_attribute_set_free().
|
|
*/
|
|
vfunc_get_default_attributes(): AttributeSet
|
|
/**
|
|
* Gets the number of selected regions.
|
|
* @virtual
|
|
* @returns The number of selected regions, or -1 in the case of failure.
|
|
*/
|
|
vfunc_get_n_selections(): number
|
|
/**
|
|
* Gets the offset of the character located at coordinates `x` and `y`. `x` and `y`
|
|
* are interpreted as being relative to the screen or this widget's window
|
|
* depending on `coords`.
|
|
* @virtual
|
|
* @param x screen x-position of character
|
|
* @param y screen y-position of character
|
|
* @param coords specify whether coordinates are relative to the screen or widget window
|
|
* @returns the offset to the character which is located at the specified @x and @y coordinates of -1 in case of failure.
|
|
*/
|
|
vfunc_get_offset_at_point(x: number, y: number, coords: CoordType): number
|
|
/**
|
|
* Get the bounding box for text within the specified range.
|
|
*
|
|
* If the extents can not be obtained (e.g. or missing support), the rectangle
|
|
* fields are set to -1.
|
|
* @virtual
|
|
* @param start_offset The offset of the first text character for which boundary information is required.
|
|
* @param end_offset The offset of the text character after the last character for which boundary information is required.
|
|
* @param coord_type Specify whether coordinates are relative to the screen or widget window.
|
|
*/
|
|
vfunc_get_range_extents(start_offset: number, end_offset: number, coord_type: CoordType): /* rect */ TextRectangle
|
|
/**
|
|
* Creates an #AtkAttributeSet which consists of the attributes explicitly
|
|
* set at the position `offset` in the text. `start_offset` and `end_offset` are
|
|
* set to the start and end of the range around `offset` where the attributes are
|
|
* invariant. Note that `end_offset` is the offset of the first character
|
|
* after the range. See the enum AtkTextAttribute for types of text
|
|
* attributes that can be returned. Note that other attributes may also be
|
|
* returned.
|
|
* @virtual
|
|
* @param offset the character offset at which to get the attributes, -1 means the offset of the character to be inserted at the caret location.
|
|
* @returns an #AtkAttributeSet which contains the attributes explicitly set at @offset. This #AtkAttributeSet should be freed by a call to atk_attribute_set_free().
|
|
*/
|
|
vfunc_get_run_attributes(offset: number): [ /* returnType */ AttributeSet, /* start_offset */ number, /* end_offset */ number ]
|
|
/**
|
|
* Gets the text from the specified selection.
|
|
* @virtual
|
|
* @param selection_num The selection number. The selected regions are assigned numbers that correspond to how far the region is from the start of the text. The selected region closest to the beginning of the text region is assigned the number 0, etc. Note that adding, moving or deleting a selected region can change the numbering.
|
|
* @returns a newly allocated string containing the selected text. Use g_free() to free the returned string.
|
|
*/
|
|
vfunc_get_selection(selection_num: number): [ /* returnType */ string | null, /* start_offset */ number, /* end_offset */ number ]
|
|
/**
|
|
* Gets a portion of the text exposed through an #AtkText according to a given `offset`
|
|
* and a specific `granularity,` along with the start and end offsets defining the
|
|
* boundaries of such a portion of text.
|
|
*
|
|
* If `granularity` is ATK_TEXT_GRANULARITY_CHAR the character at the
|
|
* offset is returned.
|
|
*
|
|
* If `granularity` is ATK_TEXT_GRANULARITY_WORD the returned string
|
|
* is from the word start at or before the offset to the word start after
|
|
* the offset.
|
|
*
|
|
* The returned string will contain the word at the offset if the offset
|
|
* is inside a word and will contain the word before the offset if the
|
|
* offset is not inside a word.
|
|
*
|
|
* If `granularity` is ATK_TEXT_GRANULARITY_SENTENCE the returned string
|
|
* is from the sentence start at or before the offset to the sentence
|
|
* start after the offset.
|
|
*
|
|
* The returned string will contain the sentence at the offset if the offset
|
|
* is inside a sentence and will contain the sentence before the offset
|
|
* if the offset is not inside a sentence.
|
|
*
|
|
* If `granularity` is ATK_TEXT_GRANULARITY_LINE the returned string
|
|
* is from the line start at or before the offset to the line
|
|
* start after the offset.
|
|
*
|
|
* If `granularity` is ATK_TEXT_GRANULARITY_PARAGRAPH the returned string
|
|
* is from the start of the paragraph at or before the offset to the start
|
|
* of the following paragraph after the offset.
|
|
* @virtual
|
|
* @param offset position
|
|
* @param granularity An #AtkTextGranularity
|
|
* @returns a newly allocated string containing the text at the @offset bounded by the specified @granularity. Use g_free() to free the returned string. Returns %NULL if the offset is invalid or no implementation is available.
|
|
*/
|
|
vfunc_get_string_at_offset(offset: number, granularity: TextGranularity): [ /* returnType */ string | null, /* start_offset */ number, /* end_offset */ number ]
|
|
/**
|
|
* Gets the specified text.
|
|
* @virtual
|
|
* @param start_offset a starting character offset within `text`
|
|
* @param end_offset an ending character offset within `text,` or -1 for the end of the string.
|
|
* @returns a newly allocated string containing the text from @start_offset up to, but not including @end_offset. Use g_free() to free the returned string.
|
|
*/
|
|
vfunc_get_text(start_offset: number, end_offset: number): string | null
|
|
/**
|
|
* Gets the specified text.
|
|
* @virtual
|
|
* @param offset position
|
|
* @param boundary_type An #AtkTextBoundary
|
|
* @returns a newly allocated string containing the text after @offset bounded by the specified @boundary_type. Use g_free() to free the returned string.
|
|
*/
|
|
vfunc_get_text_after_offset(offset: number, boundary_type: TextBoundary): [ /* returnType */ string | null, /* start_offset */ number, /* end_offset */ number ]
|
|
/**
|
|
* Gets the specified text.
|
|
*
|
|
* If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character at the
|
|
* offset is returned.
|
|
*
|
|
* If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string
|
|
* is from the word start at or before the offset to the word start after
|
|
* the offset.
|
|
*
|
|
* The returned string will contain the word at the offset if the offset
|
|
* is inside a word and will contain the word before the offset if the
|
|
* offset is not inside a word.
|
|
*
|
|
* If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned
|
|
* string is from the sentence start at or before the offset to the sentence
|
|
* start after the offset.
|
|
*
|
|
* The returned string will contain the sentence at the offset if the offset
|
|
* is inside a sentence and will contain the sentence before the offset
|
|
* if the offset is not inside a sentence.
|
|
*
|
|
* If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned
|
|
* string is from the line start at or before the offset to the line
|
|
* start after the offset.
|
|
* @virtual
|
|
* @param offset position
|
|
* @param boundary_type An #AtkTextBoundary
|
|
* @returns a newly allocated string containing the text at @offset bounded by the specified @boundary_type. Use g_free() to free the returned string.
|
|
*/
|
|
vfunc_get_text_at_offset(offset: number, boundary_type: TextBoundary): [ /* returnType */ string | null, /* start_offset */ number, /* end_offset */ number ]
|
|
/**
|
|
* Gets the specified text.
|
|
* @virtual
|
|
* @param offset position
|
|
* @param boundary_type An #AtkTextBoundary
|
|
* @returns a newly allocated string containing the text before @offset bounded by the specified @boundary_type. Use g_free() to free the returned string.
|
|
*/
|
|
vfunc_get_text_before_offset(offset: number, boundary_type: TextBoundary): [ /* returnType */ string | null, /* start_offset */ number, /* end_offset */ number ]
|
|
/**
|
|
* Removes the specified selection.
|
|
* @virtual
|
|
* @param selection_num The selection number. The selected regions are assigned numbers that correspond to how far the region is from the start of the text. The selected region closest to the beginning of the text region is assigned the number 0, etc. Note that adding, moving or deleting a selected region can change the numbering.
|
|
* @returns %TRUE if successful, %FALSE otherwise
|
|
*/
|
|
vfunc_remove_selection(selection_num: number): boolean
|
|
/**
|
|
* Makes a substring of `text` visible on the screen by scrolling all necessary parents.
|
|
* @virtual
|
|
* @param start_offset start offset in the `text`
|
|
* @param end_offset end offset in the `text,` or -1 for the end of the text.
|
|
* @param type specify where the object should be made visible.
|
|
* @returns whether scrolling was successful.
|
|
*/
|
|
vfunc_scroll_substring_to(start_offset: number, end_offset: number, type: ScrollType): boolean
|
|
/**
|
|
* Move the top-left of a substring of `text` to a given position of the screen
|
|
* by scrolling all necessary parents.
|
|
* @virtual
|
|
* @param start_offset start offset in the `text`
|
|
* @param end_offset end offset in the `text,` or -1 for the end of the text.
|
|
* @param coords specify whether coordinates are relative to the screen or to the parent object.
|
|
* @param x x-position where to scroll to
|
|
* @param y y-position where to scroll to
|
|
* @returns whether scrolling was successful.
|
|
*/
|
|
vfunc_scroll_substring_to_point(start_offset: number, end_offset: number, coords: CoordType, x: number, y: number): boolean
|
|
/**
|
|
* Sets the caret (cursor) position to the specified `offset`.
|
|
*
|
|
* In the case of rich-text content, this method should either grab focus
|
|
* or move the sequential focus navigation starting point (if the application
|
|
* supports this concept) as if the user had clicked on the new caret position.
|
|
* Typically, this means that the target of this operation is the node containing
|
|
* the new caret position or one of its ancestors. In other words, after this
|
|
* method is called, if the user advances focus, it should move to the first
|
|
* focusable node following the new caret position.
|
|
*
|
|
* Calling this method should also scroll the application viewport in a way
|
|
* that matches the behavior of the application's typical caret motion or tab
|
|
* navigation as closely as possible. This also means that if the application's
|
|
* caret motion or focus navigation does not trigger a scroll operation, this
|
|
* method should not trigger one either. If the application does not have a caret
|
|
* motion or focus navigation operation, this method should try to scroll the new
|
|
* caret position into view while minimizing unnecessary scroll motion.
|
|
* @virtual
|
|
* @param offset the character offset of the new caret position
|
|
* @returns %TRUE if successful, %FALSE otherwise.
|
|
*/
|
|
vfunc_set_caret_offset(offset: number): boolean
|
|
/**
|
|
* Changes the start and end offset of the specified selection.
|
|
* @virtual
|
|
* @param selection_num The selection number. The selected regions are assigned numbers that correspond to how far the region is from the start of the text. The selected region closest to the beginning of the text region is assigned the number 0, etc. Note that adding, moving or deleting a selected region can change the numbering.
|
|
* @param start_offset the new starting character offset of the selection
|
|
* @param end_offset the new end position of (e.g. offset immediately past) the selection
|
|
* @returns %TRUE if successful, %FALSE otherwise
|
|
*/
|
|
vfunc_set_selection(selection_num: number, start_offset: number, end_offset: number): boolean
|
|
vfunc_text_attributes_changed(): void
|
|
vfunc_text_caret_moved(location: number): void
|
|
vfunc_text_changed(position: number, length: number): void
|
|
vfunc_text_selection_changed(): void
|
|
|
|
// Own signals of Atk-1.0.Atk.Text
|
|
|
|
connect(sigName: "text-attributes-changed", callback: Text.TextAttributesChangedSignalCallback): number
|
|
connect_after(sigName: "text-attributes-changed", callback: Text.TextAttributesChangedSignalCallback): number
|
|
emit(sigName: "text-attributes-changed", ...args: any[]): void
|
|
connect(sigName: "text-caret-moved", callback: Text.TextCaretMovedSignalCallback): number
|
|
connect_after(sigName: "text-caret-moved", callback: Text.TextCaretMovedSignalCallback): number
|
|
emit(sigName: "text-caret-moved", arg1: number, ...args: any[]): void
|
|
connect(sigName: "text-changed", callback: Text.TextChangedSignalCallback): number
|
|
connect_after(sigName: "text-changed", callback: Text.TextChangedSignalCallback): number
|
|
emit(sigName: "text-changed", arg1: number, arg2: number, ...args: any[]): void
|
|
connect(sigName: "text-insert", callback: Text.TextInsertSignalCallback): number
|
|
connect_after(sigName: "text-insert", callback: Text.TextInsertSignalCallback): number
|
|
emit(sigName: "text-insert", arg1: number, arg2: number, arg3: string | null, ...args: any[]): void
|
|
connect(sigName: "text-remove", callback: Text.TextRemoveSignalCallback): number
|
|
connect_after(sigName: "text-remove", callback: Text.TextRemoveSignalCallback): number
|
|
emit(sigName: "text-remove", arg1: number, arg2: number, arg3: string | null, ...args: any[]): void
|
|
connect(sigName: "text-selection-changed", callback: Text.TextSelectionChangedSignalCallback): number
|
|
connect_after(sigName: "text-selection-changed", callback: Text.TextSelectionChangedSignalCallback): number
|
|
emit(sigName: "text-selection-changed", ...args: any[]): void
|
|
|
|
// Class property signals of Atk-1.0.Atk.Text
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The ATK interface implemented by components with text content.
|
|
*
|
|
* #AtkText should be implemented by #AtkObjects on behalf of widgets
|
|
* that have text content which is either attributed or otherwise
|
|
* non-trivial. #AtkObjects whose text content is simple,
|
|
* unattributed, and very brief may expose that content via
|
|
* #atk_object_get_name instead; however if the text is editable,
|
|
* multi-line, typically longer than three or four words, attributed,
|
|
* selectable, or if the object already uses the 'name' ATK property
|
|
* for other information, the #AtkText interface should be used to
|
|
* expose the text content. In the case of editable text content,
|
|
* #AtkEditableText (a subtype of the #AtkText interface) should be
|
|
* implemented instead.
|
|
*
|
|
* #AtkText provides not only traversal facilities and change
|
|
* notification for text content, but also caret tracking and glyph
|
|
* bounding box calculations. Note that the text strings are exposed
|
|
* as UTF-8, and are therefore potentially multi-byte, and
|
|
* caret-to-byte offset mapping makes no assumptions about the
|
|
* character length; also bounding box glyph-to-offset mapping may be
|
|
* complex for languages which use ligatures.
|
|
* @interface
|
|
*/
|
|
export class Text extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Text
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Text>
|
|
|
|
// Constructors of Atk-1.0.Atk.Text
|
|
|
|
constructor(config?: Text.ConstructorProperties)
|
|
_init(config?: Text.ConstructorProperties): void
|
|
/**
|
|
* Frees the memory associated with an array of AtkTextRange. It is assumed
|
|
* that the array was returned by the function atk_text_get_bounded_ranges
|
|
* and is NULL terminated.
|
|
* @param ranges A pointer to an array of #AtkTextRange which is to be freed.
|
|
*/
|
|
static free_ranges(ranges: TextRange[]): void
|
|
}
|
|
|
|
export module Value {
|
|
|
|
// Signal callback interfaces
|
|
|
|
/**
|
|
* Signal callback interface for `value-changed`
|
|
*/
|
|
export interface ValueChangedSignalCallback {
|
|
($obj: Value, value: number, text: string | null): void
|
|
}
|
|
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface Value {
|
|
|
|
// Owm methods of Atk-1.0.Atk.Value
|
|
|
|
/**
|
|
* Gets the value of this object.
|
|
*/
|
|
get_current_value(): /* value */ any
|
|
/**
|
|
* 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 the floating point precision of the
|
|
* platform.
|
|
* @returns the minimum increment by which the value of this object may be changed. zero if undefined.
|
|
*/
|
|
get_increment(): number
|
|
/**
|
|
* Gets the maximum value of this object.
|
|
*/
|
|
get_maximum_value(): /* value */ any
|
|
/**
|
|
* 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 the
|
|
* floating point precision of the platform.
|
|
*/
|
|
get_minimum_increment(): /* value */ any
|
|
/**
|
|
* Gets the minimum value of this object.
|
|
*/
|
|
get_minimum_value(): /* value */ any
|
|
/**
|
|
* Gets the range of this object.
|
|
* @returns a newly allocated #AtkRange that represents the minimum, maximum and descriptor (if available) of @obj. NULL if that range is not defined.
|
|
*/
|
|
get_range(): Range | null
|
|
/**
|
|
* Gets the list of subranges defined for this object. See #AtkValue
|
|
* introduction for examples of subranges and when to expose them.
|
|
* @returns an #GSList of #AtkRange which each of the subranges defined for this object. Free the returns list with g_slist_free().
|
|
*/
|
|
get_sub_ranges(): Range[]
|
|
/**
|
|
* Gets the current value and the human readable text alternative of
|
|
* `obj`. `text` is a newly created string, that must be freed by the
|
|
* caller. Can be NULL if no descriptor is available.
|
|
*/
|
|
get_value_and_text(): [ /* value */ number, /* text */ string | null ]
|
|
/**
|
|
* Sets the value of this object.
|
|
* @param value a #GValue which is the desired new accessible value.
|
|
* @returns %TRUE if new value is successfully set, %FALSE otherwise.
|
|
*/
|
|
set_current_value(value: any): boolean
|
|
/**
|
|
* Sets the value of this object.
|
|
*
|
|
* This method is intended to provide a way to change the value of the
|
|
* object. In any case, it is possible that the value can't be
|
|
* modified (ie: a read-only component). If the value changes due this
|
|
* call, it is possible that the text could change, and will trigger
|
|
* an #AtkValue::value-changed signal emission.
|
|
*
|
|
* Note for implementors: the deprecated atk_value_set_current_value()
|
|
* method returned TRUE or FALSE depending if the value was assigned
|
|
* or not. In the practice several implementors were not able to
|
|
* decide it, and returned TRUE in any case. For that reason it is not
|
|
* required anymore to return if the value was properly assigned or
|
|
* not.
|
|
* @param new_value a double which is the desired new accessible value.
|
|
*/
|
|
set_value(new_value: number): void
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.Value
|
|
|
|
/**
|
|
* Gets the value of this object.
|
|
* @virtual
|
|
*/
|
|
vfunc_get_current_value(): /* value */ any
|
|
/**
|
|
* 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 the floating point precision of the
|
|
* platform.
|
|
* @virtual
|
|
* @returns the minimum increment by which the value of this object may be changed. zero if undefined.
|
|
*/
|
|
vfunc_get_increment(): number
|
|
/**
|
|
* Gets the maximum value of this object.
|
|
* @virtual
|
|
*/
|
|
vfunc_get_maximum_value(): /* value */ any
|
|
/**
|
|
* 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 the
|
|
* floating point precision of the platform.
|
|
* @virtual
|
|
*/
|
|
vfunc_get_minimum_increment(): /* value */ any
|
|
/**
|
|
* Gets the minimum value of this object.
|
|
* @virtual
|
|
*/
|
|
vfunc_get_minimum_value(): /* value */ any
|
|
/**
|
|
* Gets the range of this object.
|
|
* @virtual
|
|
* @returns a newly allocated #AtkRange that represents the minimum, maximum and descriptor (if available) of @obj. NULL if that range is not defined.
|
|
*/
|
|
vfunc_get_range(): Range | null
|
|
/**
|
|
* Gets the list of subranges defined for this object. See #AtkValue
|
|
* introduction for examples of subranges and when to expose them.
|
|
* @virtual
|
|
* @returns an #GSList of #AtkRange which each of the subranges defined for this object. Free the returns list with g_slist_free().
|
|
*/
|
|
vfunc_get_sub_ranges(): Range[]
|
|
/**
|
|
* Gets the current value and the human readable text alternative of
|
|
* `obj`. `text` is a newly created string, that must be freed by the
|
|
* caller. Can be NULL if no descriptor is available.
|
|
* @virtual
|
|
*/
|
|
vfunc_get_value_and_text(): [ /* value */ number, /* text */ string | null ]
|
|
/**
|
|
* Sets the value of this object.
|
|
* @virtual
|
|
* @param value a #GValue which is the desired new accessible value.
|
|
* @returns %TRUE if new value is successfully set, %FALSE otherwise.
|
|
*/
|
|
vfunc_set_current_value(value: any): boolean
|
|
/**
|
|
* Sets the value of this object.
|
|
*
|
|
* This method is intended to provide a way to change the value of the
|
|
* object. In any case, it is possible that the value can't be
|
|
* modified (ie: a read-only component). If the value changes due this
|
|
* call, it is possible that the text could change, and will trigger
|
|
* an #AtkValue::value-changed signal emission.
|
|
*
|
|
* Note for implementors: the deprecated atk_value_set_current_value()
|
|
* method returned TRUE or FALSE depending if the value was assigned
|
|
* or not. In the practice several implementors were not able to
|
|
* decide it, and returned TRUE in any case. For that reason it is not
|
|
* required anymore to return if the value was properly assigned or
|
|
* not.
|
|
* @virtual
|
|
* @param new_value a double which is the desired new accessible value.
|
|
*/
|
|
vfunc_set_value(new_value: number): void
|
|
|
|
// Own signals of Atk-1.0.Atk.Value
|
|
|
|
connect(sigName: "value-changed", callback: Value.ValueChangedSignalCallback): number
|
|
connect_after(sigName: "value-changed", callback: Value.ValueChangedSignalCallback): number
|
|
emit(sigName: "value-changed", value: number, text: string | null, ...args: any[]): void
|
|
|
|
// Class property signals of Atk-1.0.Atk.Value
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The ATK interface implemented by valuators and components which display or select a value from a bounded range of values.
|
|
*
|
|
* #AtkValue should be implemented for components which either display
|
|
* a value from a bounded range, or which allow the user to specify a
|
|
* value from a bounded range, or both. For instance, most sliders and
|
|
* range controls, as well as dials, should have #AtkObject
|
|
* representations which implement #AtkValue on the component's
|
|
* behalf. #AtKValues may be read-only, in which case attempts to
|
|
* alter the value return would fail.
|
|
*
|
|
* <refsect1 id="current-value-text">
|
|
* <title>On the subject of current value text</title>
|
|
* <para>
|
|
* In addition to providing the current value, implementors can
|
|
* optionally provide an end-user-consumable textual description
|
|
* associated with this value. This description should be included
|
|
* when the numeric value fails to convey the full, on-screen
|
|
* representation seen by users.
|
|
* </para>
|
|
*
|
|
* <example>
|
|
* <title>Password strength</title>
|
|
* A password strength meter whose value changes as the user types
|
|
* their new password. Red is used for values less than 4.0, yellow
|
|
* for values between 4.0 and 7.0, and green for values greater than
|
|
* 7.0. In this instance, value text should be provided by the
|
|
* implementor. Appropriate value text would be "weak", "acceptable,"
|
|
* and "strong" respectively.
|
|
* </example>
|
|
*
|
|
* A level bar whose value changes to reflect the battery charge. The
|
|
* color remains the same regardless of the charge and there is no
|
|
* on-screen text reflecting the fullness of the battery. In this
|
|
* case, because the position within the bar is the only indication
|
|
* the user has of the current charge, value text should not be
|
|
* provided by the implementor.
|
|
*
|
|
* <refsect2 id="implementor-notes">
|
|
* <title>Implementor Notes</title>
|
|
* <para>
|
|
* Implementors should bear in mind that assistive technologies will
|
|
* likely prefer the value text provided over the numeric value when
|
|
* presenting a widget's value. As a result, strings not intended for
|
|
* end users should not be exposed in the value text, and strings
|
|
* which are exposed should be localized. In the case of widgets which
|
|
* display value text on screen, for instance through a separate label
|
|
* in close proximity to the value-displaying widget, it is still
|
|
* expected that implementors will expose the value text using the
|
|
* above API.
|
|
* </para>
|
|
*
|
|
* <para>
|
|
* #AtkValue should NOT be implemented for widgets whose displayed
|
|
* value is not reflective of a meaningful amount. For instance, a
|
|
* progress pulse indicator whose value alternates between 0.0 and 1.0
|
|
* to indicate that some process is still taking place should not
|
|
* implement #AtkValue because the current value does not reflect
|
|
* progress towards completion.
|
|
* </para>
|
|
* </refsect2>
|
|
* </refsect1>
|
|
*
|
|
* <refsect1 id="ranges">
|
|
* <title>On the subject of ranges</title>
|
|
* <para>
|
|
* In addition to providing the minimum and maximum values,
|
|
* implementors can optionally provide details about subranges
|
|
* associated with the widget. These details should be provided by the
|
|
* implementor when both of the following are communicated visually to
|
|
* the end user:
|
|
* </para>
|
|
* <itemizedlist>
|
|
* <listitem>The existence of distinct ranges such as "weak",
|
|
* "acceptable", and "strong" indicated by color, bar tick marks,
|
|
* and/or on-screen text.</listitem>
|
|
* <listitem>Where the current value stands within a given subrange,
|
|
* for instance illustrating progression from very "weak" towards
|
|
* nearly "acceptable" through changes in shade and/or position on
|
|
* the bar within the "weak" subrange.</listitem>
|
|
* </itemizedlist>
|
|
* <para>
|
|
* If both of the above do not apply to the widget, it should be
|
|
* sufficient to expose the numeric value, along with the value text
|
|
* if appropriate, to make the widget accessible.
|
|
* </para>
|
|
*
|
|
* <refsect2 id="ranges-implementor-notes">
|
|
* <title>Implementor Notes</title>
|
|
* <para>
|
|
* If providing subrange details is deemed necessary, all possible
|
|
* values of the widget are expected to fall within one of the
|
|
* subranges defined by the implementor.
|
|
* </para>
|
|
* </refsect2>
|
|
* </refsect1>
|
|
*
|
|
* <refsect1 id="localization">
|
|
* <title>On the subject of localization of end-user-consumable text
|
|
* values</title>
|
|
* <para>
|
|
* Because value text and subrange descriptors are human-consumable,
|
|
* implementors are expected to provide localized strings which can be
|
|
* directly presented to end users via their assistive technology. In
|
|
* order to simplify this for implementors, implementors can use
|
|
* atk_value_type_get_localized_name() with the following
|
|
* already-localized constants for commonly-needed values can be used:
|
|
* </para>
|
|
*
|
|
* <itemizedlist>
|
|
* <listitem>ATK_VALUE_VERY_WEAK</listitem>
|
|
* <listitem>ATK_VALUE_WEAK</listitem>
|
|
* <listitem>ATK_VALUE_ACCEPTABLE</listitem>
|
|
* <listitem>ATK_VALUE_STRONG</listitem>
|
|
* <listitem>ATK_VALUE_VERY_STRONG</listitem>
|
|
* <listitem>ATK_VALUE_VERY_LOW</listitem>
|
|
* <listitem>ATK_VALUE_LOW</listitem>
|
|
* <listitem>ATK_VALUE_MEDIUM</listitem>
|
|
* <listitem>ATK_VALUE_HIGH</listitem>
|
|
* <listitem>ATK_VALUE_VERY_HIGH</listitem>
|
|
* <listitem>ATK_VALUE_VERY_BAD</listitem>
|
|
* <listitem>ATK_VALUE_BAD</listitem>
|
|
* <listitem>ATK_VALUE_GOOD</listitem>
|
|
* <listitem>ATK_VALUE_VERY_GOOD</listitem>
|
|
* <listitem>ATK_VALUE_BEST</listitem>
|
|
* <listitem>ATK_VALUE_SUBSUBOPTIMAL</listitem>
|
|
* <listitem>ATK_VALUE_SUBOPTIMAL</listitem>
|
|
* <listitem>ATK_VALUE_OPTIMAL</listitem>
|
|
* </itemizedlist>
|
|
* <para>
|
|
* Proposals for additional constants, along with their use cases,
|
|
* should be submitted to the GNOME Accessibility Team.
|
|
* </para>
|
|
* </refsect1>
|
|
*
|
|
* <refsect1 id="changes">
|
|
* <title>On the subject of changes</title>
|
|
* <para>
|
|
* Note that if there is a textual description associated with the new
|
|
* numeric value, that description should be included regardless of
|
|
* whether or not it has also changed.
|
|
* </para>
|
|
* </refsect1>
|
|
* @interface
|
|
*/
|
|
export class Value extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Value
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Value>
|
|
|
|
// Constructors of Atk-1.0.Atk.Value
|
|
|
|
constructor(config?: Value.ConstructorProperties)
|
|
_init(config?: Value.ConstructorProperties): void
|
|
}
|
|
|
|
export module Window {
|
|
|
|
// Signal callback interfaces
|
|
|
|
/**
|
|
* Signal callback interface for `activate`
|
|
*/
|
|
export interface ActivateSignalCallback {
|
|
($obj: Window): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `create`
|
|
*/
|
|
export interface CreateSignalCallback {
|
|
($obj: Window): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `deactivate`
|
|
*/
|
|
export interface DeactivateSignalCallback {
|
|
($obj: Window): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `destroy`
|
|
*/
|
|
export interface DestroySignalCallback {
|
|
($obj: Window): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `maximize`
|
|
*/
|
|
export interface MaximizeSignalCallback {
|
|
($obj: Window): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `minimize`
|
|
*/
|
|
export interface MinimizeSignalCallback {
|
|
($obj: Window): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `move`
|
|
*/
|
|
export interface MoveSignalCallback {
|
|
($obj: Window): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `resize`
|
|
*/
|
|
export interface ResizeSignalCallback {
|
|
($obj: Window): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `restore`
|
|
*/
|
|
export interface RestoreSignalCallback {
|
|
($obj: Window): void
|
|
}
|
|
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends Object.ConstructorProperties, GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface Window extends Object {
|
|
|
|
// Own signals of Atk-1.0.Atk.Window
|
|
|
|
connect(sigName: "activate", callback: Window.ActivateSignalCallback): number
|
|
connect_after(sigName: "activate", callback: Window.ActivateSignalCallback): number
|
|
emit(sigName: "activate", ...args: any[]): void
|
|
connect(sigName: "create", callback: Window.CreateSignalCallback): number
|
|
connect_after(sigName: "create", callback: Window.CreateSignalCallback): number
|
|
emit(sigName: "create", ...args: any[]): void
|
|
connect(sigName: "deactivate", callback: Window.DeactivateSignalCallback): number
|
|
connect_after(sigName: "deactivate", callback: Window.DeactivateSignalCallback): number
|
|
emit(sigName: "deactivate", ...args: any[]): void
|
|
connect(sigName: "destroy", callback: Window.DestroySignalCallback): number
|
|
connect_after(sigName: "destroy", callback: Window.DestroySignalCallback): number
|
|
emit(sigName: "destroy", ...args: any[]): void
|
|
connect(sigName: "maximize", callback: Window.MaximizeSignalCallback): number
|
|
connect_after(sigName: "maximize", callback: Window.MaximizeSignalCallback): number
|
|
emit(sigName: "maximize", ...args: any[]): void
|
|
connect(sigName: "minimize", callback: Window.MinimizeSignalCallback): number
|
|
connect_after(sigName: "minimize", callback: Window.MinimizeSignalCallback): number
|
|
emit(sigName: "minimize", ...args: any[]): void
|
|
connect(sigName: "move", callback: Window.MoveSignalCallback): number
|
|
connect_after(sigName: "move", callback: Window.MoveSignalCallback): number
|
|
emit(sigName: "move", ...args: any[]): void
|
|
connect(sigName: "resize", callback: Window.ResizeSignalCallback): number
|
|
connect_after(sigName: "resize", callback: Window.ResizeSignalCallback): number
|
|
emit(sigName: "resize", ...args: any[]): void
|
|
connect(sigName: "restore", callback: Window.RestoreSignalCallback): number
|
|
connect_after(sigName: "restore", callback: Window.RestoreSignalCallback): number
|
|
emit(sigName: "restore", ...args: any[]): void
|
|
|
|
// Class property signals of Atk-1.0.Atk.Window
|
|
|
|
connect(sigName: "notify::accessible-component-layer", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-component-layer", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-component-layer", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-component-mdi-zorder", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-component-mdi-zorder", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-component-mdi-zorder", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-description", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-description", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-hypertext-nlinks", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-hypertext-nlinks", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-hypertext-nlinks", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-name", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-name", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-name", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-role", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-role", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-role", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-caption", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-caption", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-caption", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-caption-object", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-caption-object", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-caption-object", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-column-description", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-column-description", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-column-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-column-header", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-column-header", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-column-header", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-row-description", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-row-description", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-row-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-row-header", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-row-header", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-row-header", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-summary", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-summary", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-summary", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-value", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-value", callback: (($obj: Window, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-value", ...args: any[]): void
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The ATK Interface provided by UI components that represent a top-level window.
|
|
*
|
|
* #AtkWindow should be implemented by the UI elements that represent
|
|
* a top-level window, such as the main window of an application or
|
|
* dialog.
|
|
*
|
|
* See [class`AtkObject]`
|
|
* @interface
|
|
*/
|
|
export class Window extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Window
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Window>
|
|
|
|
// Constructors of Atk-1.0.Atk.Window
|
|
|
|
constructor(config?: Window.ConstructorProperties)
|
|
_init(config?: Window.ConstructorProperties): void
|
|
}
|
|
|
|
export module GObjectAccessible {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface GObjectAccessible {
|
|
|
|
// Own fields of Atk-1.0.Atk.GObjectAccessible
|
|
|
|
parent: Object & GObject.Object
|
|
|
|
// Owm methods of Atk-1.0.Atk.GObjectAccessible
|
|
|
|
/**
|
|
* Gets the GObject for which `obj` is the accessible object.
|
|
* @returns a #GObject which is the object for which @obj is the accessible object
|
|
*/
|
|
get_object(): GObject.Object
|
|
|
|
// Class property signals of Atk-1.0.Atk.GObjectAccessible
|
|
|
|
connect(sigName: "notify::accessible-component-layer", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-component-layer", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-component-layer", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-component-mdi-zorder", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-component-mdi-zorder", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-component-mdi-zorder", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-description", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-description", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-hypertext-nlinks", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-hypertext-nlinks", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-hypertext-nlinks", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-name", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-name", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-name", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-role", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-role", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-role", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-caption", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-caption", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-caption", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-caption-object", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-caption-object", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-caption-object", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-column-description", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-column-description", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-column-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-column-header", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-column-header", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-column-header", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-row-description", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-row-description", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-row-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-row-header", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-row-header", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-row-header", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-summary", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-summary", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-summary", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-value", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-value", callback: (($obj: GObjectAccessible, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-value", ...args: any[]): void
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* This object class is derived from AtkObject and can be used as a basis implementing accessible objects.
|
|
*
|
|
* This object class is derived from AtkObject. It can be used as a
|
|
* basis for implementing accessible objects for GObjects which are
|
|
* not derived from GtkWidget. One example of its use is in providing
|
|
* an accessible object for GnomeCanvasItem in the GAIL library.
|
|
* @class
|
|
*/
|
|
export class GObjectAccessible extends Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.GObjectAccessible
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<GObjectAccessible>
|
|
|
|
// Constructors of Atk-1.0.Atk.GObjectAccessible
|
|
|
|
constructor(config?: GObjectAccessible.ConstructorProperties)
|
|
_init(config?: GObjectAccessible.ConstructorProperties): void
|
|
/**
|
|
* Gets the accessible object for the specified `obj`.
|
|
* @param obj a #GObject
|
|
* @returns a #AtkObject which is the accessible object for the @obj
|
|
*/
|
|
static for_object(obj: GObject.Object): Object
|
|
}
|
|
|
|
export module Hyperlink {
|
|
|
|
// Signal callback interfaces
|
|
|
|
/**
|
|
* Signal callback interface for `link-activated`
|
|
*/
|
|
export interface LinkActivatedSignalCallback {
|
|
($obj: Hyperlink): void
|
|
}
|
|
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends Action.ConstructorProperties, GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface Hyperlink extends Action {
|
|
|
|
// Own properties of Atk-1.0.Atk.Hyperlink
|
|
|
|
readonly end_index: number
|
|
readonly number_of_anchors: number
|
|
/**
|
|
* Selected link
|
|
*/
|
|
readonly selected_link: boolean
|
|
readonly start_index: number
|
|
|
|
// Own fields of Atk-1.0.Atk.Hyperlink
|
|
|
|
parent: GObject.Object
|
|
|
|
// Owm methods of Atk-1.0.Atk.Hyperlink
|
|
|
|
/**
|
|
* Gets the index with the hypertext document at which this link ends.
|
|
* @returns the index with the hypertext document at which this link ends
|
|
*/
|
|
get_end_index(): number
|
|
/**
|
|
* Gets the number of anchors associated with this hyperlink.
|
|
* @returns the number of anchors associated with this hyperlink
|
|
*/
|
|
get_n_anchors(): number
|
|
/**
|
|
* Returns the item associated with this hyperlinks nth anchor.
|
|
* For instance, the returned #AtkObject will implement #AtkText
|
|
* if `link_` is a text hyperlink, #AtkImage if `link_` is an image
|
|
* hyperlink etc.
|
|
*
|
|
* Multiple anchors are primarily used by client-side image maps.
|
|
* @param i a (zero-index) integer specifying the desired anchor
|
|
* @returns an #AtkObject associated with this hyperlinks i-th anchor
|
|
*/
|
|
get_object(i: number): Object
|
|
/**
|
|
* Gets the index with the hypertext document at which this link begins.
|
|
* @returns the index with the hypertext document at which this link begins
|
|
*/
|
|
get_start_index(): number
|
|
/**
|
|
* Get a the URI associated with the anchor specified
|
|
* by `i` of `link_`.
|
|
*
|
|
* Multiple anchors are primarily used by client-side image maps.
|
|
* @param i a (zero-index) integer specifying the desired anchor
|
|
* @returns a string specifying the URI
|
|
*/
|
|
get_uri(i: number): string | null
|
|
/**
|
|
* Indicates whether the link currently displays some or all of its
|
|
* content inline. Ordinary HTML links will usually return
|
|
* %FALSE, but an inline <src> HTML element will return
|
|
* %TRUE.
|
|
* @returns whether or not this link displays its content inline.
|
|
*/
|
|
is_inline(): boolean
|
|
/**
|
|
* Determines whether this AtkHyperlink is selected
|
|
* @returns True if the AtkHyperlink is selected, False otherwise
|
|
*/
|
|
is_selected_link(): boolean
|
|
/**
|
|
* Since the document that a link is associated with may have changed
|
|
* this method returns %TRUE if the link is still valid (with
|
|
* respect to the document it references) and %FALSE otherwise.
|
|
* @returns whether or not this link is still valid
|
|
*/
|
|
is_valid(): boolean
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.Hyperlink
|
|
|
|
/**
|
|
* Gets the index with the hypertext document at which this link ends.
|
|
* @virtual
|
|
* @returns the index with the hypertext document at which this link ends
|
|
*/
|
|
vfunc_get_end_index(): number
|
|
/**
|
|
* Gets the number of anchors associated with this hyperlink.
|
|
* @virtual
|
|
* @returns the number of anchors associated with this hyperlink
|
|
*/
|
|
vfunc_get_n_anchors(): number
|
|
/**
|
|
* Returns the item associated with this hyperlinks nth anchor.
|
|
* For instance, the returned #AtkObject will implement #AtkText
|
|
* if `link_` is a text hyperlink, #AtkImage if `link_` is an image
|
|
* hyperlink etc.
|
|
*
|
|
* Multiple anchors are primarily used by client-side image maps.
|
|
* @virtual
|
|
* @param i a (zero-index) integer specifying the desired anchor
|
|
* @returns an #AtkObject associated with this hyperlinks i-th anchor
|
|
*/
|
|
vfunc_get_object(i: number): Object
|
|
/**
|
|
* Gets the index with the hypertext document at which this link begins.
|
|
* @virtual
|
|
* @returns the index with the hypertext document at which this link begins
|
|
*/
|
|
vfunc_get_start_index(): number
|
|
/**
|
|
* Get a the URI associated with the anchor specified
|
|
* by `i` of `link_`.
|
|
*
|
|
* Multiple anchors are primarily used by client-side image maps.
|
|
* @virtual
|
|
* @param i a (zero-index) integer specifying the desired anchor
|
|
* @returns a string specifying the URI
|
|
*/
|
|
vfunc_get_uri(i: number): string | null
|
|
/**
|
|
* Determines whether this AtkHyperlink is selected
|
|
* @virtual
|
|
* @returns True if the AtkHyperlink is selected, False otherwise
|
|
*/
|
|
vfunc_is_selected_link(): boolean
|
|
/**
|
|
* Since the document that a link is associated with may have changed
|
|
* this method returns %TRUE if the link is still valid (with
|
|
* respect to the document it references) and %FALSE otherwise.
|
|
* @virtual
|
|
* @returns whether or not this link is still valid
|
|
*/
|
|
vfunc_is_valid(): boolean
|
|
vfunc_link_activated(): void
|
|
vfunc_link_state(): number
|
|
|
|
// Own signals of Atk-1.0.Atk.Hyperlink
|
|
|
|
connect(sigName: "link-activated", callback: Hyperlink.LinkActivatedSignalCallback): number
|
|
connect_after(sigName: "link-activated", callback: Hyperlink.LinkActivatedSignalCallback): number
|
|
emit(sigName: "link-activated", ...args: any[]): void
|
|
|
|
// Class property signals of Atk-1.0.Atk.Hyperlink
|
|
|
|
connect(sigName: "notify::end-index", callback: (($obj: Hyperlink, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::end-index", callback: (($obj: Hyperlink, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::end-index", ...args: any[]): void
|
|
connect(sigName: "notify::number-of-anchors", callback: (($obj: Hyperlink, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::number-of-anchors", callback: (($obj: Hyperlink, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::number-of-anchors", ...args: any[]): void
|
|
connect(sigName: "notify::selected-link", callback: (($obj: Hyperlink, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::selected-link", callback: (($obj: Hyperlink, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::selected-link", ...args: any[]): void
|
|
connect(sigName: "notify::start-index", callback: (($obj: Hyperlink, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::start-index", callback: (($obj: Hyperlink, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::start-index", ...args: any[]): void
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* An ATK object which encapsulates a link or set of links in a hypertext document.
|
|
*
|
|
* An ATK object which encapsulates a link or set of links (for
|
|
* instance in the case of client-side image maps) in a hypertext
|
|
* document. It may implement the AtkAction interface. AtkHyperlink
|
|
* may also be used to refer to inline embedded content, since it
|
|
* allows specification of a start and end offset within the host
|
|
* AtkHypertext object.
|
|
* @class
|
|
*/
|
|
export class Hyperlink extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Hyperlink
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Hyperlink>
|
|
|
|
// Constructors of Atk-1.0.Atk.Hyperlink
|
|
|
|
constructor(config?: Hyperlink.ConstructorProperties)
|
|
_init(config?: Hyperlink.ConstructorProperties): void
|
|
}
|
|
|
|
export module Misc {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface Misc {
|
|
|
|
// Own fields of Atk-1.0.Atk.Misc
|
|
|
|
parent: GObject.Object
|
|
|
|
// Owm methods of Atk-1.0.Atk.Misc
|
|
|
|
/**
|
|
* Take the thread mutex for the GUI toolkit,
|
|
* if one exists.
|
|
* (This method is implemented by the toolkit ATK implementation layer;
|
|
* for instance, for GTK+, GAIL implements this via GDK_THREADS_ENTER).
|
|
*/
|
|
threads_enter(): void
|
|
/**
|
|
* Release the thread mutex for the GUI toolkit,
|
|
* if one exists. This method, and atk_misc_threads_enter,
|
|
* are needed in some situations by threaded application code which
|
|
* services ATK requests, since fulfilling ATK requests often
|
|
* requires calling into the GUI toolkit. If a long-running or
|
|
* potentially blocking call takes place inside such a block, it should
|
|
* be bracketed by atk_misc_threads_leave/atk_misc_threads_enter calls.
|
|
* (This method is implemented by the toolkit ATK implementation layer;
|
|
* for instance, for GTK+, GAIL implements this via GDK_THREADS_LEAVE).
|
|
*/
|
|
threads_leave(): void
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.Misc
|
|
|
|
/**
|
|
* Take the thread mutex for the GUI toolkit,
|
|
* if one exists.
|
|
* (This method is implemented by the toolkit ATK implementation layer;
|
|
* for instance, for GTK+, GAIL implements this via GDK_THREADS_ENTER).
|
|
* @virtual
|
|
*/
|
|
vfunc_threads_enter(): void
|
|
/**
|
|
* Release the thread mutex for the GUI toolkit,
|
|
* if one exists. This method, and atk_misc_threads_enter,
|
|
* are needed in some situations by threaded application code which
|
|
* services ATK requests, since fulfilling ATK requests often
|
|
* requires calling into the GUI toolkit. If a long-running or
|
|
* potentially blocking call takes place inside such a block, it should
|
|
* be bracketed by atk_misc_threads_leave/atk_misc_threads_enter calls.
|
|
* (This method is implemented by the toolkit ATK implementation layer;
|
|
* for instance, for GTK+, GAIL implements this via GDK_THREADS_LEAVE).
|
|
* @virtual
|
|
*/
|
|
vfunc_threads_leave(): void
|
|
|
|
// Class property signals of Atk-1.0.Atk.Misc
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* A set of ATK utility functions for thread locking
|
|
*
|
|
* A set of utility functions for thread locking. This interface and
|
|
* all his related methods are deprecated since 2.12.
|
|
* @class
|
|
*/
|
|
export class Misc extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Misc
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Misc>
|
|
|
|
// Constructors of Atk-1.0.Atk.Misc
|
|
|
|
constructor(config?: Misc.ConstructorProperties)
|
|
_init(config?: Misc.ConstructorProperties): void
|
|
/**
|
|
* Obtain the singleton instance of AtkMisc for this application.
|
|
* @returns The singleton instance of AtkMisc for this application.
|
|
*/
|
|
static get_instance(): Misc
|
|
}
|
|
|
|
export module NoOpObject {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends Action.ConstructorProperties, Component.ConstructorProperties, Document.ConstructorProperties, EditableText.ConstructorProperties, Hypertext.ConstructorProperties, Image.ConstructorProperties, Selection.ConstructorProperties, Table.ConstructorProperties, TableCell.ConstructorProperties, Text.ConstructorProperties, Value.ConstructorProperties, Window.ConstructorProperties, Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface NoOpObject extends Action, Component, Document, EditableText, Hypertext, Image, Selection, Table, TableCell, Text, Value, Window {
|
|
|
|
// Own fields of Atk-1.0.Atk.NoOpObject
|
|
|
|
parent: Object & GObject.Object
|
|
|
|
// Conflicting methods
|
|
|
|
/**
|
|
* Returns a description of the specified action of the object.
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @returns a description string, or %NULL if @action does not implement this interface.
|
|
*/
|
|
get_description(i: number): string | null
|
|
/**
|
|
* Gets the accessible description of the accessible.
|
|
* @returns a character string representing the accessible description of the accessible.
|
|
*/
|
|
get_description(): string | null
|
|
/**
|
|
* Returns a non-localized string naming the specified action of the
|
|
* object. This name is generally not descriptive of the end result
|
|
* of the action, but instead names the 'interaction type' which the
|
|
* object supports. By convention, the above strings should be used to
|
|
* represent the actions which correspond to the common point-and-click
|
|
* interaction 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 the
|
|
* object, if one exists.
|
|
*
|
|
* For technical reasons, some toolkits cannot guarantee that the
|
|
* reported action is actually 'bound' to a nontrivial user event;
|
|
* i.e. the result of some actions via atk_action_do_action() may be
|
|
* NIL.
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @returns a name string, or %NULL if @action does not implement this interface.
|
|
*/
|
|
get_name(i: number): string | null
|
|
/**
|
|
* Gets the accessible name of the accessible.
|
|
* @returns a character string representing the accessible name of the object.
|
|
*/
|
|
get_name(): string | null
|
|
/**
|
|
* Sets a description of the specified action of the object.
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @param desc the description to be assigned to this action
|
|
* @returns a gboolean representing if the description was successfully set;
|
|
*/
|
|
set_description(i: number, desc: string | null): boolean
|
|
/**
|
|
* Sets the accessible description of the accessible. You can't set
|
|
* the description to NULL. This is reserved for the initial value. In
|
|
* this aspect NULL is similar to ATK_ROLE_UNKNOWN. If you want to set
|
|
* the name to a empty value you can use "".
|
|
* @param description a character string to be set as the accessible description
|
|
*/
|
|
set_description(description: string | null): void
|
|
/**
|
|
* Gets the position of `component` in the form of
|
|
* a point specifying `component'`s top-left corner.
|
|
*
|
|
* If the position can not be obtained (e.g. a non-embedded plug or missing
|
|
* support), x and y are set to -1.
|
|
* @param coord_type specifies whether the coordinates are relative to the screen or to the components top level window
|
|
*/
|
|
get_position(coord_type: CoordType): [ /* x */ number, /* y */ number ]
|
|
/**
|
|
* Retrieves the tabular position of this cell.
|
|
* @returns TRUE if successful; FALSE otherwise.
|
|
*/
|
|
get_position(): [ /* returnType */ boolean, /* row */ number, /* column */ number ]
|
|
/**
|
|
* Adds the specified accessible child of the object to the
|
|
* object's selection.
|
|
* @param i a #gint specifying the child index.
|
|
* @returns TRUE if success, FALSE otherwise.
|
|
*/
|
|
add_selection(i: number): boolean
|
|
/**
|
|
* Adds a selection bounded by the specified offsets.
|
|
* @param start_offset the starting character offset of the selected region
|
|
* @param end_offset the offset of the first character after the selected region.
|
|
* @returns %TRUE if successful, %FALSE otherwise
|
|
*/
|
|
add_selection(start_offset: number, end_offset: number): boolean
|
|
/**
|
|
* Returns a description of the specified action of the object.
|
|
* @virtual
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @returns a description string, or %NULL if @action does not implement this interface.
|
|
*/
|
|
vfunc_get_description(i: number): string | null
|
|
/**
|
|
* Gets the accessible description of the accessible.
|
|
* @virtual
|
|
* @returns a character string representing the accessible description of the accessible.
|
|
*/
|
|
vfunc_get_description(): string | null
|
|
/**
|
|
* Returns a non-localized string naming the specified action of the
|
|
* object. This name is generally not descriptive of the end result
|
|
* of the action, but instead names the 'interaction type' which the
|
|
* object supports. By convention, the above strings should be used to
|
|
* represent the actions which correspond to the common point-and-click
|
|
* interaction 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 the
|
|
* object, if one exists.
|
|
*
|
|
* For technical reasons, some toolkits cannot guarantee that the
|
|
* reported action is actually 'bound' to a nontrivial user event;
|
|
* i.e. the result of some actions via atk_action_do_action() may be
|
|
* NIL.
|
|
* @virtual
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @returns a name string, or %NULL if @action does not implement this interface.
|
|
*/
|
|
vfunc_get_name(i: number): string | null
|
|
/**
|
|
* Gets the accessible name of the accessible.
|
|
* @virtual
|
|
* @returns a character string representing the accessible name of the object.
|
|
*/
|
|
vfunc_get_name(): string | null
|
|
/**
|
|
* Sets a description of the specified action of the object.
|
|
* @virtual
|
|
* @param i the action index corresponding to the action to be performed
|
|
* @param desc the description to be assigned to this action
|
|
* @returns a gboolean representing if the description was successfully set;
|
|
*/
|
|
vfunc_set_description(i: number, desc: string | null): boolean
|
|
/**
|
|
* Sets the accessible description of the accessible. You can't set
|
|
* the description to NULL. This is reserved for the initial value. In
|
|
* this aspect NULL is similar to ATK_ROLE_UNKNOWN. If you want to set
|
|
* the name to a empty value you can use "".
|
|
* @virtual
|
|
* @param description a character string to be set as the accessible description
|
|
*/
|
|
vfunc_set_description(description: string | null): void
|
|
/**
|
|
* Gets the position of `component` in the form of
|
|
* a point specifying `component'`s top-left corner.
|
|
*
|
|
* If the position can not be obtained (e.g. a non-embedded plug or missing
|
|
* support), x and y are set to -1.
|
|
* @virtual
|
|
* @param coord_type specifies whether the coordinates are relative to the screen or to the components top level window
|
|
*/
|
|
vfunc_get_position(coord_type: CoordType): [ /* x */ number, /* y */ number ]
|
|
/**
|
|
* Retrieves the tabular position of this cell.
|
|
* @virtual
|
|
* @returns TRUE if successful; FALSE otherwise.
|
|
*/
|
|
vfunc_get_position(): [ /* returnType */ boolean, /* row */ number, /* column */ number ]
|
|
/**
|
|
* Adds the specified accessible child of the object to the
|
|
* object's selection.
|
|
* @virtual
|
|
* @param i a #gint specifying the child index.
|
|
* @returns TRUE if success, FALSE otherwise.
|
|
*/
|
|
vfunc_add_selection(i: number): boolean
|
|
/**
|
|
* Adds a selection bounded by the specified offsets.
|
|
* @virtual
|
|
* @param start_offset the starting character offset of the selected region
|
|
* @param end_offset the offset of the first character after the selected region.
|
|
* @returns %TRUE if successful, %FALSE otherwise
|
|
*/
|
|
vfunc_add_selection(start_offset: number, end_offset: number): boolean
|
|
|
|
// Class property signals of Atk-1.0.Atk.NoOpObject
|
|
|
|
connect(sigName: "notify::accessible-component-layer", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-component-layer", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-component-layer", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-component-mdi-zorder", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-component-mdi-zorder", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-component-mdi-zorder", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-description", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-description", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-hypertext-nlinks", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-hypertext-nlinks", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-hypertext-nlinks", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-name", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-name", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-name", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-role", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-role", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-role", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-caption", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-caption", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-caption", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-caption-object", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-caption-object", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-caption-object", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-column-description", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-column-description", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-column-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-column-header", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-column-header", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-column-header", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-row-description", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-row-description", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-row-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-row-header", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-row-header", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-row-header", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-summary", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-summary", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-summary", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-value", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-value", callback: (($obj: NoOpObject, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-value", ...args: any[]): void
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* An AtkObject which purports to implement all ATK interfaces.
|
|
*
|
|
* An AtkNoOpObject is an AtkObject which purports to implement all
|
|
* ATK interfaces. It is the type of AtkObject which is created if an
|
|
* accessible object is requested for an object type for which no
|
|
* factory type is specified.
|
|
* @class
|
|
*/
|
|
export class NoOpObject extends Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.NoOpObject
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<NoOpObject>
|
|
|
|
// Constructors of Atk-1.0.Atk.NoOpObject
|
|
|
|
constructor(config?: NoOpObject.ConstructorProperties)
|
|
/**
|
|
* Provides a default (non-functioning stub) #AtkObject.
|
|
* Application maintainers should not use this method.
|
|
* @constructor
|
|
* @param obj a #GObject
|
|
* @returns a default (non-functioning stub) #AtkObject
|
|
*/
|
|
constructor(obj: GObject.Object)
|
|
/**
|
|
* Provides a default (non-functioning stub) #AtkObject.
|
|
* Application maintainers should not use this method.
|
|
* @constructor
|
|
* @param obj a #GObject
|
|
* @returns a default (non-functioning stub) #AtkObject
|
|
*/
|
|
static new(obj: GObject.Object): NoOpObject
|
|
_init(config?: NoOpObject.ConstructorProperties): void
|
|
}
|
|
|
|
export module NoOpObjectFactory {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends ObjectFactory.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface NoOpObjectFactory {
|
|
|
|
// Own fields of Atk-1.0.Atk.NoOpObjectFactory
|
|
|
|
parent: ObjectFactory & GObject.Object
|
|
|
|
// Class property signals of Atk-1.0.Atk.NoOpObjectFactory
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The AtkObjectFactory which creates an AtkNoOpObject.
|
|
*
|
|
* The AtkObjectFactory which creates an AtkNoOpObject. An instance of
|
|
* this is created by an AtkRegistry if no factory type has not been
|
|
* specified to create an accessible object of a particular type.
|
|
* @class
|
|
*/
|
|
export class NoOpObjectFactory extends ObjectFactory {
|
|
|
|
// Own properties of Atk-1.0.Atk.NoOpObjectFactory
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<NoOpObjectFactory>
|
|
|
|
// Constructors of Atk-1.0.Atk.NoOpObjectFactory
|
|
|
|
constructor(config?: NoOpObjectFactory.ConstructorProperties)
|
|
/**
|
|
* Creates an instance of an #AtkObjectFactory which generates primitive
|
|
* (non-functioning) #AtkObjects.
|
|
* @constructor
|
|
* @returns an instance of an #AtkObjectFactory
|
|
*/
|
|
constructor()
|
|
/**
|
|
* Creates an instance of an #AtkObjectFactory which generates primitive
|
|
* (non-functioning) #AtkObjects.
|
|
* @constructor
|
|
* @returns an instance of an #AtkObjectFactory
|
|
*/
|
|
static new(): NoOpObjectFactory
|
|
_init(config?: NoOpObjectFactory.ConstructorProperties): void
|
|
}
|
|
|
|
export module Object {
|
|
|
|
// Signal callback interfaces
|
|
|
|
/**
|
|
* Signal callback interface for `active-descendant-changed`
|
|
*/
|
|
export interface ActiveDescendantChangedSignalCallback {
|
|
($obj: Object, arg1: Object): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `announcement`
|
|
*/
|
|
export interface AnnouncementSignalCallback {
|
|
($obj: Object, arg1: string | null): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `children-changed`
|
|
*/
|
|
export interface ChildrenChangedSignalCallback {
|
|
($obj: Object, arg1: number, arg2: Object): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `focus-event`
|
|
*/
|
|
export interface FocusEventSignalCallback {
|
|
($obj: Object, arg1: boolean): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `notification`
|
|
*/
|
|
export interface NotificationSignalCallback {
|
|
($obj: Object, arg1: string | null, arg2: number): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `property-change`
|
|
*/
|
|
export interface PropertyChangeSignalCallback {
|
|
($obj: Object, arg1: PropertyValues): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `state-change`
|
|
*/
|
|
export interface StateChangeSignalCallback {
|
|
($obj: Object, arg1: string | null, arg2: boolean): void
|
|
}
|
|
|
|
/**
|
|
* Signal callback interface for `visible-data-changed`
|
|
*/
|
|
export interface VisibleDataChangedSignalCallback {
|
|
($obj: Object): void
|
|
}
|
|
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
|
|
// Own constructor properties of Atk-1.0.Atk.Object
|
|
|
|
accessible_description?: string | null
|
|
accessible_name?: string | null
|
|
accessible_parent?: Object | null
|
|
accessible_role?: Role | null
|
|
/**
|
|
* Table caption.
|
|
*/
|
|
accessible_table_caption?: string | null
|
|
accessible_table_caption_object?: Object | null
|
|
/**
|
|
* Accessible table column description.
|
|
*/
|
|
accessible_table_column_description?: string | null
|
|
/**
|
|
* Accessible table column header.
|
|
*/
|
|
accessible_table_column_header?: Object | null
|
|
/**
|
|
* Accessible table row description.
|
|
*/
|
|
accessible_table_row_description?: string | null
|
|
/**
|
|
* Accessible table row header.
|
|
*/
|
|
accessible_table_row_header?: Object | null
|
|
accessible_table_summary?: Object | null
|
|
/**
|
|
* Numeric value of this object, in case being and AtkValue.
|
|
*/
|
|
accessible_value?: number | null
|
|
}
|
|
|
|
}
|
|
|
|
export interface Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Object
|
|
|
|
readonly accessible_component_layer: number
|
|
readonly accessible_component_mdi_zorder: number
|
|
accessible_description: string | null
|
|
readonly accessible_hypertext_nlinks: number
|
|
accessible_name: string | null
|
|
accessible_role: Role
|
|
/**
|
|
* Table caption.
|
|
*/
|
|
accessible_table_caption: string | null
|
|
accessible_table_caption_object: Object
|
|
/**
|
|
* Accessible table column description.
|
|
*/
|
|
accessible_table_column_description: string | null
|
|
/**
|
|
* Accessible table column header.
|
|
*/
|
|
accessible_table_column_header: Object
|
|
/**
|
|
* Accessible table row description.
|
|
*/
|
|
accessible_table_row_description: string | null
|
|
/**
|
|
* Accessible table row header.
|
|
*/
|
|
accessible_table_row_header: Object
|
|
accessible_table_summary: Object
|
|
/**
|
|
* Numeric value of this object, in case being and AtkValue.
|
|
*/
|
|
accessible_value: number
|
|
|
|
// Own fields of Atk-1.0.Atk.Object
|
|
|
|
parent: GObject.Object
|
|
description: string | null
|
|
name: string | null
|
|
accessible_parent: Object
|
|
role: Role
|
|
relation_set: RelationSet
|
|
layer: Layer
|
|
|
|
// Owm methods of Atk-1.0.Atk.Object
|
|
|
|
/**
|
|
* Adds a relationship of the specified type with the specified target.
|
|
* @param relationship The #AtkRelationType of the relation
|
|
* @param target The #AtkObject which is to be the target of the relation.
|
|
* @returns TRUE if the relationship is added.
|
|
*/
|
|
add_relationship(relationship: RelationType, target: Object): boolean
|
|
/**
|
|
* Gets the accessible id of the accessible.
|
|
* @returns a character string representing the accessible id of the object, or NULL if no such string was set.
|
|
*/
|
|
get_accessible_id(): string | null
|
|
/**
|
|
* Get a list of properties applied to this object as a whole, as an #AtkAttributeSet consisting of
|
|
* name-value pairs. As such these attributes may be considered weakly-typed properties or annotations,
|
|
* as distinct from strongly-typed object data available via other get/set methods.
|
|
* Not all objects have explicit "name-value pair" #AtkAttributeSet properties.
|
|
* @returns an #AtkAttributeSet consisting of all explicit properties/annotations applied to the object, or an empty set if the object has no name-value pair attributes assigned to it. This #atkattributeset should be freed by a call to atk_attribute_set_free().
|
|
*/
|
|
get_attributes(): AttributeSet
|
|
/**
|
|
* Gets the accessible description of the accessible.
|
|
* @returns a character string representing the accessible description of the accessible.
|
|
*/
|
|
get_description(): string | null
|
|
/**
|
|
* Gets the 0-based index of this accessible in its parent; returns -1 if the
|
|
* accessible does not have an accessible parent.
|
|
* @returns an integer which is the index of the accessible in its parent
|
|
*/
|
|
get_index_in_parent(): number
|
|
/**
|
|
* Gets the layer of the accessible.
|
|
* @returns an #AtkLayer which is the layer of the accessible
|
|
*/
|
|
get_layer(): Layer
|
|
/**
|
|
* Gets the zorder of the accessible. The value G_MININT will be returned
|
|
* if the layer of the accessible is not ATK_LAYER_MDI.
|
|
* @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.
|
|
*/
|
|
get_mdi_zorder(): number
|
|
/**
|
|
* Gets the number of accessible children of the accessible.
|
|
* @returns an integer representing the number of accessible children of the accessible.
|
|
*/
|
|
get_n_accessible_children(): number
|
|
/**
|
|
* Gets the accessible name of the accessible.
|
|
* @returns a character string representing the accessible name of the object.
|
|
*/
|
|
get_name(): string | null
|
|
/**
|
|
* Gets a UTF-8 string indicating the POSIX-style LC_MESSAGES locale
|
|
* of `accessible`.
|
|
* @returns a UTF-8 string indicating the POSIX-style LC_MESSAGES locale of @accessible.
|
|
*/
|
|
get_object_locale(): string | null
|
|
/**
|
|
* Gets the accessible parent of the accessible. By default this is
|
|
* the one assigned with atk_object_set_parent(), but it is assumed
|
|
* that ATK implementors have ways to get the parent of the object
|
|
* without the need of assigning it manually with
|
|
* atk_object_set_parent(), and will return it with this method.
|
|
*
|
|
* If you are only interested on the parent assigned with
|
|
* atk_object_set_parent(), use atk_object_peek_parent().
|
|
* @returns an #AtkObject representing the accessible parent of the accessible
|
|
*/
|
|
get_parent(): Object
|
|
/**
|
|
* Gets the role of the accessible.
|
|
* @returns an #AtkRole which is the role of the accessible
|
|
*/
|
|
get_role(): Role
|
|
/**
|
|
* 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
|
|
* @param data a #gpointer which identifies the object for which the AtkObject was created.
|
|
*/
|
|
initialize(data: any | null): void
|
|
/**
|
|
* Emits a state-change signal for the specified state.
|
|
*
|
|
* Note that as a general rule when the state of an existing object changes,
|
|
* emitting a notification is expected.
|
|
* @param state an #AtkState whose state is changed
|
|
* @param value a gboolean which indicates whether the state is being set on or off
|
|
*/
|
|
notify_state_change(state: State, value: boolean): void
|
|
/**
|
|
* Gets the accessible parent of the accessible, if it has been
|
|
* manually assigned with atk_object_set_parent. Otherwise, this
|
|
* function returns %NULL.
|
|
*
|
|
* This method is intended as an utility for ATK implementors, and not
|
|
* to be exposed to accessible tools. See atk_object_get_parent() for
|
|
* further reference.
|
|
* @returns an #AtkObject representing the accessible parent of the accessible if assigned
|
|
*/
|
|
peek_parent(): Object
|
|
/**
|
|
* 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.
|
|
* @param i a gint representing the position of the child, starting from 0
|
|
* @returns an #AtkObject representing the specified accessible child of the accessible.
|
|
*/
|
|
ref_accessible_child(i: number): Object
|
|
/**
|
|
* Gets the #AtkRelationSet associated with the object.
|
|
* @returns an #AtkRelationSet representing the relation set of the object.
|
|
*/
|
|
ref_relation_set(): RelationSet
|
|
/**
|
|
* Gets a reference to the state set of the accessible; the caller must
|
|
* unreference it when it is no longer needed.
|
|
* @returns a reference to an #AtkStateSet which is the state set of the accessible
|
|
*/
|
|
ref_state_set(): StateSet
|
|
/**
|
|
* Removes a property change handler.
|
|
* @param handler_id a guint which identifies the handler to be removed.
|
|
*/
|
|
remove_property_change_handler(handler_id: number): void
|
|
/**
|
|
* Removes a relationship of the specified type with the specified target.
|
|
* @param relationship The #AtkRelationType of the relation
|
|
* @param target The #AtkObject which is the target of the relation to be removed.
|
|
* @returns TRUE if the relationship is removed.
|
|
*/
|
|
remove_relationship(relationship: RelationType, target: Object): boolean
|
|
/**
|
|
* Sets the accessible ID of the accessible. This is not meant to be presented
|
|
* to the user, but to be an ID which is stable over application development.
|
|
* Typically, this is the gtkbuilder ID. Such an ID will be available for
|
|
* instance to identify a given well-known accessible object for tailored screen
|
|
* reading, or for automatic regression testing.
|
|
* @param name a character string to be set as the accessible id
|
|
*/
|
|
set_accessible_id(name: string | null): void
|
|
/**
|
|
* Sets the accessible description of the accessible. You can't set
|
|
* the description to NULL. This is reserved for the initial value. In
|
|
* this aspect NULL is similar to ATK_ROLE_UNKNOWN. If you want to set
|
|
* the name to a empty value you can use "".
|
|
* @param description a character string to be set as the accessible description
|
|
*/
|
|
set_description(description: string | null): void
|
|
/**
|
|
* Sets the accessible name of the accessible. You can't set the name
|
|
* to NULL. This is reserved for the initial value. In this aspect
|
|
* NULL is similar to ATK_ROLE_UNKNOWN. If you want to set the name to
|
|
* a empty value you can use "".
|
|
* @param name a character string to be set as the accessible name
|
|
*/
|
|
set_name(name: string | null): void
|
|
/**
|
|
* Sets the accessible parent of the accessible. `parent` can be NULL.
|
|
* @param parent an #AtkObject to be set as the accessible parent
|
|
*/
|
|
set_parent(parent: Object): void
|
|
/**
|
|
* Sets the role of the accessible.
|
|
* @param role an #AtkRole to be set as the role
|
|
*/
|
|
set_role(role: Role): void
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.Object
|
|
|
|
vfunc_active_descendant_changed(child: any | null): void
|
|
vfunc_children_changed(change_index: number, changed_child: any | null): void
|
|
vfunc_focus_event(focus_in: boolean): void
|
|
/**
|
|
* Get a list of properties applied to this object as a whole, as an #AtkAttributeSet consisting of
|
|
* name-value pairs. As such these attributes may be considered weakly-typed properties or annotations,
|
|
* as distinct from strongly-typed object data available via other get/set methods.
|
|
* Not all objects have explicit "name-value pair" #AtkAttributeSet properties.
|
|
* @virtual
|
|
* @returns an #AtkAttributeSet consisting of all explicit properties/annotations applied to the object, or an empty set if the object has no name-value pair attributes assigned to it. This #atkattributeset should be freed by a call to atk_attribute_set_free().
|
|
*/
|
|
vfunc_get_attributes(): AttributeSet
|
|
/**
|
|
* Gets the accessible description of the accessible.
|
|
* @virtual
|
|
* @returns a character string representing the accessible description of the accessible.
|
|
*/
|
|
vfunc_get_description(): string | null
|
|
/**
|
|
* Gets the 0-based index of this accessible in its parent; returns -1 if the
|
|
* accessible does not have an accessible parent.
|
|
* @virtual
|
|
* @returns an integer which is the index of the accessible in its parent
|
|
*/
|
|
vfunc_get_index_in_parent(): number
|
|
/**
|
|
* Gets the layer of the accessible.
|
|
* @virtual
|
|
* @returns an #AtkLayer which is the layer of the accessible
|
|
*/
|
|
vfunc_get_layer(): Layer
|
|
/**
|
|
* Gets the zorder of the accessible. The value G_MININT will be returned
|
|
* if the layer of the accessible is not ATK_LAYER_MDI.
|
|
* @virtual
|
|
* @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.
|
|
*/
|
|
vfunc_get_mdi_zorder(): number
|
|
vfunc_get_n_children(): number
|
|
/**
|
|
* Gets the accessible name of the accessible.
|
|
* @virtual
|
|
* @returns a character string representing the accessible name of the object.
|
|
*/
|
|
vfunc_get_name(): string | null
|
|
/**
|
|
* Gets a UTF-8 string indicating the POSIX-style LC_MESSAGES locale
|
|
* of `accessible`.
|
|
* @virtual
|
|
* @returns a UTF-8 string indicating the POSIX-style LC_MESSAGES locale of @accessible.
|
|
*/
|
|
vfunc_get_object_locale(): string | null
|
|
/**
|
|
* Gets the accessible parent of the accessible. By default this is
|
|
* the one assigned with atk_object_set_parent(), but it is assumed
|
|
* that ATK implementors have ways to get the parent of the object
|
|
* without the need of assigning it manually with
|
|
* atk_object_set_parent(), and will return it with this method.
|
|
*
|
|
* If you are only interested on the parent assigned with
|
|
* atk_object_set_parent(), use atk_object_peek_parent().
|
|
* @virtual
|
|
* @returns an #AtkObject representing the accessible parent of the accessible
|
|
*/
|
|
vfunc_get_parent(): Object
|
|
/**
|
|
* Gets the role of the accessible.
|
|
* @virtual
|
|
* @returns an #AtkRole which is the role of the accessible
|
|
*/
|
|
vfunc_get_role(): Role
|
|
/**
|
|
* 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
|
|
* @virtual
|
|
* @param data a #gpointer which identifies the object for which the AtkObject was created.
|
|
*/
|
|
vfunc_initialize(data: any | null): void
|
|
vfunc_property_change(values: PropertyValues): void
|
|
/**
|
|
* Gets the #AtkRelationSet associated with the object.
|
|
* @virtual
|
|
* @returns an #AtkRelationSet representing the relation set of the object.
|
|
*/
|
|
vfunc_ref_relation_set(): RelationSet
|
|
/**
|
|
* Gets a reference to the state set of the accessible; the caller must
|
|
* unreference it when it is no longer needed.
|
|
* @virtual
|
|
* @returns a reference to an #AtkStateSet which is the state set of the accessible
|
|
*/
|
|
vfunc_ref_state_set(): StateSet
|
|
/**
|
|
* Removes a property change handler.
|
|
* @virtual
|
|
* @param handler_id a guint which identifies the handler to be removed.
|
|
*/
|
|
vfunc_remove_property_change_handler(handler_id: number): void
|
|
/**
|
|
* Sets the accessible description of the accessible. You can't set
|
|
* the description to NULL. This is reserved for the initial value. In
|
|
* this aspect NULL is similar to ATK_ROLE_UNKNOWN. If you want to set
|
|
* the name to a empty value you can use "".
|
|
* @virtual
|
|
* @param description a character string to be set as the accessible description
|
|
*/
|
|
vfunc_set_description(description: string | null): void
|
|
/**
|
|
* Sets the accessible name of the accessible. You can't set the name
|
|
* to NULL. This is reserved for the initial value. In this aspect
|
|
* NULL is similar to ATK_ROLE_UNKNOWN. If you want to set the name to
|
|
* a empty value you can use "".
|
|
* @virtual
|
|
* @param name a character string to be set as the accessible name
|
|
*/
|
|
vfunc_set_name(name: string | null): void
|
|
/**
|
|
* Sets the accessible parent of the accessible. `parent` can be NULL.
|
|
* @virtual
|
|
* @param parent an #AtkObject to be set as the accessible parent
|
|
*/
|
|
vfunc_set_parent(parent: Object): void
|
|
/**
|
|
* Sets the role of the accessible.
|
|
* @virtual
|
|
* @param role an #AtkRole to be set as the role
|
|
*/
|
|
vfunc_set_role(role: Role): void
|
|
vfunc_state_change(name: string | null, state_set: boolean): void
|
|
vfunc_visible_data_changed(): void
|
|
|
|
// Own signals of Atk-1.0.Atk.Object
|
|
|
|
connect(sigName: "active-descendant-changed", callback: Object.ActiveDescendantChangedSignalCallback): number
|
|
connect_after(sigName: "active-descendant-changed", callback: Object.ActiveDescendantChangedSignalCallback): number
|
|
emit(sigName: "active-descendant-changed", arg1: Object, ...args: any[]): void
|
|
connect(sigName: "announcement", callback: Object.AnnouncementSignalCallback): number
|
|
connect_after(sigName: "announcement", callback: Object.AnnouncementSignalCallback): number
|
|
emit(sigName: "announcement", arg1: string | null, ...args: any[]): void
|
|
connect(sigName: "children-changed", callback: Object.ChildrenChangedSignalCallback): number
|
|
connect_after(sigName: "children-changed", callback: Object.ChildrenChangedSignalCallback): number
|
|
emit(sigName: "children-changed", arg1: number, arg2: Object, ...args: any[]): void
|
|
connect(sigName: "focus-event", callback: Object.FocusEventSignalCallback): number
|
|
connect_after(sigName: "focus-event", callback: Object.FocusEventSignalCallback): number
|
|
emit(sigName: "focus-event", arg1: boolean, ...args: any[]): void
|
|
connect(sigName: "notification", callback: Object.NotificationSignalCallback): number
|
|
connect_after(sigName: "notification", callback: Object.NotificationSignalCallback): number
|
|
emit(sigName: "notification", arg1: string | null, arg2: number, ...args: any[]): void
|
|
connect(sigName: "property-change", callback: Object.PropertyChangeSignalCallback): number
|
|
connect_after(sigName: "property-change", callback: Object.PropertyChangeSignalCallback): number
|
|
emit(sigName: "property-change", arg1: PropertyValues, ...args: any[]): void
|
|
connect(sigName: "state-change", callback: Object.StateChangeSignalCallback): number
|
|
connect_after(sigName: "state-change", callback: Object.StateChangeSignalCallback): number
|
|
emit(sigName: "state-change", arg1: string | null, arg2: boolean, ...args: any[]): void
|
|
connect(sigName: "visible-data-changed", callback: Object.VisibleDataChangedSignalCallback): number
|
|
connect_after(sigName: "visible-data-changed", callback: Object.VisibleDataChangedSignalCallback): number
|
|
emit(sigName: "visible-data-changed", ...args: any[]): void
|
|
|
|
// Class property signals of Atk-1.0.Atk.Object
|
|
|
|
connect(sigName: "notify::accessible-component-layer", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-component-layer", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-component-layer", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-component-mdi-zorder", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-component-mdi-zorder", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-component-mdi-zorder", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-description", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-description", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-hypertext-nlinks", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-hypertext-nlinks", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-hypertext-nlinks", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-name", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-name", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-name", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-role", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-role", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-role", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-caption", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-caption", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-caption", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-caption-object", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-caption-object", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-caption-object", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-column-description", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-column-description", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-column-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-column-header", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-column-header", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-column-header", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-row-description", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-row-description", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-row-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-row-header", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-row-header", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-row-header", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-summary", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-summary", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-summary", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-value", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-value", callback: (($obj: Object, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-value", ...args: any[]): void
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The base object class for the Accessibility Toolkit API.
|
|
*
|
|
* This class is the primary class for accessibility support via the
|
|
* Accessibility ToolKit (ATK). Objects which are instances of
|
|
* #AtkObject (or instances of AtkObject-derived types) are queried
|
|
* for properties which relate basic (and generic) properties of a UI
|
|
* component such as name and description. Instances of #AtkObject
|
|
* may also be queried as to whether they implement other ATK
|
|
* interfaces (e.g. #AtkAction, #AtkComponent, etc.), as appropriate
|
|
* to the role which a given UI component plays in a user interface.
|
|
*
|
|
* All UI components in an application which provide useful
|
|
* information or services to the user must provide corresponding
|
|
* #AtkObject instances on request (in GTK+, for instance, usually on
|
|
* a call to #gtk_widget_get_accessible ()), either via ATK support
|
|
* built into the toolkit for the widget class or ancestor class, or
|
|
* in the case of custom widgets, if the inherited #AtkObject
|
|
* implementation is insufficient, via instances of a new #AtkObject
|
|
* subclass.
|
|
*
|
|
* See [class`AtkObjectFactory]`, [class`AtkRegistry]`. (GTK+ users see also
|
|
* #GtkAccessible).
|
|
* @interface
|
|
*/
|
|
export class Object extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Object
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Object>
|
|
|
|
// Constructors of Atk-1.0.Atk.Object
|
|
|
|
constructor(config?: Object.ConstructorProperties)
|
|
_init(config?: Object.ConstructorProperties): void
|
|
}
|
|
|
|
export module ObjectFactory {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface ObjectFactory {
|
|
|
|
// Own fields of Atk-1.0.Atk.ObjectFactory
|
|
|
|
parent: GObject.Object
|
|
|
|
// Owm methods of Atk-1.0.Atk.ObjectFactory
|
|
|
|
/**
|
|
* Provides an #AtkObject that implements an accessibility interface
|
|
* on behalf of `obj`
|
|
* @param obj a #GObject
|
|
* @returns an #AtkObject that implements an accessibility interface on behalf of @obj
|
|
*/
|
|
create_accessible(obj: GObject.Object): Object
|
|
/**
|
|
* Gets the GType of the accessible which is created by the factory.
|
|
* @returns the type of the accessible which is created by the @factory. The value G_TYPE_INVALID is returned if no type if found.
|
|
*/
|
|
get_accessible_type(): GObject.GType
|
|
/**
|
|
* Inform `factory` that it is no longer being used to create
|
|
* accessibles. When called, `factory` may need to inform
|
|
* #AtkObjects which it has created that they need to be re-instantiated.
|
|
* Note: primarily used for runtime replacement of #AtkObjectFactorys
|
|
* in object registries.
|
|
*/
|
|
invalidate(): void
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.ObjectFactory
|
|
|
|
/**
|
|
* Inform `factory` that it is no longer being used to create
|
|
* accessibles. When called, `factory` may need to inform
|
|
* #AtkObjects which it has created that they need to be re-instantiated.
|
|
* Note: primarily used for runtime replacement of #AtkObjectFactorys
|
|
* in object registries.
|
|
* @virtual
|
|
*/
|
|
vfunc_invalidate(): void
|
|
|
|
// Class property signals of Atk-1.0.Atk.ObjectFactory
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* The base object class for a factory used to
|
|
* create accessible objects for objects of a specific GType.
|
|
*
|
|
* This class is the base object class for a factory used to create an
|
|
* accessible object for a specific GType. The function
|
|
* atk_registry_set_factory_type() is normally called to store in the
|
|
* registry the factory type to be used to create an accessible of a
|
|
* particular GType.
|
|
* @class
|
|
*/
|
|
export class ObjectFactory extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.ObjectFactory
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<ObjectFactory>
|
|
|
|
// Constructors of Atk-1.0.Atk.ObjectFactory
|
|
|
|
constructor(config?: ObjectFactory.ConstructorProperties)
|
|
_init(config?: ObjectFactory.ConstructorProperties): void
|
|
}
|
|
|
|
export module Plug {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends Component.ConstructorProperties, Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface Plug extends Component {
|
|
|
|
// Own fields of Atk-1.0.Atk.Plug
|
|
|
|
parent: Object & GObject.Object
|
|
|
|
// Owm methods of Atk-1.0.Atk.Plug
|
|
|
|
/**
|
|
* Gets the unique ID of an #AtkPlug object, which can be used to
|
|
* embed inside of an #AtkSocket using atk_socket_embed().
|
|
*
|
|
* Internally, this calls a class function that should be registered
|
|
* by the IPC layer (usually at-spi2-atk). The implementor of an
|
|
* #AtkPlug object should call this function (after atk-bridge is
|
|
* loaded) and pass the value to the process implementing the
|
|
* #AtkSocket, so it could embed the plug.
|
|
* @returns the unique ID for the plug
|
|
*/
|
|
get_id(): string | null
|
|
/**
|
|
* Sets `child` as accessible child of `plug` and `plug` as accessible parent of
|
|
* `child`. `child` can be NULL.
|
|
*
|
|
* In some cases, one can not use the AtkPlug type directly as accessible
|
|
* object for the toplevel widget of the application. For instance in the gtk
|
|
* case, GtkPlugAccessible can not inherit both from GtkWindowAccessible and
|
|
* from AtkPlug. In such a case, one can create, in addition to the standard
|
|
* accessible object for the toplevel widget, an AtkPlug object, and make the
|
|
* former the child of the latter by calling atk_plug_set_child().
|
|
* @param child an #AtkObject to be set as accessible child of `plug`.
|
|
*/
|
|
set_child(child: Object): void
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.Plug
|
|
|
|
vfunc_get_object_id(): string | null
|
|
|
|
// Class property signals of Atk-1.0.Atk.Plug
|
|
|
|
connect(sigName: "notify::accessible-component-layer", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-component-layer", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-component-layer", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-component-mdi-zorder", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-component-mdi-zorder", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-component-mdi-zorder", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-description", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-description", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-hypertext-nlinks", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-hypertext-nlinks", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-hypertext-nlinks", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-name", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-name", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-name", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-role", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-role", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-role", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-caption", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-caption", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-caption", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-caption-object", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-caption-object", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-caption-object", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-column-description", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-column-description", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-column-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-column-header", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-column-header", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-column-header", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-row-description", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-row-description", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-row-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-row-header", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-row-header", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-row-header", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-summary", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-summary", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-summary", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-value", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-value", callback: (($obj: Plug, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-value", ...args: any[]): void
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* Toplevel for embedding into other processes
|
|
*
|
|
* See [class`AtkSocket]`
|
|
* @class
|
|
*/
|
|
export class Plug extends Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Plug
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Plug>
|
|
|
|
// Constructors of Atk-1.0.Atk.Plug
|
|
|
|
constructor(config?: Plug.ConstructorProperties)
|
|
/**
|
|
* Creates a new #AtkPlug instance.
|
|
* @constructor
|
|
* @returns the newly created #AtkPlug
|
|
*/
|
|
constructor()
|
|
/**
|
|
* Creates a new #AtkPlug instance.
|
|
* @constructor
|
|
* @returns the newly created #AtkPlug
|
|
*/
|
|
static new(): Plug
|
|
_init(config?: Plug.ConstructorProperties): void
|
|
}
|
|
|
|
export module Registry {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface Registry {
|
|
|
|
// Own fields of Atk-1.0.Atk.Registry
|
|
|
|
parent: GObject.Object
|
|
factory_type_registry: GLib.HashTable
|
|
factory_singleton_cache: GLib.HashTable
|
|
|
|
// Owm methods of Atk-1.0.Atk.Registry
|
|
|
|
/**
|
|
* Gets an #AtkObjectFactory appropriate for creating #AtkObjects
|
|
* appropriate for `type`.
|
|
* @param type a #GType with which to look up the associated #AtkObjectFactory
|
|
* @returns an #AtkObjectFactory appropriate for creating #AtkObjects appropriate for @type.
|
|
*/
|
|
get_factory(type: GObject.GType): ObjectFactory
|
|
/**
|
|
* Provides a #GType indicating the #AtkObjectFactory subclass
|
|
* associated with `type`.
|
|
* @param type a #GType with which to look up the associated #AtkObjectFactory subclass
|
|
* @returns a #GType associated with type @type
|
|
*/
|
|
get_factory_type(type: GObject.GType): GObject.GType
|
|
/**
|
|
* Associate an #AtkObjectFactory subclass with a #GType. Note:
|
|
* The associated `factory_type` will thereafter be responsible for
|
|
* the creation of new #AtkObject implementations for instances
|
|
* appropriate for `type`.
|
|
* @param type an #AtkObject type
|
|
* @param factory_type an #AtkObjectFactory type to associate with `type`. Must implement AtkObject appropriate for `type`.
|
|
*/
|
|
set_factory_type(type: GObject.GType, factory_type: GObject.GType): void
|
|
|
|
// Class property signals of Atk-1.0.Atk.Registry
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* An object used to store the GType of the
|
|
* factories used to create an accessible object for an object of a
|
|
* particular GType.
|
|
*
|
|
* The AtkRegistry is normally used to create appropriate ATK "peers"
|
|
* for user interface components. Application developers usually need
|
|
* only interact with the AtkRegistry by associating appropriate ATK
|
|
* implementation classes with GObject classes via the
|
|
* atk_registry_set_factory_type call, passing the appropriate GType
|
|
* for application custom widget classes.
|
|
* @class
|
|
*/
|
|
export class Registry extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Registry
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Registry>
|
|
|
|
// Constructors of Atk-1.0.Atk.Registry
|
|
|
|
constructor(config?: Registry.ConstructorProperties)
|
|
_init(config?: Registry.ConstructorProperties): void
|
|
}
|
|
|
|
export module Relation {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
|
|
// Own constructor properties of Atk-1.0.Atk.Relation
|
|
|
|
relation_type?: RelationType | null
|
|
target?: GObject.ValueArray | null
|
|
}
|
|
|
|
}
|
|
|
|
export interface Relation {
|
|
|
|
// Own properties of Atk-1.0.Atk.Relation
|
|
|
|
relation_type: RelationType
|
|
|
|
// Own fields of Atk-1.0.Atk.Relation
|
|
|
|
parent: GObject.Object
|
|
target: any[]
|
|
relationship: RelationType
|
|
|
|
// Owm methods of Atk-1.0.Atk.Relation
|
|
|
|
/**
|
|
* Adds the specified AtkObject to the target for the relation, if it is
|
|
* not already present. See also atk_object_add_relationship().
|
|
* @param target an #AtkObject
|
|
*/
|
|
add_target(target: Object): void
|
|
/**
|
|
* Gets the type of `relation`
|
|
* @returns the type of @relation
|
|
*/
|
|
get_relation_type(): RelationType
|
|
/**
|
|
* Gets the target list of `relation`
|
|
* @returns the target list of @relation
|
|
*/
|
|
get_target(): Object[]
|
|
/**
|
|
* Remove the specified AtkObject from the target for the relation.
|
|
* @param target an #AtkObject
|
|
* @returns TRUE if the removal is successful.
|
|
*/
|
|
remove_target(target: Object): boolean
|
|
|
|
// Class property signals of Atk-1.0.Atk.Relation
|
|
|
|
connect(sigName: "notify::relation-type", callback: (($obj: Relation, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::relation-type", callback: (($obj: Relation, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::relation-type", ...args: any[]): void
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* An object used to describe a relation between a
|
|
* object and one or more other objects.
|
|
*
|
|
* An AtkRelation describes a relation between an object and one or
|
|
* more other objects. The actual relations that an object has with
|
|
* other objects are defined as an AtkRelationSet, which is a set of
|
|
* AtkRelations.
|
|
* @class
|
|
*/
|
|
export class Relation extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Relation
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Relation>
|
|
|
|
// Constructors of Atk-1.0.Atk.Relation
|
|
|
|
constructor(config?: Relation.ConstructorProperties)
|
|
/**
|
|
* Create a new relation for the specified key and the specified list
|
|
* of targets. See also atk_object_add_relationship().
|
|
* @constructor
|
|
* @param targets an array of pointers to #AtkObjects
|
|
* @param relationship an #AtkRelationType with which to create the new #AtkRelation
|
|
* @returns a pointer to a new #AtkRelation
|
|
*/
|
|
constructor(targets: Object[], relationship: RelationType)
|
|
/**
|
|
* Create a new relation for the specified key and the specified list
|
|
* of targets. See also atk_object_add_relationship().
|
|
* @constructor
|
|
* @param targets an array of pointers to #AtkObjects
|
|
* @param relationship an #AtkRelationType with which to create the new #AtkRelation
|
|
* @returns a pointer to a new #AtkRelation
|
|
*/
|
|
static new(targets: Object[], relationship: RelationType): Relation
|
|
_init(config?: Relation.ConstructorProperties): void
|
|
}
|
|
|
|
export module RelationSet {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface RelationSet {
|
|
|
|
// Own fields of Atk-1.0.Atk.RelationSet
|
|
|
|
parent: GObject.Object
|
|
relations: any[]
|
|
|
|
// Owm methods of Atk-1.0.Atk.RelationSet
|
|
|
|
/**
|
|
* Add a new relation to the current relation set if it is not already
|
|
* present.
|
|
* This function ref's the AtkRelation so the caller of this function
|
|
* should unref it to ensure that it will be destroyed when the AtkRelationSet
|
|
* is destroyed.
|
|
* @param relation an #AtkRelation
|
|
*/
|
|
add(relation: Relation): void
|
|
/**
|
|
* Add a new relation of the specified type with the specified target to
|
|
* the current relation set if the relation set does not contain a relation
|
|
* of that type. If it is does contain a relation of that typea the target
|
|
* is added to the relation.
|
|
* @param relationship an #AtkRelationType
|
|
* @param target an #AtkObject
|
|
*/
|
|
add_relation_by_type(relationship: RelationType, target: Object): void
|
|
/**
|
|
* Determines whether the relation set contains a relation that matches the
|
|
* specified type.
|
|
* @param relationship an #AtkRelationType
|
|
* @returns %TRUE if @relationship is the relationship type of a relation in @set, %FALSE otherwise
|
|
*/
|
|
contains(relationship: RelationType): boolean
|
|
/**
|
|
* Determines whether the relation set contains a relation that
|
|
* matches the specified pair formed by type `relationship` and object
|
|
* `target`.
|
|
* @param relationship an #AtkRelationType
|
|
* @param target an #AtkObject
|
|
* @returns %TRUE if @set contains a relation with the relationship type @relationship with an object @target, %FALSE otherwise
|
|
*/
|
|
contains_target(relationship: RelationType, target: Object): boolean
|
|
/**
|
|
* Determines the number of relations in a relation set.
|
|
* @returns an integer representing the number of relations in the set.
|
|
*/
|
|
get_n_relations(): number
|
|
/**
|
|
* Determines the relation at the specified position in the relation set.
|
|
* @param i a gint representing a position in the set, starting from 0.
|
|
* @returns a #AtkRelation, which is the relation at position i in the set.
|
|
*/
|
|
get_relation(i: number): Relation
|
|
/**
|
|
* Finds a relation that matches the specified type.
|
|
* @param relationship an #AtkRelationType
|
|
* @returns an #AtkRelation, which is a relation matching the specified type.
|
|
*/
|
|
get_relation_by_type(relationship: RelationType): Relation
|
|
/**
|
|
* Removes a relation from the relation set.
|
|
* This function unref's the #AtkRelation so it will be deleted unless there
|
|
* is another reference to it.
|
|
* @param relation an #AtkRelation
|
|
*/
|
|
remove(relation: Relation): void
|
|
|
|
// Class property signals of Atk-1.0.Atk.RelationSet
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* A set of AtkRelations, normally the set of
|
|
* AtkRelations which an AtkObject has.
|
|
*
|
|
* The AtkRelationSet held by an object establishes its relationships
|
|
* with objects beyond the normal "parent/child" hierarchical
|
|
* relationships that all user interface objects have.
|
|
* AtkRelationSets establish whether objects are labelled or
|
|
* controlled by other components, share group membership with other
|
|
* components (for instance within a radio-button group), or share
|
|
* content which "flows" between them, among other types of possible
|
|
* relationships.
|
|
* @class
|
|
*/
|
|
export class RelationSet extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.RelationSet
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<RelationSet>
|
|
|
|
// Constructors of Atk-1.0.Atk.RelationSet
|
|
|
|
constructor(config?: RelationSet.ConstructorProperties)
|
|
/**
|
|
* Creates a new empty relation set.
|
|
* @constructor
|
|
* @returns a new #AtkRelationSet
|
|
*/
|
|
constructor()
|
|
/**
|
|
* Creates a new empty relation set.
|
|
* @constructor
|
|
* @returns a new #AtkRelationSet
|
|
*/
|
|
static new(): RelationSet
|
|
_init(config?: RelationSet.ConstructorProperties): void
|
|
}
|
|
|
|
export module Socket {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends Component.ConstructorProperties, Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface Socket extends Component {
|
|
|
|
// Own fields of Atk-1.0.Atk.Socket
|
|
|
|
parent: Object & GObject.Object
|
|
|
|
// Owm methods of Atk-1.0.Atk.Socket
|
|
|
|
/**
|
|
* Embeds the children of an #AtkPlug as the children of the
|
|
* #AtkSocket. The plug may be in the same process or in a different
|
|
* process.
|
|
*
|
|
* The class item used by this function should be filled in by the IPC
|
|
* layer (usually at-spi2-atk). The implementor of the AtkSocket
|
|
* should call this function and pass the id for the plug as returned
|
|
* by atk_plug_get_id(). It is the responsibility of the application
|
|
* to pass the plug id on to the process implementing the #AtkSocket
|
|
* as needed.
|
|
* @param plug_id the ID of an #AtkPlug
|
|
*/
|
|
embed(plug_id: string | null): void
|
|
/**
|
|
* Determines whether or not the socket has an embedded plug.
|
|
* @returns TRUE if a plug is embedded in the socket
|
|
*/
|
|
is_occupied(): boolean
|
|
|
|
// Own virtual methods of Atk-1.0.Atk.Socket
|
|
|
|
/**
|
|
* Embeds the children of an #AtkPlug as the children of the
|
|
* #AtkSocket. The plug may be in the same process or in a different
|
|
* process.
|
|
*
|
|
* The class item used by this function should be filled in by the IPC
|
|
* layer (usually at-spi2-atk). The implementor of the AtkSocket
|
|
* should call this function and pass the id for the plug as returned
|
|
* by atk_plug_get_id(). It is the responsibility of the application
|
|
* to pass the plug id on to the process implementing the #AtkSocket
|
|
* as needed.
|
|
* @virtual
|
|
* @param plug_id the ID of an #AtkPlug
|
|
*/
|
|
vfunc_embed(plug_id: string | null): void
|
|
|
|
// Class property signals of Atk-1.0.Atk.Socket
|
|
|
|
connect(sigName: "notify::accessible-component-layer", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-component-layer", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-component-layer", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-component-mdi-zorder", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-component-mdi-zorder", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-component-mdi-zorder", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-description", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-description", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-hypertext-nlinks", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-hypertext-nlinks", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-hypertext-nlinks", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-name", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-name", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-name", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-role", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-role", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-role", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-caption", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-caption", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-caption", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-caption-object", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-caption-object", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-caption-object", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-column-description", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-column-description", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-column-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-column-header", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-column-header", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-column-header", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-row-description", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-row-description", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-row-description", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-row-header", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-row-header", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-row-header", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-table-summary", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-table-summary", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-table-summary", ...args: any[]): void
|
|
connect(sigName: "notify::accessible-value", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
connect_after(sigName: "notify::accessible-value", callback: (($obj: Socket, pspec: GObject.ParamSpec) => void)): number
|
|
emit(sigName: "notify::accessible-value", ...args: any[]): void
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* Container for AtkPlug objects from other processes
|
|
*
|
|
* Together with #AtkPlug, #AtkSocket provides the ability to embed
|
|
* accessibles from one process into another in a fashion that is
|
|
* transparent to assistive technologies. #AtkSocket works as the
|
|
* container of #AtkPlug, embedding it using the method
|
|
* atk_socket_embed(). Any accessible contained in the #AtkPlug will
|
|
* appear to the assistive technologies as being inside the
|
|
* application that created the #AtkSocket.
|
|
*
|
|
* The communication between a #AtkSocket and a #AtkPlug is done by
|
|
* the IPC layer of the accessibility framework, normally implemented
|
|
* by the D-Bus based implementation of AT-SPI (at-spi2). If that is
|
|
* the case, at-spi-atk2 is the responsible to implement the abstract
|
|
* methods atk_plug_get_id() and atk_socket_embed(), so an ATK
|
|
* implementor shouldn't reimplement them. The process that contains
|
|
* the #AtkPlug is responsible to send the ID returned by
|
|
* atk_plug_id() to the process that contains the #AtkSocket, so it
|
|
* could call the method atk_socket_embed() in order to embed it.
|
|
*
|
|
* For the same reasons, an implementor doesn't need to implement
|
|
* atk_object_get_n_accessible_children() and
|
|
* atk_object_ref_accessible_child(). All the logic related to those
|
|
* functions will be implemented by the IPC layer.
|
|
*
|
|
* See [class`AtkPlug]`
|
|
* @class
|
|
*/
|
|
export class Socket extends Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Socket
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Socket>
|
|
|
|
// Constructors of Atk-1.0.Atk.Socket
|
|
|
|
constructor(config?: Socket.ConstructorProperties)
|
|
/**
|
|
* Creates a new #AtkSocket.
|
|
* @constructor
|
|
* @returns the newly created #AtkSocket instance
|
|
*/
|
|
constructor()
|
|
/**
|
|
* Creates a new #AtkSocket.
|
|
* @constructor
|
|
* @returns the newly created #AtkSocket instance
|
|
*/
|
|
static new(): Socket
|
|
_init(config?: Socket.ConstructorProperties): void
|
|
}
|
|
|
|
export module StateSet {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface StateSet {
|
|
|
|
// Own fields of Atk-1.0.Atk.StateSet
|
|
|
|
parent: GObject.Object
|
|
|
|
// Owm methods of Atk-1.0.Atk.StateSet
|
|
|
|
/**
|
|
* Adds the state of the specified type to the state set if it is not already
|
|
* present.
|
|
*
|
|
* Note that because an #AtkStateSet is a read-only object, this method should
|
|
* be used to add a state to a newly-created set which will then be returned by
|
|
* #atk_object_ref_state_set. It should not be used to modify the existing state
|
|
* of an object. See also #atk_object_notify_state_change.
|
|
* @param type an #AtkStateType
|
|
* @returns %TRUE if the state for @type is not already in @set.
|
|
*/
|
|
add_state(type: StateType): boolean
|
|
/**
|
|
* Adds the states of the specified types to the state set.
|
|
*
|
|
* Note that because an #AtkStateSet is a read-only object, this method should
|
|
* be used to add states to a newly-created set which will then be returned by
|
|
* #atk_object_ref_state_set. It should not be used to modify the existing state
|
|
* of an object. See also #atk_object_notify_state_change.
|
|
* @param types an array of #AtkStateType
|
|
*/
|
|
add_states(types: StateType[]): void
|
|
/**
|
|
* Constructs the intersection of the two sets, returning %NULL if the
|
|
* intersection is empty.
|
|
* @param compare_set another #AtkStateSet
|
|
* @returns a new #AtkStateSet which is the intersection of the two sets.
|
|
*/
|
|
and_sets(compare_set: StateSet): StateSet
|
|
/**
|
|
* Removes all states from the state set.
|
|
*/
|
|
clear_states(): void
|
|
/**
|
|
* Checks whether the state for the specified type is in the specified set.
|
|
* @param type an #AtkStateType
|
|
* @returns %TRUE if @type is the state type is in @set.
|
|
*/
|
|
contains_state(type: StateType): boolean
|
|
/**
|
|
* Checks whether the states for all the specified types are in the
|
|
* specified set.
|
|
* @param types an array of #AtkStateType
|
|
* @returns %TRUE if all the states for @type are in @set.
|
|
*/
|
|
contains_states(types: StateType[]): boolean
|
|
/**
|
|
* Checks whether the state set is empty, i.e. has no states set.
|
|
* @returns %TRUE if @set has no states set, otherwise %FALSE
|
|
*/
|
|
is_empty(): boolean
|
|
/**
|
|
* Constructs the union of the two sets.
|
|
* @param compare_set another #AtkStateSet
|
|
* @returns a new #AtkStateSet which is the union of the two sets, returning %NULL is empty.
|
|
*/
|
|
or_sets(compare_set: StateSet): StateSet | null
|
|
/**
|
|
* Removes the state for the specified type from the state set.
|
|
*
|
|
* Note that because an #AtkStateSet is a read-only object, this method should
|
|
* be used to remove a state to a newly-created set which will then be returned
|
|
* by #atk_object_ref_state_set. It should not be used to modify the existing
|
|
* state of an object. See also #atk_object_notify_state_change.
|
|
* @param type an #AtkType
|
|
* @returns %TRUE if @type was the state type is in @set.
|
|
*/
|
|
remove_state(type: StateType): boolean
|
|
/**
|
|
* Constructs the exclusive-or of the two sets, returning %NULL is empty.
|
|
* The set returned by this operation contains the states in exactly
|
|
* one of the two sets.
|
|
* @param compare_set another #AtkStateSet
|
|
* @returns a new #AtkStateSet which contains the states which are in exactly one of the two sets.
|
|
*/
|
|
xor_sets(compare_set: StateSet): StateSet
|
|
|
|
// Class property signals of Atk-1.0.Atk.StateSet
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* An AtkStateSet contains the states of an object.
|
|
*
|
|
* An AtkStateSet is a read-only representation of the full set of #AtkStates
|
|
* that apply to an object at a given time. This set is not meant to be
|
|
* modified, but rather created when #atk_object_ref_state_set() is called.
|
|
* @class
|
|
*/
|
|
export class StateSet extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.StateSet
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<StateSet>
|
|
|
|
// Constructors of Atk-1.0.Atk.StateSet
|
|
|
|
constructor(config?: StateSet.ConstructorProperties)
|
|
/**
|
|
* Creates a new empty state set.
|
|
* @constructor
|
|
* @returns a new #AtkStateSet
|
|
*/
|
|
constructor()
|
|
/**
|
|
* Creates a new empty state set.
|
|
* @constructor
|
|
* @returns a new #AtkStateSet
|
|
*/
|
|
static new(): StateSet
|
|
_init(config?: StateSet.ConstructorProperties): void
|
|
}
|
|
|
|
export module Util {
|
|
|
|
// Constructor properties interface
|
|
|
|
export interface ConstructorProperties extends GObject.Object.ConstructorProperties {
|
|
}
|
|
|
|
}
|
|
|
|
export interface Util {
|
|
|
|
// Own fields of Atk-1.0.Atk.Util
|
|
|
|
parent: GObject.Object
|
|
|
|
// Class property signals of Atk-1.0.Atk.Util
|
|
|
|
connect(sigName: string, callback: (...args: any[]) => void): number
|
|
connect_after(sigName: string, callback: (...args: any[]) => void): number
|
|
emit(sigName: string, ...args: any[]): void
|
|
disconnect(id: number): void
|
|
}
|
|
|
|
/**
|
|
* A set of ATK utility functions for event and toolkit support.
|
|
*
|
|
* A set of ATK utility functions which are used to support event
|
|
* registration of various types, and obtaining the 'root' accessible
|
|
* of a process and information about the current ATK implementation
|
|
* and toolkit version.
|
|
* @class
|
|
*/
|
|
export class Util extends GObject.Object {
|
|
|
|
// Own properties of Atk-1.0.Atk.Util
|
|
|
|
static name: string
|
|
static $gtype: GObject.GType<Util>
|
|
|
|
// Constructors of Atk-1.0.Atk.Util
|
|
|
|
constructor(config?: Util.ConstructorProperties)
|
|
_init(config?: Util.ConstructorProperties): void
|
|
}
|
|
|
|
export interface ActionIface {
|
|
|
|
// Own fields of Atk-1.0.Atk.ActionIface
|
|
|
|
do_action: (action: Action, i: number) => boolean
|
|
get_n_actions: (action: Action) => number
|
|
get_description: (action: Action, i: number) => string | null
|
|
get_name: (action: Action, i: number) => string | null
|
|
get_keybinding: (action: Action, i: number) => string | null
|
|
set_description: (action: Action, i: number, desc: string | null) => boolean
|
|
get_localized_name: (action: Action, i: number) => string | null
|
|
}
|
|
|
|
/**
|
|
* The #AtkAction interface should be supported by any object that can
|
|
* perform one or more actions. The interface provides the standard
|
|
* mechanism for an assistive technology to determine what those actions
|
|
* are as well as tell the object to perform them. Any object that can
|
|
* be manipulated should support this interface.
|
|
* @record
|
|
*/
|
|
export abstract class ActionIface {
|
|
|
|
// Own properties of Atk-1.0.Atk.ActionIface
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface Attribute {
|
|
|
|
// Own fields of Atk-1.0.Atk.Attribute
|
|
|
|
/**
|
|
* The attribute name.
|
|
* @field
|
|
*/
|
|
name: string | null
|
|
/**
|
|
* the value of the attribute, represented as a string.
|
|
* @field
|
|
*/
|
|
value: string | null
|
|
}
|
|
|
|
/**
|
|
* AtkAttribute is a string name/value pair representing a generic
|
|
* attribute. This can be used to expose additional information from
|
|
* an accessible object as a whole (see atk_object_get_attributes())
|
|
* or an document (see atk_document_get_attributes()). In the case of
|
|
* text attributes (see atk_text_get_default_attributes()),
|
|
* #AtkTextAttribute enum defines all the possible text attribute
|
|
* names. You can use atk_text_attribute_get_name() to get the string
|
|
* name from the enum value. See also atk_text_attribute_for_name()
|
|
* and atk_text_attribute_get_value() for more information.
|
|
*
|
|
* A string name/value pair representing a generic attribute.
|
|
* @record
|
|
*/
|
|
export class Attribute {
|
|
|
|
// Own properties of Atk-1.0.Atk.Attribute
|
|
|
|
static name: string
|
|
|
|
// Constructors of Atk-1.0.Atk.Attribute
|
|
|
|
/**
|
|
* Frees the memory used by an #AtkAttributeSet, including all its
|
|
* #AtkAttributes.
|
|
* @param attrib_set The #AtkAttributeSet to free
|
|
*/
|
|
static set_free(attrib_set: AttributeSet): void
|
|
}
|
|
|
|
export interface ComponentIface {
|
|
|
|
// Own fields of Atk-1.0.Atk.ComponentIface
|
|
|
|
contains: (component: Component, x: number, y: number, coord_type: CoordType) => boolean
|
|
ref_accessible_at_point: (component: Component, x: number, y: number, coord_type: CoordType) => Object | null
|
|
get_extents: (component: Component, coord_type: CoordType) => [ /* x */ number, /* y */ number, /* width */ number, /* height */ number ]
|
|
get_position: (component: Component, coord_type: CoordType) => [ /* x */ number, /* y */ number ]
|
|
get_size: (component: Component) => [ /* width */ number, /* height */ number ]
|
|
grab_focus: (component: Component) => boolean
|
|
remove_focus_handler: (component: Component, handler_id: number) => void
|
|
set_extents: (component: Component, x: number, y: number, width: number, height: number, coord_type: CoordType) => boolean
|
|
set_position: (component: Component, x: number, y: number, coord_type: CoordType) => boolean
|
|
set_size: (component: Component, width: number, height: number) => boolean
|
|
get_layer: (component: Component) => Layer
|
|
get_mdi_zorder: (component: Component) => number
|
|
bounds_changed: (component: Component, bounds: Rectangle) => void
|
|
get_alpha: (component: Component) => number
|
|
scroll_to: (component: Component, type: ScrollType) => boolean
|
|
scroll_to_point: (component: Component, coords: CoordType, x: number, y: number) => boolean
|
|
}
|
|
|
|
/**
|
|
* The AtkComponent interface should be supported by any object that is
|
|
* rendered on the screen. The interface provides the standard mechanism
|
|
* for an assistive technology to determine and set the graphical
|
|
* representation of an object.
|
|
* @record
|
|
*/
|
|
export abstract class ComponentIface {
|
|
|
|
// Own properties of Atk-1.0.Atk.ComponentIface
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface DocumentIface {
|
|
|
|
// Own fields of Atk-1.0.Atk.DocumentIface
|
|
|
|
parent: GObject.TypeInterface
|
|
get_document_type: (document: Document) => string | null
|
|
get_document: (document: Document) => any | null
|
|
get_document_locale: (document: Document) => string | null
|
|
get_document_attributes: (document: Document) => AttributeSet
|
|
get_document_attribute_value: (document: Document, attribute_name: string | null) => string | null
|
|
set_document_attribute: (document: Document, attribute_name: string | null, attribute_value: string | null) => boolean
|
|
get_current_page_number: (document: Document) => number
|
|
get_page_count: (document: Document) => number
|
|
}
|
|
|
|
export abstract class DocumentIface {
|
|
|
|
// Own properties of Atk-1.0.Atk.DocumentIface
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface EditableTextIface {
|
|
|
|
// Own fields of Atk-1.0.Atk.EditableTextIface
|
|
|
|
parent_interface: GObject.TypeInterface
|
|
set_run_attributes: (text: EditableText, attrib_set: AttributeSet, start_offset: number, end_offset: number) => boolean
|
|
set_text_contents: (text: EditableText, string: string | null) => void
|
|
insert_text: (text: EditableText, string: string | null, length: number, position: number) => void
|
|
copy_text: (text: EditableText, start_pos: number, end_pos: number) => void
|
|
cut_text: (text: EditableText, start_pos: number, end_pos: number) => void
|
|
delete_text: (text: EditableText, start_pos: number, end_pos: number) => void
|
|
paste_text: (text: EditableText, position: number) => void
|
|
}
|
|
|
|
export abstract class EditableTextIface {
|
|
|
|
// Own properties of Atk-1.0.Atk.EditableTextIface
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface GObjectAccessibleClass {
|
|
|
|
// Own fields of Atk-1.0.Atk.GObjectAccessibleClass
|
|
|
|
parent_class: ObjectClass
|
|
pad1: Function
|
|
pad2: Function
|
|
}
|
|
|
|
export abstract class GObjectAccessibleClass {
|
|
|
|
// Own properties of Atk-1.0.Atk.GObjectAccessibleClass
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface HyperlinkClass {
|
|
|
|
// Own fields of Atk-1.0.Atk.HyperlinkClass
|
|
|
|
parent: GObject.ObjectClass
|
|
get_uri: (link_: Hyperlink, i: number) => string | null
|
|
get_object: (link_: Hyperlink, i: number) => Object
|
|
get_end_index: (link_: Hyperlink) => number
|
|
get_start_index: (link_: Hyperlink) => number
|
|
is_valid: (link_: Hyperlink) => boolean
|
|
get_n_anchors: (link_: Hyperlink) => number
|
|
link_state: (link_: Hyperlink) => number
|
|
is_selected_link: (link_: Hyperlink) => boolean
|
|
link_activated: (link_: Hyperlink) => void
|
|
pad1: Function
|
|
}
|
|
|
|
export abstract class HyperlinkClass {
|
|
|
|
// Own properties of Atk-1.0.Atk.HyperlinkClass
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface HyperlinkImplIface {
|
|
|
|
// Own fields of Atk-1.0.Atk.HyperlinkImplIface
|
|
|
|
parent: GObject.TypeInterface
|
|
get_hyperlink: (impl: HyperlinkImpl) => Hyperlink
|
|
}
|
|
|
|
export abstract class HyperlinkImplIface {
|
|
|
|
// Own properties of Atk-1.0.Atk.HyperlinkImplIface
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface HypertextIface {
|
|
|
|
// Own fields of Atk-1.0.Atk.HypertextIface
|
|
|
|
parent: GObject.TypeInterface
|
|
get_link: (hypertext: Hypertext, link_index: number) => Hyperlink
|
|
get_n_links: (hypertext: Hypertext) => number
|
|
get_link_index: (hypertext: Hypertext, char_index: number) => number
|
|
link_selected: (hypertext: Hypertext, link_index: number) => void
|
|
}
|
|
|
|
export abstract class HypertextIface {
|
|
|
|
// Own properties of Atk-1.0.Atk.HypertextIface
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface ImageIface {
|
|
|
|
// Own fields of Atk-1.0.Atk.ImageIface
|
|
|
|
parent: GObject.TypeInterface
|
|
get_image_position: (image: Image, coord_type: CoordType) => [ /* x */ number, /* y */ number ]
|
|
get_image_description: (image: Image) => string | null
|
|
get_image_size: (image: Image) => [ /* width */ number, /* height */ number ]
|
|
set_image_description: (image: Image, description: string | null) => boolean
|
|
get_image_locale: (image: Image) => string | null
|
|
}
|
|
|
|
export abstract class ImageIface {
|
|
|
|
// Own properties of Atk-1.0.Atk.ImageIface
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface Implementor {
|
|
|
|
// Owm methods of Atk-1.0.Atk.Implementor
|
|
|
|
/**
|
|
* Gets a reference to an object's #AtkObject implementation, if
|
|
* the object implements #AtkObjectIface
|
|
* @returns a reference to an object's #AtkObject implementation
|
|
*/
|
|
ref_accessible(): Object
|
|
}
|
|
|
|
export class Implementor {
|
|
|
|
// Own properties of Atk-1.0.Atk.Implementor
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface KeyEventStruct {
|
|
|
|
// Own fields of Atk-1.0.Atk.KeyEventStruct
|
|
|
|
/**
|
|
* An AtkKeyEventType, generally one of ATK_KEY_EVENT_PRESS or ATK_KEY_EVENT_RELEASE
|
|
* @field
|
|
*/
|
|
type: number
|
|
/**
|
|
* A bitmask representing the state of the modifier keys immediately after the event takes place.
|
|
* The meaning of the bits is currently defined to match the bitmask used by GDK in
|
|
* GdkEventType.state, see
|
|
* http://developer.gnome.org/doc/API/2.0/gdk/gdk-Event-Structures.html#GdkEventKey
|
|
* @field
|
|
*/
|
|
state: number
|
|
/**
|
|
* A guint representing a keysym value corresponding to those used by GDK and X11: see
|
|
* /usr/X11/include/keysymdef.h.
|
|
* @field
|
|
*/
|
|
keyval: number
|
|
/**
|
|
* The length of member #string.
|
|
* @field
|
|
*/
|
|
length: number
|
|
/**
|
|
* A string containing one of the following: either a string approximating the text that would
|
|
* result from this keypress, if the key is a control or graphic character, or a symbolic name for this keypress.
|
|
* Alphanumeric and printable keys will have the symbolic key name in this string member, for instance "A". "0",
|
|
* "semicolon", "aacute". Keypad keys have the prefix "KP".
|
|
* @field
|
|
*/
|
|
string: string | null
|
|
/**
|
|
* The raw hardware code that generated the key event. This field is raraly useful.
|
|
* @field
|
|
*/
|
|
keycode: number
|
|
/**
|
|
* A timestamp in milliseconds indicating when the event occurred.
|
|
* These timestamps are relative to a starting point which should be considered arbitrary,
|
|
* and only used to compare the dispatch times of events to one another.
|
|
* @field
|
|
*/
|
|
timestamp: number
|
|
}
|
|
|
|
/**
|
|
* Encapsulates information about a key event.
|
|
* @record
|
|
*/
|
|
export class KeyEventStruct {
|
|
|
|
// Own properties of Atk-1.0.Atk.KeyEventStruct
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface MiscClass {
|
|
|
|
// Own fields of Atk-1.0.Atk.MiscClass
|
|
|
|
parent: GObject.ObjectClass
|
|
threads_enter: (misc: Misc) => void
|
|
threads_leave: (misc: Misc) => void
|
|
vfuncs: any[]
|
|
}
|
|
|
|
/**
|
|
* Usage of AtkMisc is deprecated since 2.12 and heavily discouraged.
|
|
* @record
|
|
*/
|
|
export abstract class MiscClass {
|
|
|
|
// Own properties of Atk-1.0.Atk.MiscClass
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface NoOpObjectClass {
|
|
|
|
// Own fields of Atk-1.0.Atk.NoOpObjectClass
|
|
|
|
parent_class: ObjectClass
|
|
}
|
|
|
|
export abstract class NoOpObjectClass {
|
|
|
|
// Own properties of Atk-1.0.Atk.NoOpObjectClass
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface NoOpObjectFactoryClass {
|
|
|
|
// Own fields of Atk-1.0.Atk.NoOpObjectFactoryClass
|
|
|
|
parent_class: ObjectFactoryClass
|
|
}
|
|
|
|
export abstract class NoOpObjectFactoryClass {
|
|
|
|
// Own properties of Atk-1.0.Atk.NoOpObjectFactoryClass
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface ObjectClass {
|
|
|
|
// Own fields of Atk-1.0.Atk.ObjectClass
|
|
|
|
parent: GObject.ObjectClass
|
|
get_name: (accessible: Object) => string | null
|
|
get_description: (accessible: Object) => string | null
|
|
get_parent: (accessible: Object) => Object
|
|
get_n_children: (accessible: Object) => number
|
|
get_index_in_parent: (accessible: Object) => number
|
|
ref_relation_set: (accessible: Object) => RelationSet
|
|
get_role: (accessible: Object) => Role
|
|
get_layer: (accessible: Object) => Layer
|
|
get_mdi_zorder: (accessible: Object) => number
|
|
ref_state_set: (accessible: Object) => StateSet
|
|
set_name: (accessible: Object, name: string | null) => void
|
|
set_description: (accessible: Object, description: string | null) => void
|
|
set_parent: (accessible: Object, parent: Object) => void
|
|
set_role: (accessible: Object, role: Role) => void
|
|
remove_property_change_handler: (accessible: Object, handler_id: number) => void
|
|
initialize: (accessible: Object, data: any | null) => void
|
|
children_changed: (accessible: Object, change_index: number, changed_child: any | null) => void
|
|
focus_event: (accessible: Object, focus_in: boolean) => void
|
|
property_change: (accessible: Object, values: PropertyValues) => void
|
|
state_change: (accessible: Object, name: string | null, state_set: boolean) => void
|
|
visible_data_changed: (accessible: Object) => void
|
|
active_descendant_changed: (accessible: Object, child: any | null) => void
|
|
get_attributes: (accessible: Object) => AttributeSet
|
|
get_object_locale: (accessible: Object) => string | null
|
|
pad1: Function
|
|
}
|
|
|
|
export abstract class ObjectClass {
|
|
|
|
// Own properties of Atk-1.0.Atk.ObjectClass
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface ObjectFactoryClass {
|
|
|
|
// Own fields of Atk-1.0.Atk.ObjectFactoryClass
|
|
|
|
parent_class: GObject.ObjectClass
|
|
invalidate: (factory: ObjectFactory) => void
|
|
get_accessible_type: () => GObject.GType
|
|
pad1: Function
|
|
pad2: Function
|
|
}
|
|
|
|
export abstract class ObjectFactoryClass {
|
|
|
|
// Own properties of Atk-1.0.Atk.ObjectFactoryClass
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface PlugClass {
|
|
|
|
// Own fields of Atk-1.0.Atk.PlugClass
|
|
|
|
parent_class: ObjectClass
|
|
get_object_id: (obj: Plug) => string | null
|
|
}
|
|
|
|
export abstract class PlugClass {
|
|
|
|
// Own properties of Atk-1.0.Atk.PlugClass
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface PropertyValues {
|
|
|
|
// Own fields of Atk-1.0.Atk.PropertyValues
|
|
|
|
/**
|
|
* The name of the ATK property which has changed.
|
|
* @field
|
|
*/
|
|
property_name: string | null
|
|
/**
|
|
* NULL. This field is not used anymore.
|
|
* @field
|
|
*/
|
|
old_value: any
|
|
/**
|
|
* The new value of the named property.
|
|
* @field
|
|
*/
|
|
new_value: any
|
|
}
|
|
|
|
/**
|
|
* Note: `old_value` field of #AtkPropertyValues will not contain a
|
|
* valid value. This is a field defined with the purpose of contain
|
|
* the previous value of the property, but is not used anymore.
|
|
* @record
|
|
*/
|
|
export class PropertyValues {
|
|
|
|
// Own properties of Atk-1.0.Atk.PropertyValues
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface Range {
|
|
|
|
// Owm methods of Atk-1.0.Atk.Range
|
|
|
|
/**
|
|
* Returns a new #AtkRange that is a exact copy of `src`
|
|
* @returns a new #AtkRange copy of @src
|
|
*/
|
|
copy(): Range
|
|
/**
|
|
* Free `range`
|
|
*/
|
|
free(): void
|
|
/**
|
|
* Returns the human readable description of `range`
|
|
* @returns the human-readable description of @range
|
|
*/
|
|
get_description(): string | null
|
|
/**
|
|
* Returns the lower limit of `range`
|
|
* @returns the lower limit of @range
|
|
*/
|
|
get_lower_limit(): number
|
|
/**
|
|
* Returns the upper limit of `range`
|
|
* @returns the upper limit of @range
|
|
*/
|
|
get_upper_limit(): number
|
|
}
|
|
|
|
/**
|
|
* A given range or subrange, to be used with #AtkValue
|
|
*
|
|
* #AtkRange are used on #AtkValue, in order to represent the full
|
|
* range of a given component (for example an slider or a range
|
|
* control), or to define each individual subrange this full range is
|
|
* splitted if available. See #AtkValue documentation for further
|
|
* details.
|
|
* @record
|
|
*/
|
|
export class Range {
|
|
|
|
// Own properties of Atk-1.0.Atk.Range
|
|
|
|
static name: string
|
|
|
|
// Constructors of Atk-1.0.Atk.Range
|
|
|
|
/**
|
|
* Creates a new #AtkRange.
|
|
* @constructor
|
|
* @param lower_limit inferior limit for this range
|
|
* @param upper_limit superior limit for this range
|
|
* @param description human readable description of this range.
|
|
* @returns a new #AtkRange
|
|
*/
|
|
constructor(lower_limit: number, upper_limit: number, description: string | null)
|
|
/**
|
|
* Creates a new #AtkRange.
|
|
* @constructor
|
|
* @param lower_limit inferior limit for this range
|
|
* @param upper_limit superior limit for this range
|
|
* @param description human readable description of this range.
|
|
* @returns a new #AtkRange
|
|
*/
|
|
static new(lower_limit: number, upper_limit: number, description: string | null): Range
|
|
}
|
|
|
|
export interface Rectangle {
|
|
|
|
// Own fields of Atk-1.0.Atk.Rectangle
|
|
|
|
/**
|
|
* X coordinate of the left side of the rectangle.
|
|
* @field
|
|
*/
|
|
x: number
|
|
/**
|
|
* Y coordinate of the top side of the rectangle.
|
|
* @field
|
|
*/
|
|
y: number
|
|
/**
|
|
* width of the rectangle.
|
|
* @field
|
|
*/
|
|
width: number
|
|
/**
|
|
* height of the rectangle.
|
|
* @field
|
|
*/
|
|
height: number
|
|
}
|
|
|
|
/**
|
|
* A data structure for holding a rectangle. Those coordinates are
|
|
* relative to the component top-level parent.
|
|
* @record
|
|
*/
|
|
export class Rectangle {
|
|
|
|
// Own properties of Atk-1.0.Atk.Rectangle
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface RegistryClass {
|
|
|
|
// Own fields of Atk-1.0.Atk.RegistryClass
|
|
|
|
parent_class: GObject.ObjectClass
|
|
}
|
|
|
|
export abstract class RegistryClass {
|
|
|
|
// Own properties of Atk-1.0.Atk.RegistryClass
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface RelationClass {
|
|
|
|
// Own fields of Atk-1.0.Atk.RelationClass
|
|
|
|
parent: GObject.ObjectClass
|
|
}
|
|
|
|
export abstract class RelationClass {
|
|
|
|
// Own properties of Atk-1.0.Atk.RelationClass
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface RelationSetClass {
|
|
|
|
// Own fields of Atk-1.0.Atk.RelationSetClass
|
|
|
|
parent: GObject.ObjectClass
|
|
pad1: Function
|
|
pad2: Function
|
|
}
|
|
|
|
export abstract class RelationSetClass {
|
|
|
|
// Own properties of Atk-1.0.Atk.RelationSetClass
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface SelectionIface {
|
|
|
|
// Own fields of Atk-1.0.Atk.SelectionIface
|
|
|
|
parent: GObject.TypeInterface
|
|
add_selection: (selection: Selection, i: number) => boolean
|
|
clear_selection: (selection: Selection) => boolean
|
|
ref_selection: (selection: Selection, i: number) => Object | null
|
|
get_selection_count: (selection: Selection) => number
|
|
is_child_selected: (selection: Selection, i: number) => boolean
|
|
remove_selection: (selection: Selection, i: number) => boolean
|
|
select_all_selection: (selection: Selection) => boolean
|
|
selection_changed: (selection: Selection) => void
|
|
}
|
|
|
|
export abstract class SelectionIface {
|
|
|
|
// Own properties of Atk-1.0.Atk.SelectionIface
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface SocketClass {
|
|
|
|
// Own fields of Atk-1.0.Atk.SocketClass
|
|
|
|
parent_class: ObjectClass
|
|
embed: (obj: Socket, plug_id: string | null) => void
|
|
}
|
|
|
|
export abstract class SocketClass {
|
|
|
|
// Own properties of Atk-1.0.Atk.SocketClass
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface StateSetClass {
|
|
|
|
// Own fields of Atk-1.0.Atk.StateSetClass
|
|
|
|
parent: GObject.ObjectClass
|
|
}
|
|
|
|
export abstract class StateSetClass {
|
|
|
|
// Own properties of Atk-1.0.Atk.StateSetClass
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface StreamableContentIface {
|
|
|
|
// Own fields of Atk-1.0.Atk.StreamableContentIface
|
|
|
|
parent: GObject.TypeInterface
|
|
get_n_mime_types: (streamable: StreamableContent) => number
|
|
get_mime_type: (streamable: StreamableContent, i: number) => string | null
|
|
get_stream: (streamable: StreamableContent, mime_type: string | null) => GLib.IOChannel
|
|
get_uri: (streamable: StreamableContent, mime_type: string | null) => string | null
|
|
pad1: Function
|
|
pad2: Function
|
|
pad3: Function
|
|
}
|
|
|
|
export abstract class StreamableContentIface {
|
|
|
|
// Own properties of Atk-1.0.Atk.StreamableContentIface
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface TableCellIface {
|
|
|
|
// Own fields of Atk-1.0.Atk.TableCellIface
|
|
|
|
get_column_span: (cell: TableCell) => number
|
|
get_column_header_cells: (cell: TableCell) => Object[]
|
|
get_position: (cell: TableCell) => [ /* returnType */ boolean, /* row */ number, /* column */ number ]
|
|
get_row_span: (cell: TableCell) => number
|
|
get_row_header_cells: (cell: TableCell) => Object[]
|
|
get_row_column_span: (cell: TableCell) => [ /* returnType */ boolean, /* row */ number, /* column */ number, /* row_span */ number, /* column_span */ number ]
|
|
get_table: (cell: TableCell) => Object
|
|
}
|
|
|
|
/**
|
|
* AtkTableCell is an interface for cells inside an #AtkTable.
|
|
* @record
|
|
*/
|
|
export abstract class TableCellIface {
|
|
|
|
// Own properties of Atk-1.0.Atk.TableCellIface
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface TableIface {
|
|
|
|
// Own fields of Atk-1.0.Atk.TableIface
|
|
|
|
parent: GObject.TypeInterface
|
|
ref_at: (table: Table, row: number, column: number) => Object
|
|
get_index_at: (table: Table, row: number, column: number) => number
|
|
get_column_at_index: (table: Table, index_: number) => number
|
|
get_row_at_index: (table: Table, index_: number) => number
|
|
get_n_columns: (table: Table) => number
|
|
get_n_rows: (table: Table) => number
|
|
get_column_extent_at: (table: Table, row: number, column: number) => number
|
|
get_row_extent_at: (table: Table, row: number, column: number) => number
|
|
get_caption: (table: Table) => Object | null
|
|
get_column_description: (table: Table, column: number) => string | null
|
|
get_column_header: (table: Table, column: number) => Object | null
|
|
get_row_description: (table: Table, row: number) => string | null
|
|
get_row_header: (table: Table, row: number) => Object | null
|
|
get_summary: (table: Table) => Object
|
|
set_caption: (table: Table, caption: Object) => void
|
|
set_column_description: (table: Table, column: number, description: string | null) => void
|
|
set_column_header: (table: Table, column: number, header: Object) => void
|
|
set_row_description: (table: Table, row: number, description: string | null) => void
|
|
set_row_header: (table: Table, row: number, header: Object) => void
|
|
set_summary: (table: Table, accessible: Object) => void
|
|
get_selected_columns: (table: Table, selected: number) => number
|
|
get_selected_rows: (table: Table, selected: number) => number
|
|
is_column_selected: (table: Table, column: number) => boolean
|
|
is_row_selected: (table: Table, row: number) => boolean
|
|
is_selected: (table: Table, row: number, column: number) => boolean
|
|
add_row_selection: (table: Table, row: number) => boolean
|
|
remove_row_selection: (table: Table, row: number) => boolean
|
|
add_column_selection: (table: Table, column: number) => boolean
|
|
remove_column_selection: (table: Table, column: number) => boolean
|
|
row_inserted: (table: Table, row: number, num_inserted: number) => void
|
|
column_inserted: (table: Table, column: number, num_inserted: number) => void
|
|
row_deleted: (table: Table, row: number, num_deleted: number) => void
|
|
column_deleted: (table: Table, column: number, num_deleted: number) => void
|
|
row_reordered: (table: Table) => void
|
|
column_reordered: (table: Table) => void
|
|
model_changed: (table: Table) => void
|
|
}
|
|
|
|
export abstract class TableIface {
|
|
|
|
// Own properties of Atk-1.0.Atk.TableIface
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface TextIface {
|
|
|
|
// Own fields of Atk-1.0.Atk.TextIface
|
|
|
|
parent: GObject.TypeInterface
|
|
get_text: (text: Text, start_offset: number, end_offset: number) => string | null
|
|
get_text_after_offset: (text: Text, offset: number, boundary_type: TextBoundary) => [ /* returnType */ string | null, /* start_offset */ number, /* end_offset */ number ]
|
|
get_text_at_offset: (text: Text, offset: number, boundary_type: TextBoundary) => [ /* returnType */ string | null, /* start_offset */ number, /* end_offset */ number ]
|
|
get_character_at_offset: (text: Text, offset: number) => string
|
|
get_text_before_offset: (text: Text, offset: number, boundary_type: TextBoundary) => [ /* returnType */ string | null, /* start_offset */ number, /* end_offset */ number ]
|
|
get_caret_offset: (text: Text) => number
|
|
get_run_attributes: (text: Text, offset: number) => [ /* returnType */ AttributeSet, /* start_offset */ number, /* end_offset */ number ]
|
|
get_default_attributes: (text: Text) => AttributeSet
|
|
get_character_extents: (text: Text, offset: number, coords: CoordType) => [ /* x */ number, /* y */ number, /* width */ number, /* height */ number ]
|
|
get_character_count: (text: Text) => number
|
|
get_offset_at_point: (text: Text, x: number, y: number, coords: CoordType) => number
|
|
get_n_selections: (text: Text) => number
|
|
get_selection: (text: Text, selection_num: number) => [ /* returnType */ string | null, /* start_offset */ number, /* end_offset */ number ]
|
|
add_selection: (text: Text, start_offset: number, end_offset: number) => boolean
|
|
remove_selection: (text: Text, selection_num: number) => boolean
|
|
set_selection: (text: Text, selection_num: number, start_offset: number, end_offset: number) => boolean
|
|
set_caret_offset: (text: Text, offset: number) => boolean
|
|
text_changed: (text: Text, position: number, length: number) => void
|
|
text_caret_moved: (text: Text, location: number) => void
|
|
text_selection_changed: (text: Text) => void
|
|
text_attributes_changed: (text: Text) => void
|
|
get_range_extents: (text: Text, start_offset: number, end_offset: number, coord_type: CoordType) => /* rect */ TextRectangle
|
|
get_bounded_ranges: (text: Text, rect: TextRectangle, coord_type: CoordType, x_clip_type: TextClipType, y_clip_type: TextClipType) => TextRange[]
|
|
get_string_at_offset: (text: Text, offset: number, granularity: TextGranularity) => [ /* returnType */ string | null, /* start_offset */ number, /* end_offset */ number ]
|
|
scroll_substring_to: (text: Text, start_offset: number, end_offset: number, type: ScrollType) => boolean
|
|
scroll_substring_to_point: (text: Text, start_offset: number, end_offset: number, coords: CoordType, x: number, y: number) => boolean
|
|
}
|
|
|
|
export abstract class TextIface {
|
|
|
|
// Own properties of Atk-1.0.Atk.TextIface
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface TextRange {
|
|
|
|
// Own fields of Atk-1.0.Atk.TextRange
|
|
|
|
/**
|
|
* A rectangle giving the bounds of the text range
|
|
* @field
|
|
*/
|
|
bounds: TextRectangle
|
|
/**
|
|
* The start offset of a AtkTextRange
|
|
* @field
|
|
*/
|
|
start_offset: number
|
|
/**
|
|
* The end offset of a AtkTextRange
|
|
* @field
|
|
*/
|
|
end_offset: number
|
|
/**
|
|
* The text in the text range
|
|
* @field
|
|
*/
|
|
content: string | null
|
|
}
|
|
|
|
/**
|
|
* A structure used to describe a text range.
|
|
* @record
|
|
*/
|
|
export class TextRange {
|
|
|
|
// Own properties of Atk-1.0.Atk.TextRange
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface TextRectangle {
|
|
|
|
// Own fields of Atk-1.0.Atk.TextRectangle
|
|
|
|
/**
|
|
* The horizontal coordinate of a rectangle
|
|
* @field
|
|
*/
|
|
x: number
|
|
/**
|
|
* The vertical coordinate of a rectangle
|
|
* @field
|
|
*/
|
|
y: number
|
|
/**
|
|
* The width of a rectangle
|
|
* @field
|
|
*/
|
|
width: number
|
|
/**
|
|
* The height of a rectangle
|
|
* @field
|
|
*/
|
|
height: number
|
|
}
|
|
|
|
/**
|
|
* A structure used to store a rectangle used by AtkText.
|
|
* @record
|
|
*/
|
|
export class TextRectangle {
|
|
|
|
// Own properties of Atk-1.0.Atk.TextRectangle
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface UtilClass {
|
|
|
|
// Own fields of Atk-1.0.Atk.UtilClass
|
|
|
|
parent: GObject.ObjectClass
|
|
remove_global_event_listener: (listener_id: number) => void
|
|
remove_key_event_listener: (listener_id: number) => void
|
|
get_toolkit_name: () => string | null
|
|
get_toolkit_version: () => string | null
|
|
}
|
|
|
|
export abstract class UtilClass {
|
|
|
|
// Own properties of Atk-1.0.Atk.UtilClass
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface ValueIface {
|
|
|
|
// Own fields of Atk-1.0.Atk.ValueIface
|
|
|
|
parent: GObject.TypeInterface
|
|
get_current_value: (obj: Value) => /* value */ any
|
|
get_maximum_value: (obj: Value) => /* value */ any
|
|
get_minimum_value: (obj: Value) => /* value */ any
|
|
set_current_value: (obj: Value, value: any) => boolean
|
|
get_minimum_increment: (obj: Value) => /* value */ any
|
|
get_value_and_text: (obj: Value) => [ /* value */ number, /* text */ string | null ]
|
|
get_range: (obj: Value) => Range | null
|
|
get_increment: (obj: Value) => number
|
|
get_sub_ranges: (obj: Value) => Range[]
|
|
set_value: (obj: Value, new_value: number) => void
|
|
}
|
|
|
|
export abstract class ValueIface {
|
|
|
|
// Own properties of Atk-1.0.Atk.ValueIface
|
|
|
|
static name: string
|
|
}
|
|
|
|
export interface WindowIface {
|
|
|
|
// Own fields of Atk-1.0.Atk.WindowIface
|
|
|
|
parent: GObject.TypeInterface
|
|
}
|
|
|
|
export abstract class WindowIface {
|
|
|
|
// Own properties of Atk-1.0.Atk.WindowIface
|
|
|
|
static name: string
|
|
}
|
|
|
|
export type AttributeSet = GLib.SList
|
|
export type State = number
|
|
/**
|
|
* Name of the imported GIR library
|
|
* @see https://gitlab.gnome.org/GNOME/gjs/-/blob/master/gi/ns.cpp#L188
|
|
*/
|
|
export const __name__: string
|
|
/**
|
|
* Version of the imported GIR library
|
|
* @see https://gitlab.gnome.org/GNOME/gjs/-/blob/master/gi/ns.cpp#L189
|
|
*/
|
|
export const __version__: string
|
|
// END
|