1 /* 2 * This file is part of gtkD. 3 * 4 * gtkD is free software; you can redistribute it and/or modify 5 * it under the terms of the GNU Lesser General Public License 6 * as published by the Free Software Foundation; either version 3 7 * of the License, or (at your option) any later version, with 8 * some exceptions, please read the COPYING file. 9 * 10 * gtkD is distributed in the hope that it will be useful, 11 * but WITHOUT ANY WARRANTY; without even the implied warranty of 12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 13 * GNU Lesser General Public License for more details. 14 * 15 * You should have received a copy of the GNU Lesser General Public License 16 * along with gtkD; if not, write to the Free Software 17 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA 18 */ 19 20 // generated automatically - do not change 21 // find conversion definition on APILookup.txt 22 // implement new conversion functionalities on the wrap.utils pakage 23 24 25 module atk.c.types; 26 27 public import glib.c.types; 28 public import gobject.c.types; 29 30 31 /** 32 * This is a singly-linked list (a #GSList) of #AtkAttribute. It is 33 * used by atk_text_get_run_attributes(), 34 * atk_text_get_default_attributes(), 35 * atk_editable_text_set_run_attributes(), 36 * atk_document_get_attributes() and atk_object_get_attributes() 37 */ 38 public alias GSList AtkAttributeSet; 39 40 public alias ulong AtkState; 41 42 /** 43 * Specifies how xy coordinates are to be interpreted. Used by functions such 44 * as atk_component_get_position() and atk_text_get_character_extents() 45 */ 46 public enum AtkCoordType 47 { 48 /** 49 * specifies xy coordinates relative to the screen 50 */ 51 SCREEN = 0, 52 /** 53 * specifies xy coordinates relative to the widget's 54 * top-level window 55 */ 56 WINDOW = 1, 57 /** 58 * specifies xy coordinates relative to the widget's 59 * immediate parent. Since: 2.30 60 */ 61 PARENT = 2, 62 } 63 alias AtkCoordType CoordType; 64 65 /** 66 * Describes the type of link 67 */ 68 public enum AtkHyperlinkStateFlags 69 { 70 /** 71 * Link is inline 72 */ 73 INLINE = 1, 74 } 75 alias AtkHyperlinkStateFlags HyperlinkStateFlags; 76 77 /** 78 * Specifies the type of a keyboard evemt. 79 */ 80 public enum AtkKeyEventType 81 { 82 /** 83 * specifies a key press event 84 */ 85 PRESS = 0, 86 /** 87 * specifies a key release event 88 */ 89 RELEASE = 1, 90 /** 91 * Not a valid value; specifies end of enumeration 92 */ 93 LAST_DEFINED = 2, 94 } 95 alias AtkKeyEventType KeyEventType; 96 97 /** 98 * Describes the layer of a component 99 * 100 * These enumerated "layer values" are used when determining which UI 101 * rendering layer a component is drawn into, which can help in making 102 * determinations of when components occlude one another. 103 */ 104 public enum AtkLayer 105 { 106 /** 107 * The object does not have a layer 108 */ 109 INVALID = 0, 110 /** 111 * This layer is reserved for the desktop background 112 */ 113 BACKGROUND = 1, 114 /** 115 * This layer is used for Canvas components 116 */ 117 CANVAS = 2, 118 /** 119 * This layer is normally used for components 120 */ 121 WIDGET = 3, 122 /** 123 * This layer is used for layered components 124 */ 125 MDI = 4, 126 /** 127 * This layer is used for popup components, such as menus 128 */ 129 POPUP = 5, 130 /** 131 * This layer is reserved for future use. 132 */ 133 OVERLAY = 6, 134 /** 135 * This layer is used for toplevel windows. 136 */ 137 WINDOW = 7, 138 } 139 alias AtkLayer Layer; 140 141 /** 142 * Describes the type of the relation 143 */ 144 public enum AtkRelationType 145 { 146 /** 147 * Not used, represens "no relationship" or an error condition. 148 */ 149 NULL = 0, 150 /** 151 * Indicates an object controlled by one or more target objects. 152 */ 153 CONTROLLED_BY = 1, 154 /** 155 * Indicates an object is an controller for one or more target objects. 156 */ 157 CONTROLLER_FOR = 2, 158 /** 159 * Indicates an object is a label for one or more target objects. 160 */ 161 LABEL_FOR = 3, 162 /** 163 * Indicates an object is labelled by one or more target objects. 164 */ 165 LABELLED_BY = 4, 166 /** 167 * Indicates an object is a member of a group of one or more target objects. 168 */ 169 MEMBER_OF = 5, 170 /** 171 * 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. 172 */ 173 NODE_CHILD_OF = 6, 174 /** 175 * Indicates that the object has content that flows logically to another 176 * AtkObject in a sequential way, (for instance text-flow). 177 */ 178 FLOWS_TO = 7, 179 /** 180 * Indicates that the object has content that flows logically from 181 * another AtkObject in a sequential way, (for instance text-flow). 182 */ 183 FLOWS_FROM = 8, 184 /** 185 * Indicates a subwindow attached to a component but otherwise has no connection in the UI heirarchy to that component. 186 */ 187 SUBWINDOW_OF = 9, 188 /** 189 * Indicates that the object visually embeds 190 * another object's content, i.e. this object's content flows around 191 * another's content. 192 */ 193 EMBEDS = 10, 194 /** 195 * Reciprocal of %ATK_RELATION_EMBEDS, indicates that 196 * this object's content is visualy embedded in another object. 197 */ 198 EMBEDDED_BY = 11, 199 /** 200 * Indicates that an object is a popup for another object. 201 */ 202 POPUP_FOR = 12, 203 /** 204 * Indicates that an object is a parent window of another object. 205 */ 206 PARENT_WINDOW_OF = 13, 207 /** 208 * Reciprocal of %ATK_RELATION_DESCRIPTION_FOR. Indicates that one 209 * or more target objects provide descriptive information about this object. This relation 210 * type is most appropriate for information that is not essential as its presentation may 211 * be user-configurable and/or limited to an on-demand mechanism such as an assistive 212 * technology command. For brief, essential information such as can be found in a widget's 213 * on-screen label, use %ATK_RELATION_LABELLED_BY. For an on-screen error message, use 214 * %ATK_RELATION_ERROR_MESSAGE. For lengthy extended descriptive information contained in 215 * an on-screen object, consider using %ATK_RELATION_DETAILS as assistive technologies may 216 * provide a means for the user to navigate to objects containing detailed descriptions so 217 * that their content can be more closely reviewed. 218 */ 219 DESCRIBED_BY = 14, 220 /** 221 * Reciprocal of %ATK_RELATION_DESCRIBED_BY. Indicates that this 222 * object provides descriptive information about the target object(s). See also 223 * %ATK_RELATION_DETAILS_FOR and %ATK_RELATION_ERROR_FOR. 224 */ 225 DESCRIPTION_FOR = 15, 226 /** 227 * Indicates an object is a cell in a treetable and is expanded to display other cells in the same column. 228 */ 229 NODE_PARENT_OF = 16, 230 /** 231 * Reciprocal of %ATK_RELATION_DETAILS_FOR. Indicates that this object 232 * has a detailed or extended description, the contents of which can be found in the target 233 * object(s). This relation type is most appropriate for information that is sufficiently 234 * lengthy as to make navigation to the container of that information desirable. For less 235 * verbose information suitable for announcement only, see %ATK_RELATION_DESCRIBED_BY. If 236 * the detailed information describes an error condition, %ATK_RELATION_ERROR_FOR should be 237 * used instead. @Since: ATK-2.26. 238 */ 239 DETAILS = 17, 240 /** 241 * Reciprocal of %ATK_RELATION_DETAILS. Indicates that this object 242 * provides a detailed or extended description about the target object(s). See also 243 * %ATK_RELATION_DESCRIPTION_FOR and %ATK_RELATION_ERROR_FOR. @Since: ATK-2.26. 244 */ 245 DETAILS_FOR = 18, 246 /** 247 * Reciprocal of %ATK_RELATION_ERROR_FOR. Indicates that this object 248 * has one or more errors, the nature of which is described in the contents of the target 249 * object(s). Objects that have this relation type should also contain %ATK_STATE_INVALID_ENTRY 250 * in their #AtkStateSet. @Since: ATK-2.26. 251 */ 252 ERROR_MESSAGE = 19, 253 /** 254 * Reciprocal of %ATK_RELATION_ERROR_MESSAGE. Indicates that this object 255 * contains an error message describing an invalid condition in the target object(s). @Since: 256 * ATK_2.26. 257 */ 258 ERROR_FOR = 20, 259 /** 260 * Not used, this value indicates the end of the enumeration. 261 */ 262 LAST_DEFINED = 21, 263 } 264 alias AtkRelationType RelationType; 265 266 /** 267 * Describes the role of an object 268 * 269 * These are the built-in enumerated roles that UI components can have 270 * in ATK. Other roles may be added at runtime, so an AtkRole >= 271 * %ATK_ROLE_LAST_DEFINED is not necessarily an error. 272 */ 273 public enum AtkRole 274 { 275 /** 276 * Invalid role 277 */ 278 INVALID = 0, 279 /** 280 * A label which represents an accelerator 281 */ 282 ACCELERATOR_LABEL = 1, 283 /** 284 * 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. 285 */ 286 ALERT = 2, 287 /** 288 * An object which is an animated image 289 */ 290 ANIMATION = 3, 291 /** 292 * An arrow in one of the four cardinal directions 293 */ 294 ARROW = 4, 295 /** 296 * An object that displays a calendar and allows the user to select a date 297 */ 298 CALENDAR = 5, 299 /** 300 * An object that can be drawn into and is used to trap events 301 */ 302 CANVAS = 6, 303 /** 304 * A choice that can be checked or unchecked and provides a separate indicator for the current state 305 */ 306 CHECK_BOX = 7, 307 /** 308 * A menu item with a check box 309 */ 310 CHECK_MENU_ITEM = 8, 311 /** 312 * A specialized dialog that lets the user choose a color 313 */ 314 COLOR_CHOOSER = 9, 315 /** 316 * The header for a column of data 317 */ 318 COLUMN_HEADER = 10, 319 /** 320 * A collapsible list of choices the user can select from 321 */ 322 COMBO_BOX = 11, 323 /** 324 * An object whose purpose is to allow a user to edit a date 325 */ 326 DATE_EDITOR = 12, 327 /** 328 * An inconifed internal frame within a DESKTOP_PANE 329 */ 330 DESKTOP_ICON = 13, 331 /** 332 * A pane that supports internal frames and iconified versions of those internal frames 333 */ 334 DESKTOP_FRAME = 14, 335 /** 336 * An object whose purpose is to allow a user to set a value 337 */ 338 DIAL = 15, 339 /** 340 * A top level window with title bar and a border 341 */ 342 DIALOG = 16, 343 /** 344 * A pane that allows the user to navigate through and select the contents of a directory 345 */ 346 DIRECTORY_PANE = 17, 347 /** 348 * An object used for drawing custom user interface elements 349 */ 350 DRAWING_AREA = 18, 351 /** 352 * A specialized dialog that lets the user choose a file 353 */ 354 FILE_CHOOSER = 19, 355 /** 356 * A object that fills up space in a user interface 357 */ 358 FILLER = 20, 359 /** 360 * A specialized dialog that lets the user choose a font 361 */ 362 FONT_CHOOSER = 21, 363 /** 364 * A top level window with a title bar, border, menubar, etc. 365 */ 366 FRAME = 22, 367 /** 368 * A pane that is guaranteed to be painted on top of all panes beneath it 369 */ 370 GLASS_PANE = 23, 371 /** 372 * A document container for HTML, whose children represent the document content 373 */ 374 HTML_CONTAINER = 24, 375 /** 376 * A small fixed size picture, typically used to decorate components 377 */ 378 ICON = 25, 379 /** 380 * An object whose primary purpose is to display an image 381 */ 382 IMAGE = 26, 383 /** 384 * A frame-like object that is clipped by a desktop pane 385 */ 386 INTERNAL_FRAME = 27, 387 /** 388 * An object used to present an icon or short string in an interface 389 */ 390 LABEL = 28, 391 /** 392 * A specialized pane that allows its children to be drawn in layers, providing a form of stacking order 393 */ 394 LAYERED_PANE = 29, 395 /** 396 * An object that presents a list of objects to the user and allows the user to select one or more of them 397 */ 398 LIST = 30, 399 /** 400 * An object that represents an element of a list 401 */ 402 LIST_ITEM = 31, 403 /** 404 * An object usually found inside a menu bar that contains a list of actions the user can choose from 405 */ 406 MENU = 32, 407 /** 408 * 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 409 */ 410 MENU_BAR = 33, 411 /** 412 * An object usually contained in a menu that presents an action the user can choose 413 */ 414 MENU_ITEM = 34, 415 /** 416 * A specialized pane whose primary use is inside a DIALOG 417 */ 418 OPTION_PANE = 35, 419 /** 420 * An object that is a child of a page tab list 421 */ 422 PAGE_TAB = 36, 423 /** 424 * An object that presents a series of panels (or page tabs), one at a time, through some mechanism provided by the object 425 */ 426 PAGE_TAB_LIST = 37, 427 /** 428 * A generic container that is often used to group objects 429 */ 430 PANEL = 38, 431 /** 432 * A text object uses for passwords, or other places where the text content is not shown visibly to the user 433 */ 434 PASSWORD_TEXT = 39, 435 /** 436 * 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 437 */ 438 POPUP_MENU = 40, 439 /** 440 * An object used to indicate how much of a task has been completed 441 */ 442 PROGRESS_BAR = 41, 443 /** 444 * An object the user can manipulate to tell the application to do something 445 */ 446 PUSH_BUTTON = 42, 447 /** 448 * A specialized check box that will cause other radio buttons in the same group to become unchecked when this one is checked 449 */ 450 RADIO_BUTTON = 43, 451 /** 452 * A check menu item which belongs to a group. At each instant exactly one of the radio menu items from a group is selected 453 */ 454 RADIO_MENU_ITEM = 44, 455 /** 456 * A specialized pane that has a glass pane and a layered pane as its children 457 */ 458 ROOT_PANE = 45, 459 /** 460 * The header for a row of data 461 */ 462 ROW_HEADER = 46, 463 /** 464 * An object usually used to allow a user to incrementally view a large amount of data. 465 */ 466 SCROLL_BAR = 47, 467 /** 468 * An object that allows a user to incrementally view a large amount of information 469 */ 470 SCROLL_PANE = 48, 471 /** 472 * An object usually contained in a menu to provide a visible and logical separation of the contents in a menu 473 */ 474 SEPARATOR = 49, 475 /** 476 * An object that allows the user to select from a bounded range 477 */ 478 SLIDER = 50, 479 /** 480 * A specialized panel that presents two other panels at the same time 481 */ 482 SPLIT_PANE = 51, 483 /** 484 * An object used to get an integer or floating point number from the user 485 */ 486 SPIN_BUTTON = 52, 487 /** 488 * An object which reports messages of minor importance to the user 489 */ 490 STATUSBAR = 53, 491 /** 492 * An object used to represent information in terms of rows and columns 493 */ 494 TABLE = 54, 495 /** 496 * A cell in a table 497 */ 498 TABLE_CELL = 55, 499 /** 500 * The header for a column of a table 501 */ 502 TABLE_COLUMN_HEADER = 56, 503 /** 504 * The header for a row of a table 505 */ 506 TABLE_ROW_HEADER = 57, 507 /** 508 * A menu item used to tear off and reattach its menu 509 */ 510 TEAR_OFF_MENU_ITEM = 58, 511 /** 512 * An object that represents an accessible terminal. (Since: 0.6) 513 */ 514 TERMINAL = 59, 515 /** 516 * An interactive widget that supports multiple lines of text and 517 * optionally accepts user input, but whose purpose is not to solicit user input. 518 * Thus ATK_ROLE_TEXT is appropriate for the text view in a plain text editor 519 * but inappropriate for an input field in a dialog box or web form. For widgets 520 * whose purpose is to solicit input from the user, see ATK_ROLE_ENTRY and 521 * ATK_ROLE_PASSWORD_TEXT. For generic objects which display a brief amount of 522 * textual information, see ATK_ROLE_STATIC. 523 */ 524 TEXT = 60, 525 /** 526 * A specialized push button that can be checked or unchecked, but does not provide a separate indicator for the current state 527 */ 528 TOGGLE_BUTTON = 61, 529 /** 530 * A bar or palette usually composed of push buttons or toggle buttons 531 */ 532 TOOL_BAR = 62, 533 /** 534 * An object that provides information about another object 535 */ 536 TOOL_TIP = 63, 537 /** 538 * An object used to represent hierarchical information to the user 539 */ 540 TREE = 64, 541 /** 542 * An object capable of expanding and collapsing rows as well as showing multiple columns of data. (Since: 0.7) 543 */ 544 TREE_TABLE = 65, 545 /** 546 * The object contains some Accessible information, but its role is not known 547 */ 548 UNKNOWN = 66, 549 /** 550 * An object usually used in a scroll pane 551 */ 552 VIEWPORT = 67, 553 /** 554 * A top level window with no title or border. 555 */ 556 WINDOW = 68, 557 /** 558 * An object that serves as a document header. (Since: 1.1.1) 559 */ 560 HEADER = 69, 561 /** 562 * An object that serves as a document footer. (Since: 1.1.1) 563 */ 564 FOOTER = 70, 565 /** 566 * An object which is contains a paragraph of text content. (Since: 1.1.1) 567 */ 568 PARAGRAPH = 71, 569 /** 570 * 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) 571 */ 572 RULER = 72, 573 /** 574 * 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) 575 */ 576 APPLICATION = 73, 577 /** 578 * 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) 579 */ 580 AUTOCOMPLETE = 74, 581 /** 582 * The object is an editable text object in a toolbar. (Since: 1.5) 583 */ 584 EDIT_BAR = 75, 585 /** 586 * 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) 587 */ 588 EMBEDDED = 76, 589 /** 590 * 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) 591 */ 592 ENTRY = 77, 593 /** 594 * 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) 595 */ 596 CHART = 78, 597 /** 598 * The object contains descriptive information, usually textual, about another user interface element such as a table, chart, or image. (Since: 1.11) 599 */ 600 CAPTION = 79, 601 /** 602 * 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) 603 */ 604 DOCUMENT_FRAME = 80, 605 /** 606 * 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. 607 */ 608 HEADING = 81, 609 /** 610 * 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) 611 */ 612 PAGE = 82, 613 /** 614 * 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) 615 */ 616 SECTION = 83, 617 /** 618 * 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) 619 */ 620 REDUNDANT_OBJECT = 84, 621 /** 622 * The object is a container for form controls, for instance as part of a 623 * web form or user-input form within a document. This role is primarily a tag/convenience for 624 * clients when navigating complex documents, it is not expected that ordinary GUI containers will 625 * always have ATK_ROLE_FORM. (Since: 1.12.0) 626 */ 627 FORM = 85, 628 /** 629 * The object is a hypertext anchor, i.e. a "link" in a 630 * hypertext document. Such objects are distinct from 'inline' 631 * content which may also use the Hypertext/Hyperlink interfaces 632 * to indicate the range/location within a text object where 633 * an inline or embedded object lies. (Since: 1.12.1) 634 */ 635 LINK = 86, 636 /** 637 * The object is a window or similar viewport 638 * which is used to allow composition or input of a 'complex character', 639 * in other words it is an "input method window." (Since: 1.12.1) 640 */ 641 INPUT_METHOD_WINDOW = 87, 642 /** 643 * A row in a table. (Since: 2.1.0) 644 */ 645 TABLE_ROW = 88, 646 /** 647 * An object that represents an element of a tree. (Since: 2.1.0) 648 */ 649 TREE_ITEM = 89, 650 /** 651 * A document frame which contains a spreadsheet. (Since: 2.1.0) 652 */ 653 DOCUMENT_SPREADSHEET = 90, 654 /** 655 * A document frame which contains a presentation or slide content. (Since: 2.1.0) 656 */ 657 DOCUMENT_PRESENTATION = 91, 658 /** 659 * A document frame which contains textual content, such as found in a word processing application. (Since: 2.1.0) 660 */ 661 DOCUMENT_TEXT = 92, 662 /** 663 * A document frame which contains HTML or other markup suitable for display in a web browser. (Since: 2.1.0) 664 */ 665 DOCUMENT_WEB = 93, 666 /** 667 * A document frame which contains email content to be displayed or composed either in plain text or HTML. (Since: 2.1.0) 668 */ 669 DOCUMENT_EMAIL = 94, 670 /** 671 * 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) 672 */ 673 COMMENT = 95, 674 /** 675 * A non-collapsible list of choices the user can select from. (Since: 2.1.0) 676 */ 677 LIST_BOX = 96, 678 /** 679 * A group of related widgets. This group typically has a label. (Since: 2.1.0) 680 */ 681 GROUPING = 97, 682 /** 683 * 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) 684 */ 685 IMAGE_MAP = 98, 686 /** 687 * 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) 688 */ 689 NOTIFICATION = 99, 690 /** 691 * An object designed to present a message to the user within an existing window. (Since: 2.1.0) 692 */ 693 INFO_BAR = 100, 694 /** 695 * 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) 696 */ 697 LEVEL_BAR = 101, 698 /** 699 * A bar that serves as the title of a window or a 700 * dialog. (Since: 2.12) 701 */ 702 TITLE_BAR = 102, 703 /** 704 * An object which contains a text section 705 * that is quoted from another source. (Since: 2.12) 706 */ 707 BLOCK_QUOTE = 103, 708 /** 709 * An object which represents an audio element. (Since: 2.12) 710 */ 711 AUDIO = 104, 712 /** 713 * An object which represents a video element. (Since: 2.12) 714 */ 715 VIDEO = 105, 716 /** 717 * A definition of a term or concept. (Since: 2.12) 718 */ 719 DEFINITION = 106, 720 /** 721 * A section of a page that consists of a 722 * composition that forms an independent part of a document, page, or 723 * site. Examples: A blog entry, a news story, a forum post. (Since: 2.12) 724 */ 725 ARTICLE = 107, 726 /** 727 * A region of a web page intended as a 728 * navigational landmark. This is designed to allow Assistive 729 * Technologies to provide quick navigation among key regions within a 730 * document. (Since: 2.12) 731 */ 732 LANDMARK = 108, 733 /** 734 * A text widget or container holding log content, such 735 * as chat history and error logs. In this role there is a 736 * relationship between the arrival of new items in the log and the 737 * reading order. The log contains a meaningful sequence and new 738 * information is added only to the end of the log, not at arbitrary 739 * points. (Since: 2.12) 740 */ 741 LOG = 109, 742 /** 743 * A container where non-essential information 744 * changes frequently. Common usages of marquee include stock tickers 745 * and ad banners. The primary difference between a marquee and a log 746 * is that logs usually have a meaningful order or sequence of 747 * important content changes. (Since: 2.12) 748 */ 749 MARQUEE = 110, 750 /** 751 * A text widget or container that holds a mathematical 752 * expression. (Since: 2.12) 753 */ 754 MATH = 111, 755 /** 756 * A widget whose purpose is to display a rating, 757 * such as the number of stars associated with a song in a media 758 * player. Objects of this role should also implement 759 * AtkValue. (Since: 2.12) 760 */ 761 RATING = 112, 762 /** 763 * An object containing a numerical counter which 764 * indicates an amount of elapsed time from a start point, or the time 765 * remaining until an end point. (Since: 2.12) 766 */ 767 TIMER = 113, 768 /** 769 * An object that represents a list of 770 * term-value groups. A term-value group represents a individual 771 * description and consist of one or more names 772 * (ATK_ROLE_DESCRIPTION_TERM) followed by one or more values 773 * (ATK_ROLE_DESCRIPTION_VALUE). For each list, there should not be 774 * more than one group with the same term name. (Since: 2.12) 775 */ 776 DESCRIPTION_LIST = 114, 777 /** 778 * An object that represents a term or phrase 779 * with a corresponding definition. (Since: 2.12) 780 */ 781 DESCRIPTION_TERM = 115, 782 /** 783 * An object that represents the 784 * description, definition or value of a term. (Since: 2.12) 785 */ 786 DESCRIPTION_VALUE = 116, 787 /** 788 * A generic non-container object whose purpose is to display a 789 * brief amount of information to the user and whose role is known by the 790 * implementor but lacks semantic value for the user. Examples in which 791 * %ATK_ROLE_STATIC is appropriate include the message displayed in a message box 792 * and an image used as an alternative means to display text. %ATK_ROLE_STATIC 793 * should not be applied to widgets which are traditionally interactive, objects 794 * which display a significant amount of content, or any object which has an 795 * accessible relation pointing to another object. Implementors should expose the 796 * displayed information through the accessible name of the object. If doing so seems 797 * inappropriate, it may indicate that a different role should be used. For 798 * labels which describe another widget, see %ATK_ROLE_LABEL. For text views, see 799 * %ATK_ROLE_TEXT. For generic containers, see %ATK_ROLE_PANEL. For objects whose 800 * role is not known by the implementor, see %ATK_ROLE_UNKNOWN. (Since: 2.16) 801 */ 802 STATIC = 117, 803 /** 804 * An object that represents a mathematical fraction. 805 * (Since: 2.16) 806 */ 807 MATH_FRACTION = 118, 808 /** 809 * An object that represents a mathematical expression 810 * displayed with a radical. (Since: 2.16) 811 */ 812 MATH_ROOT = 119, 813 /** 814 * An object that contains text that is displayed as a 815 * subscript. (Since: 2.16) 816 */ 817 SUBSCRIPT = 120, 818 /** 819 * An object that contains text that is displayed as a 820 * superscript. (Since: 2.16) 821 */ 822 SUPERSCRIPT = 121, 823 /** 824 * An object that contains the text of a footnote. (Since: 2.26) 825 */ 826 FOOTNOTE = 122, 827 /** 828 * Content previously deleted or proposed to be 829 * deleted, e.g. in revision history or a content view providing suggestions 830 * from reviewers. (Since: 2.34) 831 */ 832 CONTENT_DELETION = 123, 833 /** 834 * Content previously inserted or proposed to be 835 * inserted, e.g. in revision history or a content view providing suggestions 836 * from reviewers. (Since: 2.34) 837 */ 838 CONTENT_INSERTION = 124, 839 /** 840 * A run of content that is marked or highlighted, such as for 841 * reference purposes, or to call it out as having a special purpose. If the 842 * marked content has an associated section in the document elaborating on the 843 * reason for the mark, then %ATK_RELATION_DETAILS should be used on the mark 844 * to point to that associated section. In addition, the reciprocal relation 845 * %ATK_RELATION_DETAILS_FOR should be used on the associated content section 846 * to point back to the mark. (Since: 2.36) 847 */ 848 MARK = 125, 849 /** 850 * A container for content that is called out as a proposed 851 * change from the current version of the document, such as by a reviewer of the 852 * content. This role should include either %ATK_ROLE_CONTENT_DELETION and/or 853 * %ATK_ROLE_CONTENT_INSERTION children, in any order, to indicate what the 854 * actual change is. (Since: 2.36) 855 */ 856 SUGGESTION = 126, 857 /** 858 * not a valid role, used for finding end of the enumeration 859 */ 860 LAST_DEFINED = 127, 861 } 862 alias AtkRole Role; 863 864 /** 865 * Specifies where an object should be placed on the screen when using scroll_to. 866 * 867 * Since: 2.30 868 */ 869 public enum AtkScrollType 870 { 871 /** 872 * Scroll the object vertically and horizontally to bring 873 * its top left corner to the top left corner of the window. 874 */ 875 TOP_LEFT = 0, 876 /** 877 * Scroll the object vertically and horizontally to 878 * bring its bottom right corner to the bottom right corner of the window. 879 */ 880 BOTTOM_RIGHT = 1, 881 /** 882 * Scroll the object vertically to bring its top edge to 883 * the top edge of the window. 884 */ 885 TOP_EDGE = 2, 886 /** 887 * Scroll the object vertically to bring its bottom 888 * edge to the bottom edge of the window. 889 */ 890 BOTTOM_EDGE = 3, 891 /** 892 * Scroll the object vertically and horizontally to bring 893 * its left edge to the left edge of the window. 894 */ 895 LEFT_EDGE = 4, 896 /** 897 * Scroll the object vertically and horizontally to 898 * bring its right edge to the right edge of the window. 899 */ 900 RIGHT_EDGE = 5, 901 /** 902 * Scroll the object vertically and horizontally so that 903 * as much as possible of the object becomes visible. The exact placement is 904 * determined by the application. 905 */ 906 ANYWHERE = 6, 907 } 908 alias AtkScrollType ScrollType; 909 910 /** 911 * The possible types of states of an object 912 */ 913 public enum AtkStateType 914 { 915 /** 916 * Indicates an invalid state - probably an error condition. 917 */ 918 INVALID = 0, 919 /** 920 * 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. 921 */ 922 ACTIVE = 1, 923 /** 924 * 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. 925 */ 926 ARMED = 2, 927 /** 928 * 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. 929 */ 930 BUSY = 3, 931 /** 932 * Indicates this object is currently checked, for instance a checkbox is 'non-empty'. 933 */ 934 CHECKED = 4, 935 /** 936 * Indicates that this object no longer has a valid backing widget (for instance, if its peer object has been destroyed) 937 */ 938 DEFUNCT = 5, 939 /** 940 * Indicates that this object can contain text, and that the 941 * user can change the textual contents of this object by editing those contents 942 * directly. For an object which is expected to be editable due to its type, but 943 * which cannot be edited due to the application or platform preventing the user 944 * from doing so, that object's #AtkStateSet should lack ATK_STATE_EDITABLE and 945 * should contain ATK_STATE_READ_ONLY. 946 */ 947 EDITABLE = 6, 948 /** 949 * 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 950 */ 951 ENABLED = 7, 952 /** 953 * Indicates this object allows progressive disclosure of its children 954 */ 955 EXPANDABLE = 8, 956 /** 957 * Indicates this object its expanded - see ATK_STATE_EXPANDABLE above 958 */ 959 EXPANDED = 9, 960 /** 961 * 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 962 */ 963 FOCUSABLE = 10, 964 /** 965 * Indicates this object currently has the keyboard focus 966 */ 967 FOCUSED = 11, 968 /** 969 * 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. 970 */ 971 HORIZONTAL = 12, 972 /** 973 * Indicates this object is minimized and is represented only by an icon 974 */ 975 ICONIFIED = 13, 976 /** 977 * Indicates something must be done with this object before the user can interact with an object in a different window 978 */ 979 MODAL = 14, 980 /** 981 * Indicates this (text) object can contain multiple lines of text 982 */ 983 MULTI_LINE = 15, 984 /** 985 * 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. 986 */ 987 MULTISELECTABLE = 16, 988 /** 989 * Indicates this object paints every pixel within its rectangular region. 990 */ 991 OPAQUE = 17, 992 /** 993 * Indicates this object is currently pressed. 994 */ 995 PRESSED = 18, 996 /** 997 * Indicates the size of this object is not fixed 998 */ 999 RESIZABLE = 19, 1000 /** 1001 * 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 1002 */ 1003 SELECTABLE = 20, 1004 /** 1005 * 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 1006 */ 1007 SELECTED = 21, 1008 /** 1009 * Indicates this object is sensitive, e.g. to user interaction. 1010 * STATE_SENSITIVE usually accompanies STATE_ENABLED for user-actionable controls, 1011 * but may be found in the absence of STATE_ENABLED if the current visible state of the 1012 * control is "disconnected" from the application state. In such cases, direct user interaction 1013 * can often result in the object gaining STATE_SENSITIVE, for instance if a user makes 1014 * an explicit selection using an object whose current state is ambiguous or undefined. 1015 * @see STATE_ENABLED, STATE_INDETERMINATE. 1016 */ 1017 SENSITIVE = 22, 1018 /** 1019 * Indicates this object, the object's parent, the object's parent's parent, and so on, 1020 * are all 'shown' to the end-user, i.e. subject to "exposure" if blocking or obscuring objects do not interpose 1021 * between this object and the top of the window stack. 1022 */ 1023 SHOWING = 23, 1024 /** 1025 * Indicates this (text) object can contain only a single line of text 1026 */ 1027 SINGLE_LINE = 24, 1028 /** 1029 * Indicates that the information returned for this object may no longer be 1030 * synchronized with the application state. This is implied if the object has STATE_TRANSIENT, 1031 * and can also occur towards the end of the object peer's lifecycle. It can also be used to indicate that 1032 * the index associated with this object has changed since the user accessed the object (in lieu of 1033 * "index-in-parent-changed" events). 1034 */ 1035 STALE = 25, 1036 /** 1037 * Indicates this object is transient, i.e. a snapshot which may not emit events when its 1038 * state changes. Data from objects with ATK_STATE_TRANSIENT should not be cached, since there may be no 1039 * notification given when the cached data becomes obsolete. 1040 */ 1041 TRANSIENT = 26, 1042 /** 1043 * Indicates the orientation of this object is vertical 1044 */ 1045 VERTICAL = 27, 1046 /** 1047 * Indicates this object is visible, e.g. has been explicitly marked for exposure to the user. 1048 * **note**: %ATK_STATE_VISIBLE is no guarantee that the object is actually unobscured on the screen, only 1049 * that it is 'potentially' visible, barring obstruction, being scrolled or clipped out of the 1050 * field of view, or having an ancestor container that has not yet made visible. 1051 * A widget is potentially onscreen if it has both %ATK_STATE_VISIBLE and %ATK_STATE_SHOWING. 1052 * The absence of %ATK_STATE_VISIBLE and %ATK_STATE_SHOWING is semantically equivalent to saying 1053 * that an object is 'hidden'. See also %ATK_STATE_TRUNCATED, which applies if an object with 1054 * %ATK_STATE_VISIBLE and %ATK_STATE_SHOWING set lies within a viewport which means that its 1055 * contents are clipped, e.g. a truncated spreadsheet cell or 1056 * an image within a scrolling viewport. Mostly useful for screen-review and magnification 1057 * algorithms. 1058 */ 1059 VISIBLE = 28, 1060 /** 1061 * Indicates that "active-descendant-changed" event 1062 * is sent when children become 'active' (i.e. are selected or navigated to onscreen). 1063 * Used to prevent need to enumerate all children in very large containers, like tables. 1064 * The presence of STATE_MANAGES_DESCENDANTS is an indication to the client. 1065 * that the children should not, and need not, be enumerated by the client. 1066 * Objects implementing this state are expected to provide relevant state 1067 * notifications to listening clients, for instance notifications of visibility 1068 * changes and activation of their contained child objects, without the client 1069 * having previously requested references to those children. 1070 */ 1071 MANAGES_DESCENDANTS = 29, 1072 /** 1073 * Indicates that the value, or some other quantifiable 1074 * property, of this AtkObject cannot be fully determined. In the case of a large 1075 * data set in which the total number of items in that set is unknown (e.g. 1 of 1076 * 999+), implementors should expose the currently-known set size (999) along 1077 * with this state. In the case of a check box, this state should be used to 1078 * indicate that the check box is a tri-state check box which is currently 1079 * neither checked nor unchecked. 1080 */ 1081 INDETERMINATE = 30, 1082 /** 1083 * Indicates that an object is truncated, e.g. a text value in a speradsheet cell. 1084 */ 1085 TRUNCATED = 31, 1086 /** 1087 * Indicates that explicit user interaction with an object is required by the user interface, e.g. a required field in a "web-form" interface. 1088 */ 1089 REQUIRED = 32, 1090 /** 1091 * 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. 1092 */ 1093 INVALID_ENTRY = 33, 1094 /** 1095 * Indicates that the object in question implements some form of ¨typeahead¨ or 1096 * pre-selection behavior whereby entering the first character of one or more sub-elements 1097 * causes those elements to scroll into view or become selected. Subsequent character input 1098 * may narrow the selection further as long as one or more sub-elements match the string. 1099 * This state is normally only useful and encountered on objects that implement Selection. 1100 * In some cases the typeahead behavior may result in full or partial ¨completion¨ of 1101 * the data in the input field, in which case these input events may trigger text-changed 1102 * events from the AtkText interface. This state supplants @ATK_ROLE_AUTOCOMPLETE. 1103 */ 1104 SUPPORTS_AUTOCOMPLETION = 34, 1105 /** 1106 * 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. 1107 */ 1108 SELECTABLE_TEXT = 35, 1109 /** 1110 * 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. 1111 */ 1112 DEFAULT = 36, 1113 /** 1114 * 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. 1115 * **note**: some applications, notably content viewers, may not be able to detect 1116 * all kinds of animated content. Therefore the absence of this state should not 1117 * be taken as definitive evidence that the object's visual representation is 1118 * static; this state is advisory. 1119 */ 1120 ANIMATED = 37, 1121 /** 1122 * Indicates that the object (typically a hyperlink) has already been 'activated', and/or its backing data has already been downloaded, rendered, or otherwise "visited". 1123 */ 1124 VISITED = 38, 1125 /** 1126 * Indicates this object has the potential to be 1127 * checked, such as a checkbox or toggle-able table cell. @Since: 1128 * ATK-2.12 1129 */ 1130 CHECKABLE = 39, 1131 /** 1132 * Indicates that the object has a popup context 1133 * menu or sub-level menu which may or may not be showing. This means 1134 * that activation renders conditional content. Note that ordinary 1135 * tooltips are not considered popups in this context. @Since: ATK-2.12 1136 */ 1137 HAS_POPUP = 40, 1138 /** 1139 * Indicates this object has a tooltip. @Since: ATK-2.16 1140 */ 1141 HAS_TOOLTIP = 41, 1142 /** 1143 * Indicates that a widget which is ENABLED and SENSITIVE 1144 * has a value which can be read, but not modified, by the user. Note that this 1145 * state should only be applied to widget types whose value is normally directly 1146 * user modifiable, such as check boxes, radio buttons, spin buttons, text input 1147 * fields, and combo boxes, as a means to convey that the expected interaction 1148 * with that widget is not possible. When the expected interaction with a 1149 * widget does not include modification by the user, as is the case with 1150 * labels and containers, ATK_STATE_READ_ONLY should not be applied. See also 1151 * ATK_STATE_EDITABLE. @Since: ATK-2-16 1152 */ 1153 READ_ONLY = 42, 1154 /** 1155 * Not a valid state, used for finding end of enumeration 1156 */ 1157 LAST_DEFINED = 43, 1158 } 1159 alias AtkStateType StateType; 1160 1161 /** 1162 * Describes the text attributes supported 1163 */ 1164 public enum AtkTextAttribute 1165 { 1166 /** 1167 * Invalid attribute, like bad spelling or grammar. 1168 */ 1169 INVALID = 0, 1170 /** 1171 * The pixel width of the left margin 1172 */ 1173 LEFT_MARGIN = 1, 1174 /** 1175 * The pixel width of the right margin 1176 */ 1177 RIGHT_MARGIN = 2, 1178 /** 1179 * The number of pixels that the text is indented 1180 */ 1181 INDENT = 3, 1182 /** 1183 * Either "true" or "false" indicating whether text is visible or not 1184 */ 1185 INVISIBLE = 4, 1186 /** 1187 * Either "true" or "false" indicating whether text is editable or not 1188 */ 1189 EDITABLE = 5, 1190 /** 1191 * Pixels of blank space to leave above each newline-terminated line. 1192 */ 1193 PIXELS_ABOVE_LINES = 6, 1194 /** 1195 * Pixels of blank space to leave below each newline-terminated line. 1196 */ 1197 PIXELS_BELOW_LINES = 7, 1198 /** 1199 * Pixels of blank space to leave between wrapped lines inside the same newline-terminated line (paragraph). 1200 */ 1201 PIXELS_INSIDE_WRAP = 8, 1202 /** 1203 * "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. 1204 */ 1205 BG_FULL_HEIGHT = 9, 1206 /** 1207 * Number of pixels that the characters are risen above the baseline. See also ATK_TEXT_ATTR_TEXT_POSITION. 1208 */ 1209 RISE = 10, 1210 /** 1211 * "none", "single", "double", "low", or "error" 1212 */ 1213 UNDERLINE = 11, 1214 /** 1215 * "true" or "false" whether the text is strikethrough 1216 */ 1217 STRIKETHROUGH = 12, 1218 /** 1219 * The size of the characters in points. eg: 10 1220 */ 1221 SIZE = 13, 1222 /** 1223 * The scale of the characters. The value is a string representation of a double 1224 */ 1225 SCALE = 14, 1226 /** 1227 * The weight of the characters. 1228 */ 1229 WEIGHT = 15, 1230 /** 1231 * The language used 1232 */ 1233 LANGUAGE = 16, 1234 /** 1235 * The font family name 1236 */ 1237 FAMILY_NAME = 17, 1238 /** 1239 * The background color. The value is an RGB value of the format "%u,%u,%u" 1240 */ 1241 BG_COLOR = 18, 1242 /** 1243 * The foreground color. The value is an RGB value of the format "%u,%u,%u" 1244 */ 1245 FG_COLOR = 19, 1246 /** 1247 * "true" if a #GdkBitmap is set for stippling the background color. 1248 */ 1249 BG_STIPPLE = 20, 1250 /** 1251 * "true" if a #GdkBitmap is set for stippling the foreground color. 1252 */ 1253 FG_STIPPLE = 21, 1254 /** 1255 * The wrap mode of the text, if any. Values are "none", "char", "word", or "word_char". 1256 */ 1257 WRAP_MODE = 22, 1258 /** 1259 * The direction of the text, if set. Values are "none", "ltr" or "rtl" 1260 */ 1261 DIRECTION = 23, 1262 /** 1263 * The justification of the text, if set. Values are "left", "right", "center" or "fill" 1264 */ 1265 JUSTIFICATION = 24, 1266 /** 1267 * 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" 1268 */ 1269 STRETCH = 25, 1270 /** 1271 * The capitalization variant of the text, if set. Values are "normal" or "small_caps" 1272 */ 1273 VARIANT = 26, 1274 /** 1275 * The slant style of the text, if set. Values are "normal", "oblique" or "italic" 1276 */ 1277 STYLE = 27, 1278 /** 1279 * 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. 1280 */ 1281 TEXT_POSITION = 28, 1282 /** 1283 * not a valid text attribute, used for finding end of enumeration 1284 */ 1285 LAST_DEFINED = 29, 1286 } 1287 alias AtkTextAttribute TextAttribute; 1288 1289 /** 1290 * Text boundary types used for specifying boundaries for regions of text. 1291 * This enumeration is deprecated since 2.9.4 and should not be used. Use 1292 * AtkTextGranularity with #atk_text_get_string_at_offset instead. 1293 */ 1294 public enum AtkTextBoundary 1295 { 1296 /** 1297 * Boundary is the boundary between characters 1298 * (including non-printing characters) 1299 */ 1300 CHAR = 0, 1301 /** 1302 * Boundary is the start (i.e. first character) of a word. 1303 */ 1304 WORD_START = 1, 1305 /** 1306 * Boundary is the end (i.e. last 1307 * character) of a word. 1308 */ 1309 WORD_END = 2, 1310 /** 1311 * Boundary is the first character in a sentence. 1312 */ 1313 SENTENCE_START = 3, 1314 /** 1315 * Boundary is the last (terminal) 1316 * character in a sentence; in languages which use "sentence stop" 1317 * punctuation such as English, the boundary is thus the '.', '?', or 1318 * similar terminal punctuation character. 1319 */ 1320 SENTENCE_END = 4, 1321 /** 1322 * Boundary is the initial character of the content or a 1323 * character immediately following a newline, linefeed, or return character. 1324 */ 1325 LINE_START = 5, 1326 /** 1327 * Boundary is the linefeed, or return 1328 * character. 1329 */ 1330 LINE_END = 6, 1331 } 1332 alias AtkTextBoundary TextBoundary; 1333 1334 /** 1335 * Describes the type of clipping required. 1336 */ 1337 public enum AtkTextClipType 1338 { 1339 /** 1340 * No clipping to be done 1341 */ 1342 NONE = 0, 1343 /** 1344 * Text clipped by min coordinate is omitted 1345 */ 1346 MIN = 1, 1347 /** 1348 * Text clipped by max coordinate is omitted 1349 */ 1350 MAX = 2, 1351 /** 1352 * Only text fully within mix/max bound is retained 1353 */ 1354 BOTH = 3, 1355 } 1356 alias AtkTextClipType TextClipType; 1357 1358 /** 1359 * Text granularity types used for specifying the granularity of the region of 1360 * text we are interested in. 1361 */ 1362 public enum AtkTextGranularity 1363 { 1364 /** 1365 * Granularity is defined by the boundaries between characters 1366 * (including non-printing characters) 1367 */ 1368 CHAR = 0, 1369 /** 1370 * Granularity is defined by the boundaries of a word, 1371 * starting at the beginning of the current word and finishing at the beginning of 1372 * the following one, if present. 1373 */ 1374 WORD = 1, 1375 /** 1376 * Granularity is defined by the boundaries of a sentence, 1377 * starting at the beginning of the current sentence and finishing at the beginning of 1378 * the following one, if present. 1379 */ 1380 SENTENCE = 2, 1381 /** 1382 * Granularity is defined by the boundaries of a line, 1383 * starting at the beginning of the current line and finishing at the beginning of 1384 * the following one, if present. 1385 */ 1386 LINE = 3, 1387 /** 1388 * Granularity is defined by the boundaries of a paragraph, 1389 * starting at the beginning of the current paragraph and finishing at the beginning of 1390 * the following one, if present. 1391 */ 1392 PARAGRAPH = 4, 1393 } 1394 alias AtkTextGranularity TextGranularity; 1395 1396 /** 1397 * Default types for a given value. Those are defined in order to 1398 * easily get localized strings to describe a given value or a given 1399 * subrange, using atk_value_type_get_localized_name(). 1400 */ 1401 public enum AtkValueType 1402 { 1403 VERY_WEAK = 0, 1404 WEAK = 1, 1405 ACCEPTABLE = 2, 1406 STRONG = 3, 1407 VERY_STRONG = 4, 1408 VERY_LOW = 5, 1409 LOW = 6, 1410 MEDIUM = 7, 1411 HIGH = 8, 1412 VERY_HIGH = 9, 1413 VERY_BAD = 10, 1414 BAD = 11, 1415 GOOD = 12, 1416 VERY_GOOD = 13, 1417 BEST = 14, 1418 LAST_DEFINED = 15, 1419 } 1420 alias AtkValueType ValueType; 1421 1422 struct AtkAction; 1423 1424 /** 1425 * The #AtkAction interface should be supported by any object that can 1426 * perform one or more actions. The interface provides the standard 1427 * mechanism for an assistive technology to determine what those actions 1428 * are as well as tell the object to perform them. Any object that can 1429 * be manipulated should support this interface. 1430 */ 1431 struct AtkActionIface 1432 { 1433 GTypeInterface parent; 1434 /** 1435 * 1436 * Params: 1437 * action = a #GObject instance that implements AtkActionIface 1438 * i = the action index corresponding to the action to be performed 1439 * Returns: %TRUE if success, %FALSE otherwise 1440 */ 1441 extern(C) int function(AtkAction* action, int i) doAction; 1442 /** 1443 * 1444 * Params: 1445 * action = a #GObject instance that implements AtkActionIface 1446 * Returns: a the number of actions, or 0 if @action does not 1447 * implement this interface. 1448 */ 1449 extern(C) int function(AtkAction* action) getNActions; 1450 /** 1451 * 1452 * Params: 1453 * action = a #GObject instance that implements AtkActionIface 1454 * i = the action index corresponding to the action to be performed 1455 * Returns: a description string, or %NULL if @action does 1456 * not implement this interface. 1457 */ 1458 extern(C) const(char)* function(AtkAction* action, int i) getDescription; 1459 /** 1460 * 1461 * Params: 1462 * action = a #GObject instance that implements AtkActionIface 1463 * i = the action index corresponding to the action to be performed 1464 * Returns: a name string, or %NULL if @action does not 1465 * implement this interface. 1466 */ 1467 extern(C) const(char)* function(AtkAction* action, int i) getName; 1468 /** 1469 * 1470 * Params: 1471 * action = a #GObject instance that implements AtkActionIface 1472 * i = the action index corresponding to the action to be performed 1473 * Returns: the keybinding which can be used to activate 1474 * this action, or %NULL if there is no keybinding for this action. 1475 */ 1476 extern(C) const(char)* function(AtkAction* action, int i) getKeybinding; 1477 /** 1478 * 1479 * Params: 1480 * action = a #GObject instance that implements AtkActionIface 1481 * i = the action index corresponding to the action to be performed 1482 * desc = the description to be assigned to this action 1483 * Returns: a gboolean representing if the description was successfully set; 1484 */ 1485 extern(C) int function(AtkAction* action, int i, const(char)* desc) setDescription; 1486 /** 1487 * 1488 * Params: 1489 * action = a #GObject instance that implements AtkActionIface 1490 * i = the action index corresponding to the action to be performed 1491 * Returns: a name string, or %NULL if @action does not 1492 * implement this interface. 1493 */ 1494 extern(C) const(char)* function(AtkAction* action, int i) getLocalizedName; 1495 } 1496 1497 struct AtkComponent; 1498 1499 /** 1500 * The AtkComponent interface should be supported by any object that is 1501 * rendered on the screen. The interface provides the standard mechanism 1502 * for an assistive technology to determine and set the graphical 1503 * representation of an object. 1504 */ 1505 struct AtkComponentIface 1506 { 1507 GTypeInterface parent; 1508 /** 1509 * 1510 * Params: 1511 * component = The #AtkComponent to attach the @handler to 1512 * handler = The #AtkFocusHandler to be attached to @component 1513 * Returns: a handler id which can be used in atk_component_remove_focus_handler() 1514 * or zero if the handler was already added. 1515 */ 1516 extern(C) uint function(AtkComponent* component, AtkFocusHandler handler) addFocusHandler; 1517 /** 1518 * 1519 * Params: 1520 * component = the #AtkComponent 1521 * x = x coordinate 1522 * y = y coordinate 1523 * coordType = specifies whether the coordinates are relative to the screen 1524 * or to the components top level window 1525 * Returns: %TRUE or %FALSE indicating whether the specified point is within 1526 * the extent of the @component or not 1527 */ 1528 extern(C) int function(AtkComponent* component, int x, int y, AtkCoordType coordType) contains; 1529 /** 1530 * 1531 * Params: 1532 * component = the #AtkComponent 1533 * x = x coordinate 1534 * y = y coordinate 1535 * coordType = specifies whether the coordinates are relative to the screen 1536 * or to the components top level window 1537 * Returns: a reference to the accessible 1538 * child, if one exists 1539 */ 1540 extern(C) AtkObject* function(AtkComponent* component, int x, int y, AtkCoordType coordType) refAccessibleAtPoint; 1541 /** */ 1542 extern(C) void function(AtkComponent* component, int* x, int* y, int* width, int* height, AtkCoordType coordType) getExtents; 1543 /** */ 1544 extern(C) void function(AtkComponent* component, int* x, int* y, AtkCoordType coordType) getPosition; 1545 /** */ 1546 extern(C) void function(AtkComponent* component, int* width, int* height) getSize; 1547 /** 1548 * 1549 * Params: 1550 * component = an #AtkComponent 1551 * Returns: %TRUE if successful, %FALSE otherwise. 1552 */ 1553 extern(C) int function(AtkComponent* component) grabFocus; 1554 /** */ 1555 extern(C) void function(AtkComponent* component, uint handlerId) removeFocusHandler; 1556 /** 1557 * 1558 * Params: 1559 * component = an #AtkComponent 1560 * x = x coordinate 1561 * y = y coordinate 1562 * width = width to set for @component 1563 * height = height to set for @component 1564 * coordType = specifies whether the coordinates are relative to the screen 1565 * or to the components top level window 1566 * Returns: %TRUE or %FALSE whether the extents were set or not 1567 */ 1568 extern(C) int function(AtkComponent* component, int x, int y, int width, int height, AtkCoordType coordType) setExtents; 1569 /** 1570 * 1571 * Params: 1572 * component = an #AtkComponent 1573 * x = x coordinate 1574 * y = y coordinate 1575 * coordType = specifies whether the coordinates are relative to the screen 1576 * or to the component's top level window 1577 * Returns: %TRUE or %FALSE whether or not the position was set or not 1578 */ 1579 extern(C) int function(AtkComponent* component, int x, int y, AtkCoordType coordType) setPosition; 1580 /** 1581 * 1582 * Params: 1583 * component = an #AtkComponent 1584 * width = width to set for @component 1585 * height = height to set for @component 1586 * Returns: %TRUE or %FALSE whether the size was set or not 1587 */ 1588 extern(C) int function(AtkComponent* component, int width, int height) setSize; 1589 /** 1590 * 1591 * Params: 1592 * component = an #AtkComponent 1593 * Returns: an #AtkLayer which is the layer of the component 1594 */ 1595 extern(C) AtkLayer function(AtkComponent* component) getLayer; 1596 /** 1597 * 1598 * Params: 1599 * component = an #AtkComponent 1600 * Returns: a gint which is the zorder of the component, i.e. the depth at 1601 * which the component is shown in relation to other components in the same 1602 * container. 1603 */ 1604 extern(C) int function(AtkComponent* component) getMdiZorder; 1605 /** */ 1606 extern(C) void function(AtkComponent* component, AtkRectangle* bounds) boundsChanged; 1607 /** 1608 * 1609 * Params: 1610 * component = an #AtkComponent 1611 * Returns: An alpha value from 0 to 1.0, inclusive. 1612 */ 1613 extern(C) double function(AtkComponent* component) getAlpha; 1614 /** 1615 * 1616 * Params: 1617 * component = an #AtkComponent 1618 * type = specify where the object should be made visible. 1619 * Returns: whether scrolling was successful. 1620 */ 1621 extern(C) int function(AtkComponent* component, AtkScrollType type) scrollTo; 1622 /** 1623 * 1624 * Params: 1625 * component = an #AtkComponent 1626 * coords = specify whether coordinates are relative to the screen or to the 1627 * parent object. 1628 * x = x-position where to scroll to 1629 * y = y-position where to scroll to 1630 * Returns: whether scrolling was successful. 1631 */ 1632 extern(C) int function(AtkComponent* component, AtkCoordType coords, int x, int y) scrollToPoint; 1633 } 1634 1635 struct AtkDocument; 1636 1637 struct AtkDocumentIface 1638 { 1639 GTypeInterface parent; 1640 /** 1641 * 1642 * Params: 1643 * document = a #GObject instance that implements AtkDocumentIface 1644 * Returns: a string indicating the document type 1645 */ 1646 extern(C) const(char)* function(AtkDocument* document) getDocumentType; 1647 /** 1648 * 1649 * Params: 1650 * document = a #GObject instance that implements AtkDocumentIface 1651 * Returns: a %gpointer that points to an instance of the DOM. 1652 */ 1653 extern(C) void* function(AtkDocument* document) getDocument; 1654 /** 1655 * 1656 * Params: 1657 * document = a #GObject instance that implements AtkDocumentIface 1658 * Returns: a UTF-8 string indicating the POSIX-style LC_MESSAGES 1659 * locale of the document content as a whole, or NULL if 1660 * the document content does not specify a locale. 1661 */ 1662 extern(C) const(char)* function(AtkDocument* document) getDocumentLocale; 1663 /** 1664 * 1665 * Params: 1666 * document = a #GObject instance that implements AtkDocumentIface 1667 * Returns: An AtkAttributeSet containing the explicitly 1668 * set name-value-pair attributes associated with this document 1669 * as a whole. 1670 */ 1671 extern(C) AtkAttributeSet* function(AtkDocument* document) getDocumentAttributes; 1672 /** 1673 * 1674 * Params: 1675 * document = a #GObject instance that implements AtkDocumentIface 1676 * attributeName = a character string representing the name of the attribute 1677 * whose value is being queried. 1678 * Returns: a string value associated with the named 1679 * attribute for this document, or %NULL if a value for 1680 * @attribute_name has not been specified for this document. 1681 */ 1682 extern(C) const(char)* function(AtkDocument* document, const(char)* attributeName) getDocumentAttributeValue; 1683 /** 1684 * 1685 * Params: 1686 * document = a #GObject instance that implements #AtkDocumentIface 1687 * attributeName = a character string representing the name of the attribute 1688 * whose value is being set. 1689 * attributeValue = a string value to be associated with @attribute_name. 1690 * Returns: %TRUE if @attribute_value is successfully associated 1691 * with @attribute_name for this @document, and %FALSE if if the 1692 * document does not allow the attribute to be modified 1693 */ 1694 extern(C) int function(AtkDocument* document, const(char)* attributeName, const(char)* attributeValue) setDocumentAttribute; 1695 /** 1696 * 1697 * Params: 1698 * document = the #AtkDocument 1699 * Returns: the current page number inside @document, or -1 if 1700 * not implemented, not know by the implementor, or irrelevant. 1701 */ 1702 extern(C) int function(AtkDocument* document) getCurrentPageNumber; 1703 /** 1704 * 1705 * Params: 1706 * document = the #AtkDocument 1707 * Returns: total page count of @document, or -1 if not implemented, 1708 * not know by the implementor or irrelevant. 1709 */ 1710 extern(C) int function(AtkDocument* document) getPageCount; 1711 } 1712 1713 struct AtkEditableText; 1714 1715 struct AtkEditableTextIface 1716 { 1717 GTypeInterface parentInterface; 1718 /** 1719 * 1720 * Params: 1721 * text = an #AtkEditableText 1722 * attribSet = an #AtkAttributeSet 1723 * startOffset = start of range in which to set attributes 1724 * endOffset = end of range in which to set attributes 1725 * Returns: %TRUE if attributes successfully set for the specified 1726 * range, otherwise %FALSE 1727 */ 1728 extern(C) int function(AtkEditableText* text, AtkAttributeSet* attribSet, int startOffset, int endOffset) setRunAttributes; 1729 /** */ 1730 extern(C) void function(AtkEditableText* text, const(char)* string_) setTextContents; 1731 /** */ 1732 extern(C) void function(AtkEditableText* text, const(char)* string_, int length, int* position) insertText; 1733 /** */ 1734 extern(C) void function(AtkEditableText* text, int startPos, int endPos) copyText; 1735 /** */ 1736 extern(C) void function(AtkEditableText* text, int startPos, int endPos) cutText; 1737 /** */ 1738 extern(C) void function(AtkEditableText* text, int startPos, int endPos) deleteText; 1739 /** */ 1740 extern(C) void function(AtkEditableText* text, int position) pasteText; 1741 } 1742 1743 struct AtkGObjectAccessible 1744 { 1745 AtkObject parent; 1746 } 1747 1748 struct AtkGObjectAccessibleClass 1749 { 1750 AtkObjectClass parentClass; 1751 AtkFunction pad1; 1752 AtkFunction pad2; 1753 } 1754 1755 struct AtkHyperlink 1756 { 1757 GObject parent; 1758 } 1759 1760 struct AtkHyperlinkClass 1761 { 1762 GObjectClass parent; 1763 /** 1764 * 1765 * Params: 1766 * link = an #AtkHyperlink 1767 * i = a (zero-index) integer specifying the desired anchor 1768 * Returns: a string specifying the URI 1769 */ 1770 extern(C) char* function(AtkHyperlink* link, int i) getUri; 1771 /** 1772 * 1773 * Params: 1774 * link = an #AtkHyperlink 1775 * i = a (zero-index) integer specifying the desired anchor 1776 * Returns: an #AtkObject associated with this hyperlinks 1777 * i-th anchor 1778 */ 1779 extern(C) AtkObject* function(AtkHyperlink* link, int i) getObject; 1780 /** 1781 * 1782 * Params: 1783 * link = an #AtkHyperlink 1784 * Returns: the index with the hypertext document at which this link ends 1785 */ 1786 extern(C) int function(AtkHyperlink* link) getEndIndex; 1787 /** 1788 * 1789 * Params: 1790 * link = an #AtkHyperlink 1791 * Returns: the index with the hypertext document at which this link begins 1792 */ 1793 extern(C) int function(AtkHyperlink* link) getStartIndex; 1794 /** 1795 * 1796 * Params: 1797 * link = an #AtkHyperlink 1798 * Returns: whether or not this link is still valid 1799 */ 1800 extern(C) int function(AtkHyperlink* link) isValid; 1801 /** 1802 * 1803 * Params: 1804 * link = an #AtkHyperlink 1805 * Returns: the number of anchors associated with this hyperlink 1806 */ 1807 extern(C) int function(AtkHyperlink* link) getNAnchors; 1808 /** */ 1809 extern(C) uint function(AtkHyperlink* link) linkState; 1810 /** 1811 * 1812 * Params: 1813 * link = an #AtkHyperlink 1814 * Returns: True if the AtkHyperlink is selected, False otherwise 1815 */ 1816 extern(C) int function(AtkHyperlink* link) isSelectedLink; 1817 /** */ 1818 extern(C) void function(AtkHyperlink* link) linkActivated; 1819 AtkFunction pad1; 1820 } 1821 1822 struct AtkHyperlinkImpl; 1823 1824 struct AtkHyperlinkImplIface 1825 { 1826 GTypeInterface parent; 1827 /** 1828 * 1829 * Params: 1830 * impl = a #GObject instance that implements AtkHyperlinkImplIface 1831 * Returns: an AtkHyperlink object which points to this 1832 * implementing AtkObject. 1833 */ 1834 extern(C) AtkHyperlink* function(AtkHyperlinkImpl* impl) getHyperlink; 1835 } 1836 1837 struct AtkHypertext; 1838 1839 struct AtkHypertextIface 1840 { 1841 GTypeInterface parent; 1842 /** 1843 * 1844 * Params: 1845 * hypertext = an #AtkHypertext 1846 * linkIndex = an integer specifying the desired link 1847 * Returns: the link in this hypertext document at 1848 * index @link_index 1849 */ 1850 extern(C) AtkHyperlink* function(AtkHypertext* hypertext, int linkIndex) getLink; 1851 /** 1852 * 1853 * Params: 1854 * hypertext = an #AtkHypertext 1855 * Returns: the number of links within this hypertext document 1856 */ 1857 extern(C) int function(AtkHypertext* hypertext) getNLinks; 1858 /** 1859 * 1860 * Params: 1861 * hypertext = an #AtkHypertext 1862 * charIndex = a character index 1863 * Returns: an index into the array of hyperlinks in @hypertext, 1864 * or -1 if there is no hyperlink associated with this character. 1865 */ 1866 extern(C) int function(AtkHypertext* hypertext, int charIndex) getLinkIndex; 1867 /** */ 1868 extern(C) void function(AtkHypertext* hypertext, int linkIndex) linkSelected; 1869 } 1870 1871 struct AtkImage; 1872 1873 struct AtkImageIface 1874 { 1875 GTypeInterface parent; 1876 /** */ 1877 extern(C) void function(AtkImage* image, int* x, int* y, AtkCoordType coordType) getImagePosition; 1878 /** 1879 * 1880 * Params: 1881 * image = a #GObject instance that implements AtkImageIface 1882 * Returns: a string representing the image description 1883 */ 1884 extern(C) const(char)* function(AtkImage* image) getImageDescription; 1885 /** */ 1886 extern(C) void function(AtkImage* image, int* width, int* height) getImageSize; 1887 /** 1888 * 1889 * Params: 1890 * image = a #GObject instance that implements AtkImageIface 1891 * description = a string description to set for @image 1892 * Returns: boolean TRUE, or FALSE if operation could 1893 * not be completed. 1894 */ 1895 extern(C) int function(AtkImage* image, const(char)* description) setImageDescription; 1896 /** 1897 * 1898 * Params: 1899 * image = An #AtkImage 1900 * Returns: a string corresponding to the POSIX 1901 * `LC_MESSAGES` locale used by the image description, or 1902 * %NULL if the image does not specify a locale. 1903 */ 1904 extern(C) const(char)* function(AtkImage* image) getImageLocale; 1905 } 1906 1907 struct AtkImplementor; 1908 1909 /** 1910 * Encapsulates information about a key event. 1911 */ 1912 struct AtkKeyEventStruct 1913 { 1914 /** 1915 * An AtkKeyEventType, generally one of ATK_KEY_EVENT_PRESS or ATK_KEY_EVENT_RELEASE 1916 */ 1917 int type; 1918 /** 1919 * A bitmask representing the state of the modifier keys immediately after the event takes place. 1920 * The meaning of the bits is currently defined to match the bitmask used by GDK in 1921 * GdkEventType.state, see 1922 * http://developer.gnome.org/doc/API/2.0/gdk/gdk-Event-Structures.html#GdkEventKey 1923 */ 1924 uint state; 1925 /** 1926 * A guint representing a keysym value corresponding to those used by GDK and X11: see 1927 * /usr/X11/include/keysymdef.h. 1928 */ 1929 uint keyval; 1930 /** 1931 * The length of member #string. 1932 */ 1933 int length; 1934 /** 1935 * A string containing one of the following: either a string approximating the text that would 1936 * result from this keypress, if the key is a control or graphic character, or a symbolic name for this keypress. 1937 * Alphanumeric and printable keys will have the symbolic key name in this string member, for instance "A". "0", 1938 * "semicolon", "aacute". Keypad keys have the prefix "KP". 1939 */ 1940 char* string_; 1941 /** 1942 * The raw hardware code that generated the key event. This field is raraly useful. 1943 */ 1944 ushort keycode; 1945 /** 1946 * A timestamp in milliseconds indicating when the event occurred. 1947 * These timestamps are relative to a starting point which should be considered arbitrary, 1948 * and only used to compare the dispatch times of events to one another. 1949 */ 1950 uint timestamp; 1951 } 1952 1953 struct AtkMisc 1954 { 1955 GObject parent; 1956 } 1957 1958 /** 1959 * Usage of AtkMisc is deprecated since 2.12 and heavily discouraged. 1960 */ 1961 struct AtkMiscClass 1962 { 1963 GObjectClass parent; 1964 /** */ 1965 extern(C) void function(AtkMisc* misc) threadsEnter; 1966 /** */ 1967 extern(C) void function(AtkMisc* misc) threadsLeave; 1968 void*[32] vfuncs; 1969 } 1970 1971 struct AtkNoOpObject 1972 { 1973 AtkObject parent; 1974 } 1975 1976 struct AtkNoOpObjectClass 1977 { 1978 AtkObjectClass parentClass; 1979 } 1980 1981 struct AtkNoOpObjectFactory 1982 { 1983 AtkObjectFactory parent; 1984 } 1985 1986 struct AtkNoOpObjectFactoryClass 1987 { 1988 AtkObjectFactoryClass parentClass; 1989 } 1990 1991 struct AtkObject 1992 { 1993 GObject parent; 1994 char* description; 1995 char* name; 1996 AtkObject* accessibleParent; 1997 AtkRole role; 1998 AtkRelationSet* relationSet; 1999 AtkLayer layer; 2000 } 2001 2002 struct AtkObjectClass 2003 { 2004 GObjectClass parent; 2005 /** 2006 * 2007 * Params: 2008 * accessible = an #AtkObject 2009 * Returns: a character string representing the accessible name of the object. 2010 */ 2011 extern(C) const(char)* function(AtkObject* accessible) getName; 2012 /** 2013 * 2014 * Params: 2015 * accessible = an #AtkObject 2016 * Returns: a character string representing the accessible description 2017 * of the accessible. 2018 */ 2019 extern(C) const(char)* function(AtkObject* accessible) getDescription; 2020 /** 2021 * 2022 * Params: 2023 * accessible = an #AtkObject 2024 * Returns: an #AtkObject representing the accessible 2025 * parent of the accessible 2026 */ 2027 extern(C) AtkObject* function(AtkObject* accessible) getParent; 2028 /** */ 2029 extern(C) int function(AtkObject* accessible) getNChildren; 2030 /** */ 2031 extern(C) AtkObject* function(AtkObject* accessible, int i) refChild; 2032 /** 2033 * 2034 * Params: 2035 * accessible = an #AtkObject 2036 * Returns: an integer which is the index of the accessible in its parent 2037 */ 2038 extern(C) int function(AtkObject* accessible) getIndexInParent; 2039 /** 2040 * 2041 * Params: 2042 * accessible = an #AtkObject 2043 * Returns: an #AtkRelationSet representing the relation set 2044 * of the object. 2045 */ 2046 extern(C) AtkRelationSet* function(AtkObject* accessible) refRelationSet; 2047 /** 2048 * 2049 * Params: 2050 * accessible = an #AtkObject 2051 * Returns: an #AtkRole which is the role of the accessible 2052 */ 2053 extern(C) AtkRole function(AtkObject* accessible) getRole; 2054 /** 2055 * 2056 * Params: 2057 * accessible = an #AtkObject 2058 * Returns: an #AtkLayer which is the layer of the accessible 2059 */ 2060 extern(C) AtkLayer function(AtkObject* accessible) getLayer; 2061 /** 2062 * 2063 * Params: 2064 * accessible = an #AtkObject 2065 * Returns: a gint which is the zorder of the accessible, i.e. the depth at 2066 * which the component is shown in relation to other components in the same 2067 * container. 2068 */ 2069 extern(C) int function(AtkObject* accessible) getMdiZorder; 2070 /** 2071 * 2072 * Params: 2073 * accessible = an #AtkObject 2074 * Returns: a reference to an #AtkStateSet which is the state 2075 * set of the accessible 2076 */ 2077 extern(C) AtkStateSet* function(AtkObject* accessible) refStateSet; 2078 /** */ 2079 extern(C) void function(AtkObject* accessible, const(char)* name) setName; 2080 /** */ 2081 extern(C) void function(AtkObject* accessible, const(char)* description) setDescription; 2082 /** */ 2083 extern(C) void function(AtkObject* accessible, AtkObject* parent) setParent; 2084 /** */ 2085 extern(C) void function(AtkObject* accessible, AtkRole role) setRole; 2086 /** 2087 * 2088 * Params: 2089 * accessible = an #AtkObject 2090 * handler = a function to be called when a property changes its value 2091 * Returns: a #guint which is the handler id used in 2092 * atk_object_remove_property_change_handler() 2093 */ 2094 extern(C) uint function(AtkObject* accessible, AtkPropertyChangeHandler* handler) connectPropertyChangeHandler; 2095 /** */ 2096 extern(C) void function(AtkObject* accessible, uint handlerId) removePropertyChangeHandler; 2097 /** */ 2098 extern(C) void function(AtkObject* accessible, void* data) initialize; 2099 /** */ 2100 extern(C) void function(AtkObject* accessible, uint changeIndex, void* changedChild) childrenChanged; 2101 /** */ 2102 extern(C) void function(AtkObject* accessible, int focusIn) focusEvent; 2103 /** */ 2104 extern(C) void function(AtkObject* accessible, AtkPropertyValues* values) propertyChange; 2105 /** */ 2106 extern(C) void function(AtkObject* accessible, const(char)* name, int stateSet) stateChange; 2107 /** */ 2108 extern(C) void function(AtkObject* accessible) visibleDataChanged; 2109 /** */ 2110 extern(C) void function(AtkObject* accessible, void** child) activeDescendantChanged; 2111 /** 2112 * 2113 * Params: 2114 * accessible = An #AtkObject. 2115 * Returns: an #AtkAttributeSet consisting of all 2116 * explicit properties/annotations applied to the object, or an empty 2117 * set if the object has no name-value pair attributes assigned to 2118 * it. This #atkattributeset should be freed by a call to 2119 * atk_attribute_set_free(). 2120 */ 2121 extern(C) AtkAttributeSet* function(AtkObject* accessible) getAttributes; 2122 /** 2123 * 2124 * Params: 2125 * accessible = an #AtkObject 2126 * Returns: a UTF-8 string indicating the POSIX-style LC_MESSAGES 2127 * locale of @accessible. 2128 */ 2129 extern(C) const(char)* function(AtkObject* accessible) getObjectLocale; 2130 AtkFunction pad1; 2131 } 2132 2133 struct AtkObjectFactory 2134 { 2135 GObject parent; 2136 } 2137 2138 struct AtkObjectFactoryClass 2139 { 2140 GObjectClass parentClass; 2141 /** */ 2142 extern(C) AtkObject* function(GObject* obj) createAccessible; 2143 /** */ 2144 extern(C) void function(AtkObjectFactory* factory) invalidate; 2145 /** */ 2146 extern(C) GType function() getAccessibleType; 2147 AtkFunction pad1; 2148 AtkFunction pad2; 2149 } 2150 2151 struct AtkPlug 2152 { 2153 AtkObject parent; 2154 } 2155 2156 struct AtkPlugClass 2157 { 2158 AtkObjectClass parentClass; 2159 /** */ 2160 extern(C) char* function(AtkPlug* obj) getObjectId; 2161 } 2162 2163 /** 2164 * Note: @old_value field of #AtkPropertyValues will not contain a 2165 * valid value. This is a field defined with the purpose of contain 2166 * the previous value of the property, but is not used anymore. 2167 */ 2168 struct AtkPropertyValues 2169 { 2170 /** 2171 * The name of the ATK property which has changed. 2172 */ 2173 const(char)* propertyName; 2174 /** 2175 * NULL. This field is not used anymore. 2176 */ 2177 GValue oldValue; 2178 /** 2179 * The new value of the named property. 2180 */ 2181 GValue newValue; 2182 } 2183 2184 struct AtkRange; 2185 2186 /** 2187 * A data structure for holding a rectangle. Those coordinates are 2188 * relative to the component top-level parent. 2189 */ 2190 struct AtkRectangle 2191 { 2192 /** 2193 * X coordinate of the left side of the rectangle. 2194 */ 2195 int x; 2196 /** 2197 * Y coordinate of the top side of the rectangle. 2198 */ 2199 int y; 2200 /** 2201 * width of the rectangle. 2202 */ 2203 int width; 2204 /** 2205 * height of the rectangle. 2206 */ 2207 int height; 2208 } 2209 2210 struct AtkRegistry 2211 { 2212 GObject parent; 2213 GHashTable* factoryTypeRegistry; 2214 GHashTable* factorySingletonCache; 2215 } 2216 2217 struct AtkRegistryClass 2218 { 2219 GObjectClass parentClass; 2220 } 2221 2222 struct AtkRelation 2223 { 2224 GObject parent; 2225 GPtrArray* target; 2226 AtkRelationType relationship; 2227 } 2228 2229 struct AtkRelationClass 2230 { 2231 GObjectClass parent; 2232 } 2233 2234 struct AtkRelationSet 2235 { 2236 GObject parent; 2237 GPtrArray* relations; 2238 } 2239 2240 struct AtkRelationSetClass 2241 { 2242 GObjectClass parent; 2243 AtkFunction pad1; 2244 AtkFunction pad2; 2245 } 2246 2247 struct AtkSelection; 2248 2249 struct AtkSelectionIface 2250 { 2251 GTypeInterface parent; 2252 /** 2253 * 2254 * Params: 2255 * selection = a #GObject instance that implements AtkSelectionIface 2256 * i = a #gint specifying the child index. 2257 * Returns: TRUE if success, FALSE otherwise. 2258 */ 2259 extern(C) int function(AtkSelection* selection, int i) addSelection; 2260 /** 2261 * 2262 * Params: 2263 * selection = a #GObject instance that implements AtkSelectionIface 2264 * Returns: TRUE if success, FALSE otherwise. 2265 */ 2266 extern(C) int function(AtkSelection* selection) clearSelection; 2267 /** 2268 * 2269 * Params: 2270 * selection = a #GObject instance that implements AtkSelectionIface 2271 * i = a #gint specifying the index in the selection set. (e.g. the 2272 * ith selection as opposed to the ith child). 2273 * Returns: an #AtkObject representing the 2274 * selected accessible, or %NULL if @selection does not implement this 2275 * interface. 2276 */ 2277 extern(C) AtkObject* function(AtkSelection* selection, int i) refSelection; 2278 /** 2279 * 2280 * Params: 2281 * selection = a #GObject instance that implements AtkSelectionIface 2282 * Returns: a gint representing the number of items selected, or 0 2283 * if @selection does not implement this interface. 2284 */ 2285 extern(C) int function(AtkSelection* selection) getSelectionCount; 2286 /** 2287 * 2288 * Params: 2289 * selection = a #GObject instance that implements AtkSelectionIface 2290 * i = a #gint specifying the child index. 2291 * Returns: a gboolean representing the specified child is selected, or 0 2292 * if @selection does not implement this interface. 2293 */ 2294 extern(C) int function(AtkSelection* selection, int i) isChildSelected; 2295 /** 2296 * 2297 * Params: 2298 * selection = a #GObject instance that implements AtkSelectionIface 2299 * i = a #gint specifying the index in the selection set. (e.g. the 2300 * ith selection as opposed to the ith child). 2301 * Returns: TRUE if success, FALSE otherwise. 2302 */ 2303 extern(C) int function(AtkSelection* selection, int i) removeSelection; 2304 /** 2305 * 2306 * Params: 2307 * selection = a #GObject instance that implements AtkSelectionIface 2308 * Returns: TRUE if success, FALSE otherwise. 2309 */ 2310 extern(C) int function(AtkSelection* selection) selectAllSelection; 2311 /** */ 2312 extern(C) void function(AtkSelection* selection) selectionChanged; 2313 } 2314 2315 struct AtkSocket 2316 { 2317 AtkObject parent; 2318 char* embeddedPlugId; 2319 } 2320 2321 struct AtkSocketClass 2322 { 2323 AtkObjectClass parentClass; 2324 /** */ 2325 extern(C) void function(AtkSocket* obj, const(char)* plugId) embed; 2326 } 2327 2328 struct AtkStateSet 2329 { 2330 GObject parent; 2331 } 2332 2333 struct AtkStateSetClass 2334 { 2335 GObjectClass parent; 2336 } 2337 2338 struct AtkStreamableContent; 2339 2340 struct AtkStreamableContentIface 2341 { 2342 GTypeInterface parent; 2343 /** 2344 * 2345 * Params: 2346 * streamable = a GObject instance that implements AtkStreamableContentIface 2347 * Returns: a gint which is the number of mime types supported by the object. 2348 */ 2349 extern(C) int function(AtkStreamableContent* streamable) getNMimeTypes; 2350 /** 2351 * 2352 * Params: 2353 * streamable = a GObject instance that implements AtkStreamableContent 2354 * i = a gint representing the position of the mime type starting from 0 2355 * Returns: a gchar* representing the specified mime type; the caller 2356 * should not free the character string. 2357 */ 2358 extern(C) const(char)* function(AtkStreamableContent* streamable, int i) getMimeType; 2359 /** 2360 * 2361 * Params: 2362 * streamable = a GObject instance that implements AtkStreamableContentIface 2363 * mimeType = a gchar* representing the mime type 2364 * Returns: A #GIOChannel which contains the content in the 2365 * specified mime type. 2366 */ 2367 extern(C) GIOChannel* function(AtkStreamableContent* streamable, const(char)* mimeType) getStream; 2368 /** 2369 * 2370 * Params: 2371 * streamable = a GObject instance that implements AtkStreamableContentIface 2372 * mimeType = a gchar* representing the mime type, or NULL to request a URI 2373 * for the default mime type. 2374 * Returns: Returns a string representing a URI, or %NULL 2375 * if no corresponding URI can be constructed. 2376 */ 2377 extern(C) const(char)* function(AtkStreamableContent* streamable, const(char)* mimeType) getUri; 2378 AtkFunction pad1; 2379 AtkFunction pad2; 2380 AtkFunction pad3; 2381 } 2382 2383 struct AtkTable; 2384 2385 struct AtkTableCell; 2386 2387 /** 2388 * AtkTableCell is an interface for cells inside an #AtkTable. 2389 * 2390 * Since: 2.12 2391 */ 2392 struct AtkTableCellIface 2393 { 2394 GTypeInterface parent; 2395 /** 2396 * 2397 * Params: 2398 * cell = a GObject instance that implements AtkTableCellIface 2399 * Returns: a gint representing the number of columns occupied by this cell, 2400 * or 0 if the cell does not implement this method. 2401 */ 2402 extern(C) int function(AtkTableCell* cell) getColumnSpan; 2403 /** 2404 * 2405 * Params: 2406 * cell = a GObject instance that implements AtkTableCellIface 2407 * Returns: a GPtrArray of AtkObjects 2408 * representing the column header cells. 2409 */ 2410 extern(C) GPtrArray* function(AtkTableCell* cell) getColumnHeaderCells; 2411 /** 2412 * 2413 * Params: 2414 * cell = a GObject instance that implements AtkTableCellIface 2415 * row = the row of the given cell. 2416 * column = the column of the given cell. 2417 * Returns: TRUE if successful; FALSE otherwise. 2418 */ 2419 extern(C) int function(AtkTableCell* cell, int* row, int* column) getPosition; 2420 /** 2421 * 2422 * Params: 2423 * cell = a GObject instance that implements AtkTableCellIface 2424 * Returns: a gint representing the number of rows occupied by this cell, 2425 * or 0 if the cell does not implement this method. 2426 */ 2427 extern(C) int function(AtkTableCell* cell) getRowSpan; 2428 /** 2429 * 2430 * Params: 2431 * cell = a GObject instance that implements AtkTableCellIface 2432 * Returns: a GPtrArray of AtkObjects 2433 * representing the row header cells. 2434 */ 2435 extern(C) GPtrArray* function(AtkTableCell* cell) getRowHeaderCells; 2436 /** 2437 * 2438 * Params: 2439 * cell = a GObject instance that implements AtkTableCellIface 2440 * row = the row index of the given cell. 2441 * column = the column index of the given cell. 2442 * rowSpan = the number of rows occupied by this cell. 2443 * columnSpan = the number of columns occupied by this cell. 2444 * Returns: TRUE if successful; FALSE otherwise. 2445 */ 2446 extern(C) int function(AtkTableCell* cell, int* row, int* column, int* rowSpan, int* columnSpan) getRowColumnSpan; 2447 /** 2448 * 2449 * Params: 2450 * cell = a GObject instance that implements AtkTableCellIface 2451 * Returns: the atk object for the containing table. 2452 */ 2453 extern(C) AtkObject* function(AtkTableCell* cell) getTable; 2454 } 2455 2456 struct AtkTableIface 2457 { 2458 GTypeInterface parent; 2459 /** 2460 * 2461 * Params: 2462 * table = a GObject instance that implements AtkTableIface 2463 * row = a #gint representing a row in @table 2464 * column = a #gint representing a column in @table 2465 * Returns: an #AtkObject representing the referred 2466 * to accessible 2467 */ 2468 extern(C) AtkObject* function(AtkTable* table, int row, int column) refAt; 2469 /** 2470 * 2471 * Params: 2472 * table = a GObject instance that implements AtkTableIface 2473 * row = a #gint representing a row in @table 2474 * column = a #gint representing a column in @table 2475 * Returns: a #gint representing the index at specified position. 2476 * The value -1 is returned if the object at row,column is not a child 2477 * of table or table does not implement this interface. 2478 */ 2479 extern(C) int function(AtkTable* table, int row, int column) getIndexAt; 2480 /** 2481 * 2482 * Params: 2483 * table = a GObject instance that implements AtkTableInterface 2484 * index = a #gint representing an index in @table 2485 * Returns: a gint representing the column at the specified index, 2486 * or -1 if the table does not implement this method. 2487 */ 2488 extern(C) int function(AtkTable* table, int index) getColumnAtIndex; 2489 /** 2490 * 2491 * Params: 2492 * table = a GObject instance that implements AtkTableInterface 2493 * index = a #gint representing an index in @table 2494 * Returns: a gint representing the row at the specified index, 2495 * or -1 if the table does not implement this method. 2496 */ 2497 extern(C) int function(AtkTable* table, int index) getRowAtIndex; 2498 /** 2499 * 2500 * Params: 2501 * table = a GObject instance that implements AtkTableIface 2502 * Returns: a gint representing the number of columns, or 0 2503 * if value does not implement this interface. 2504 */ 2505 extern(C) int function(AtkTable* table) getNColumns; 2506 /** 2507 * 2508 * Params: 2509 * table = a GObject instance that implements AtkTableIface 2510 * Returns: a gint representing the number of rows, or 0 2511 * if value does not implement this interface. 2512 */ 2513 extern(C) int function(AtkTable* table) getNRows; 2514 /** 2515 * 2516 * Params: 2517 * table = a GObject instance that implements AtkTableIface 2518 * row = a #gint representing a row in @table 2519 * column = a #gint representing a column in @table 2520 * Returns: a gint representing the column extent at specified position, or 0 2521 * if value does not implement this interface. 2522 */ 2523 extern(C) int function(AtkTable* table, int row, int column) getColumnExtentAt; 2524 /** 2525 * 2526 * Params: 2527 * table = a GObject instance that implements AtkTableIface 2528 * row = a #gint representing a row in @table 2529 * column = a #gint representing a column in @table 2530 * Returns: a gint representing the row extent at specified position, or 0 2531 * if value does not implement this interface. 2532 */ 2533 extern(C) int function(AtkTable* table, int row, int column) getRowExtentAt; 2534 /** 2535 * 2536 * Params: 2537 * table = a GObject instance that implements AtkTableInterface 2538 * Returns: a AtkObject* representing the 2539 * table caption, or %NULL if value does not implement this interface. 2540 */ 2541 extern(C) AtkObject* function(AtkTable* table) getCaption; 2542 /** 2543 * 2544 * Params: 2545 * table = a GObject instance that implements AtkTableIface 2546 * column = a #gint representing a column in @table 2547 * Returns: a gchar* representing the column description, or %NULL 2548 * if value does not implement this interface. 2549 */ 2550 extern(C) const(char)* function(AtkTable* table, int column) getColumnDescription; 2551 /** 2552 * 2553 * Params: 2554 * table = a GObject instance that implements AtkTableIface 2555 * column = a #gint representing a column in the table 2556 * Returns: a AtkObject* representing the 2557 * specified column header, or %NULL if value does not implement this 2558 * interface. 2559 */ 2560 extern(C) AtkObject* function(AtkTable* table, int column) getColumnHeader; 2561 /** 2562 * 2563 * Params: 2564 * table = a GObject instance that implements AtkTableIface 2565 * row = a #gint representing a row in @table 2566 * Returns: a gchar* representing the row description, or 2567 * %NULL if value does not implement this interface. 2568 */ 2569 extern(C) const(char)* function(AtkTable* table, int row) getRowDescription; 2570 /** 2571 * 2572 * Params: 2573 * table = a GObject instance that implements AtkTableIface 2574 * row = a #gint representing a row in the table 2575 * Returns: a AtkObject* representing the 2576 * specified row header, or %NULL if value does not implement this 2577 * interface. 2578 */ 2579 extern(C) AtkObject* function(AtkTable* table, int row) getRowHeader; 2580 /** 2581 * 2582 * Params: 2583 * table = a GObject instance that implements AtkTableIface 2584 * Returns: a AtkObject* representing a summary description 2585 * of the table, or zero if value does not implement this interface. 2586 */ 2587 extern(C) AtkObject* function(AtkTable* table) getSummary; 2588 /** */ 2589 extern(C) void function(AtkTable* table, AtkObject* caption) setCaption; 2590 /** */ 2591 extern(C) void function(AtkTable* table, int column, const(char)* description) setColumnDescription; 2592 /** */ 2593 extern(C) void function(AtkTable* table, int column, AtkObject* header) setColumnHeader; 2594 /** */ 2595 extern(C) void function(AtkTable* table, int row, const(char)* description) setRowDescription; 2596 /** */ 2597 extern(C) void function(AtkTable* table, int row, AtkObject* header) setRowHeader; 2598 /** */ 2599 extern(C) void function(AtkTable* table, AtkObject* accessible) setSummary; 2600 /** 2601 * 2602 * Params: 2603 * table = a GObject instance that implements AtkTableIface 2604 * selected = a #gint** that is to contain the selected columns numbers 2605 * Returns: a gint representing the number of selected columns, 2606 * or %0 if value does not implement this interface. 2607 */ 2608 extern(C) int function(AtkTable* table, int** selected) getSelectedColumns; 2609 /** 2610 * 2611 * Params: 2612 * table = a GObject instance that implements AtkTableIface 2613 * selected = a #gint** that is to contain the selected row numbers 2614 * Returns: a gint representing the number of selected rows, 2615 * or zero if value does not implement this interface. 2616 */ 2617 extern(C) int function(AtkTable* table, int** selected) getSelectedRows; 2618 /** 2619 * 2620 * Params: 2621 * table = a GObject instance that implements AtkTableIface 2622 * column = a #gint representing a column in @table 2623 * Returns: a gboolean representing if the column is selected, or 0 2624 * if value does not implement this interface. 2625 */ 2626 extern(C) int function(AtkTable* table, int column) isColumnSelected; 2627 /** 2628 * 2629 * Params: 2630 * table = a GObject instance that implements AtkTableIface 2631 * row = a #gint representing a row in @table 2632 * Returns: a gboolean representing if the row is selected, or 0 2633 * if value does not implement this interface. 2634 */ 2635 extern(C) int function(AtkTable* table, int row) isRowSelected; 2636 /** 2637 * 2638 * Params: 2639 * table = a GObject instance that implements AtkTableIface 2640 * row = a #gint representing a row in @table 2641 * column = a #gint representing a column in @table 2642 * Returns: a gboolean representing if the cell is selected, or 0 2643 * if value does not implement this interface. 2644 */ 2645 extern(C) int function(AtkTable* table, int row, int column) isSelected; 2646 /** 2647 * 2648 * Params: 2649 * table = a GObject instance that implements AtkTableIface 2650 * row = a #gint representing a row in @table 2651 * Returns: a gboolean representing if row was successfully added to selection, 2652 * or 0 if value does not implement this interface. 2653 */ 2654 extern(C) int function(AtkTable* table, int row) addRowSelection; 2655 /** 2656 * 2657 * Params: 2658 * table = a GObject instance that implements AtkTableIface 2659 * row = a #gint representing a row in @table 2660 * Returns: a gboolean representing if the row was successfully removed from 2661 * the selection, or 0 if value does not implement this interface. 2662 */ 2663 extern(C) int function(AtkTable* table, int row) removeRowSelection; 2664 /** 2665 * 2666 * Params: 2667 * table = a GObject instance that implements AtkTableIface 2668 * column = a #gint representing a column in @table 2669 * Returns: a gboolean representing if the column was successfully added to 2670 * the selection, or 0 if value does not implement this interface. 2671 */ 2672 extern(C) int function(AtkTable* table, int column) addColumnSelection; 2673 /** 2674 * 2675 * Params: 2676 * table = a GObject instance that implements AtkTableIface 2677 * column = a #gint representing a column in @table 2678 * Returns: a gboolean representing if the column was successfully removed from 2679 * the selection, or 0 if value does not implement this interface. 2680 */ 2681 extern(C) int function(AtkTable* table, int column) removeColumnSelection; 2682 /** */ 2683 extern(C) void function(AtkTable* table, int row, int numInserted) rowInserted; 2684 /** */ 2685 extern(C) void function(AtkTable* table, int column, int numInserted) columnInserted; 2686 /** */ 2687 extern(C) void function(AtkTable* table, int row, int numDeleted) rowDeleted; 2688 /** */ 2689 extern(C) void function(AtkTable* table, int column, int numDeleted) columnDeleted; 2690 /** */ 2691 extern(C) void function(AtkTable* table) rowReordered; 2692 /** */ 2693 extern(C) void function(AtkTable* table) columnReordered; 2694 /** */ 2695 extern(C) void function(AtkTable* table) modelChanged; 2696 } 2697 2698 struct AtkText; 2699 2700 struct AtkTextIface 2701 { 2702 GTypeInterface parent; 2703 /** 2704 * 2705 * Params: 2706 * text = an #AtkText 2707 * startOffset = a starting character offset within @text 2708 * endOffset = an ending character offset within @text, or -1 for the end of the string. 2709 * Returns: a newly allocated string containing the text from @start_offset up 2710 * to, but not including @end_offset. Use g_free() to free the returned 2711 * string. 2712 */ 2713 extern(C) char* function(AtkText* text, int startOffset, int endOffset) getText; 2714 /** 2715 * 2716 * Params: 2717 * text = an #AtkText 2718 * offset = position 2719 * boundaryType = An #AtkTextBoundary 2720 * startOffset = the starting character offset of the returned string 2721 * endOffset = the offset of the first character after the 2722 * returned substring 2723 * Returns: a newly allocated string containing the text after @offset bounded 2724 * by the specified @boundary_type. Use g_free() to free the returned 2725 * string. 2726 */ 2727 extern(C) char* function(AtkText* text, int offset, AtkTextBoundary boundaryType, int* startOffset, int* endOffset) getTextAfterOffset; 2728 /** 2729 * 2730 * Params: 2731 * text = an #AtkText 2732 * offset = position 2733 * boundaryType = An #AtkTextBoundary 2734 * startOffset = the starting character offset of the returned string 2735 * endOffset = the offset of the first character after the 2736 * returned substring 2737 * Returns: a newly allocated string containing the text at @offset bounded 2738 * by the specified @boundary_type. Use g_free() to free the returned 2739 * string. 2740 */ 2741 extern(C) char* function(AtkText* text, int offset, AtkTextBoundary boundaryType, int* startOffset, int* endOffset) getTextAtOffset; 2742 /** 2743 * 2744 * Params: 2745 * text = an #AtkText 2746 * offset = a character offset within @text 2747 * Returns: the character at @offset or 0 in the case of failure. 2748 */ 2749 extern(C) dchar function(AtkText* text, int offset) getCharacterAtOffset; 2750 /** 2751 * 2752 * Params: 2753 * text = an #AtkText 2754 * offset = position 2755 * boundaryType = An #AtkTextBoundary 2756 * startOffset = the starting character offset of the returned string 2757 * endOffset = the offset of the first character after the 2758 * returned substring 2759 * Returns: a newly allocated string containing the text before @offset bounded 2760 * by the specified @boundary_type. Use g_free() to free the returned 2761 * string. 2762 */ 2763 extern(C) char* function(AtkText* text, int offset, AtkTextBoundary boundaryType, int* startOffset, int* endOffset) getTextBeforeOffset; 2764 /** 2765 * 2766 * Params: 2767 * text = an #AtkText 2768 * Returns: the character offset of the position of the caret or -1 if 2769 * the caret is not located inside the element or in the case of 2770 * any other failure. 2771 */ 2772 extern(C) int function(AtkText* text) getCaretOffset; 2773 /** 2774 * 2775 * Params: 2776 * text = an #AtkText 2777 * offset = the character offset at which to get the attributes, -1 means the offset of 2778 * the character to be inserted at the caret location. 2779 * startOffset = the address to put the start offset of the range 2780 * endOffset = the address to put the end offset of the range 2781 * Returns: an #AtkAttributeSet which contains the attributes 2782 * explicitly set at @offset. This #AtkAttributeSet should be freed by 2783 * a call to atk_attribute_set_free(). 2784 */ 2785 extern(C) AtkAttributeSet* function(AtkText* text, int offset, int* startOffset, int* endOffset) getRunAttributes; 2786 /** 2787 * 2788 * Params: 2789 * text = an #AtkText 2790 * Returns: an #AtkAttributeSet which contains the default text 2791 * attributes for this #AtkText. This #AtkAttributeSet should be freed by 2792 * a call to atk_attribute_set_free(). 2793 */ 2794 extern(C) AtkAttributeSet* function(AtkText* text) getDefaultAttributes; 2795 /** */ 2796 extern(C) void function(AtkText* text, int offset, int* x, int* y, int* width, int* height, AtkCoordType coords) getCharacterExtents; 2797 /** 2798 * 2799 * Params: 2800 * text = an #AtkText 2801 * Returns: the number of characters or -1 in case of failure. 2802 */ 2803 extern(C) int function(AtkText* text) getCharacterCount; 2804 /** 2805 * 2806 * Params: 2807 * text = an #AtkText 2808 * x = screen x-position of character 2809 * y = screen y-position of character 2810 * coords = specify whether coordinates are relative to the screen or 2811 * widget window 2812 * Returns: the offset to the character which is located at the specified 2813 * @x and @y coordinates of -1 in case of failure. 2814 */ 2815 extern(C) int function(AtkText* text, int x, int y, AtkCoordType coords) getOffsetAtPoint; 2816 /** 2817 * 2818 * Params: 2819 * text = an #AtkText 2820 * Returns: The number of selected regions, or -1 in the case of failure. 2821 */ 2822 extern(C) int function(AtkText* text) getNSelections; 2823 /** 2824 * 2825 * Params: 2826 * text = an #AtkText 2827 * selectionNum = The selection number. The selected regions are 2828 * assigned numbers that correspond to how far the region is from the 2829 * start of the text. The selected region closest to the beginning 2830 * of the text region is assigned the number 0, etc. Note that adding, 2831 * moving or deleting a selected region can change the numbering. 2832 * startOffset = passes back the starting character offset of the selected region 2833 * endOffset = passes back the ending character offset (offset immediately past) 2834 * of the selected region 2835 * Returns: a newly allocated string containing the selected text. Use g_free() 2836 * to free the returned string. 2837 */ 2838 extern(C) char* function(AtkText* text, int selectionNum, int* startOffset, int* endOffset) getSelection; 2839 /** 2840 * 2841 * Params: 2842 * text = an #AtkText 2843 * startOffset = the starting character offset of the selected region 2844 * endOffset = the offset of the first character after the selected region. 2845 * Returns: %TRUE if successful, %FALSE otherwise 2846 */ 2847 extern(C) int function(AtkText* text, int startOffset, int endOffset) addSelection; 2848 /** 2849 * 2850 * Params: 2851 * text = an #AtkText 2852 * selectionNum = The selection number. The selected regions are 2853 * assigned numbers that correspond to how far the region is from the 2854 * start of the text. The selected region closest to the beginning 2855 * of the text region is assigned the number 0, etc. Note that adding, 2856 * moving or deleting a selected region can change the numbering. 2857 * Returns: %TRUE if successful, %FALSE otherwise 2858 */ 2859 extern(C) int function(AtkText* text, int selectionNum) removeSelection; 2860 /** 2861 * 2862 * Params: 2863 * text = an #AtkText 2864 * selectionNum = The selection number. The selected regions are 2865 * assigned numbers that correspond to how far the region is from the 2866 * start of the text. The selected region closest to the beginning 2867 * of the text region is assigned the number 0, etc. Note that adding, 2868 * moving or deleting a selected region can change the numbering. 2869 * startOffset = the new starting character offset of the selection 2870 * endOffset = the new end position of (e.g. offset immediately past) 2871 * the selection 2872 * Returns: %TRUE if successful, %FALSE otherwise 2873 */ 2874 extern(C) int function(AtkText* text, int selectionNum, int startOffset, int endOffset) setSelection; 2875 /** 2876 * 2877 * Params: 2878 * text = an #AtkText 2879 * offset = the character offset of the new caret position 2880 * Returns: %TRUE if successful, %FALSE otherwise. 2881 */ 2882 extern(C) int function(AtkText* text, int offset) setCaretOffset; 2883 /** */ 2884 extern(C) void function(AtkText* text, int position, int length) textChanged; 2885 /** */ 2886 extern(C) void function(AtkText* text, int location) textCaretMoved; 2887 /** */ 2888 extern(C) void function(AtkText* text) textSelectionChanged; 2889 /** */ 2890 extern(C) void function(AtkText* text) textAttributesChanged; 2891 /** */ 2892 extern(C) void function(AtkText* text, int startOffset, int endOffset, AtkCoordType coordType, AtkTextRectangle* rect) getRangeExtents; 2893 /** 2894 * 2895 * Params: 2896 * text = an #AtkText 2897 * rect = An AtkTextRectangle giving the dimensions of the bounding box. 2898 * coordType = Specify whether coordinates are relative to the screen or widget window. 2899 * xClipType = Specify the horizontal clip type. 2900 * yClipType = Specify the vertical clip type. 2901 * Returns: Array of AtkTextRange. The last 2902 * element of the array returned by this function will be NULL. 2903 */ 2904 extern(C) AtkTextRange** function(AtkText* text, AtkTextRectangle* rect, AtkCoordType coordType, AtkTextClipType xClipType, AtkTextClipType yClipType) getBoundedRanges; 2905 /** 2906 * 2907 * Params: 2908 * text = an #AtkText 2909 * offset = position 2910 * granularity = An #AtkTextGranularity 2911 * startOffset = the starting character offset of the returned string, or -1 2912 * in the case of error (e.g. invalid offset, not implemented) 2913 * endOffset = the offset of the first character after the returned string, 2914 * or -1 in the case of error (e.g. invalid offset, not implemented) 2915 * Returns: a newly allocated string containing the text at 2916 * the @offset bounded by the specified @granularity. Use g_free() 2917 * to free the returned string. Returns %NULL if the offset is invalid 2918 * or no implementation is available. 2919 */ 2920 extern(C) char* function(AtkText* text, int offset, AtkTextGranularity granularity, int* startOffset, int* endOffset) getStringAtOffset; 2921 /** 2922 * 2923 * Params: 2924 * text = an #AtkText 2925 * startOffset = start offset in the @text 2926 * endOffset = end offset in the @text, or -1 for the end of the text. 2927 * type = specify where the object should be made visible. 2928 * Returns: whether scrolling was successful. 2929 */ 2930 extern(C) int function(AtkText* text, int startOffset, int endOffset, AtkScrollType type) scrollSubstringTo; 2931 /** 2932 * 2933 * Params: 2934 * text = an #AtkText 2935 * startOffset = start offset in the @text 2936 * endOffset = end offset in the @text, or -1 for the end of the text. 2937 * coords = specify whether coordinates are relative to the screen or to the 2938 * parent object. 2939 * x = x-position where to scroll to 2940 * y = y-position where to scroll to 2941 * Returns: whether scrolling was successful. 2942 */ 2943 extern(C) int function(AtkText* text, int startOffset, int endOffset, AtkCoordType coords, int x, int y) scrollSubstringToPoint; 2944 } 2945 2946 /** 2947 * A structure used to describe a text range. 2948 */ 2949 struct AtkTextRange 2950 { 2951 /** 2952 * A rectangle giving the bounds of the text range 2953 */ 2954 AtkTextRectangle bounds; 2955 /** 2956 * The start offset of a AtkTextRange 2957 */ 2958 int startOffset; 2959 /** 2960 * The end offset of a AtkTextRange 2961 */ 2962 int endOffset; 2963 /** 2964 * The text in the text range 2965 */ 2966 char* content; 2967 } 2968 2969 /** 2970 * A structure used to store a rectangle used by AtkText. 2971 */ 2972 struct AtkTextRectangle 2973 { 2974 /** 2975 * The horizontal coordinate of a rectangle 2976 */ 2977 int x; 2978 /** 2979 * The vertical coordinate of a rectangle 2980 */ 2981 int y; 2982 /** 2983 * The width of a rectangle 2984 */ 2985 int width; 2986 /** 2987 * The height of a rectangle 2988 */ 2989 int height; 2990 } 2991 2992 /** 2993 * A set of ATK utility functions which are used to support event 2994 * registration of various types, and obtaining the 'root' accessible 2995 * of a process and information about the current ATK implementation 2996 * and toolkit version. 2997 */ 2998 struct AtkUtil 2999 { 3000 GObject parent; 3001 } 3002 3003 struct AtkUtilClass 3004 { 3005 GObjectClass parent; 3006 /** */ 3007 extern(C) uint function(GSignalEmissionHook listener, const(char)* eventType) addGlobalEventListener; 3008 /** */ 3009 extern(C) void function(uint listenerId) removeGlobalEventListener; 3010 /** */ 3011 extern(C) uint function(AtkKeySnoopFunc listener, void* data) addKeyEventListener; 3012 /** */ 3013 extern(C) void function(uint listenerId) removeKeyEventListener; 3014 /** */ 3015 extern(C) AtkObject* function() getRoot; 3016 /** */ 3017 extern(C) const(char)* function() getToolkitName; 3018 /** */ 3019 extern(C) const(char)* function() getToolkitVersion; 3020 } 3021 3022 struct AtkValue; 3023 3024 struct AtkValueIface 3025 { 3026 GTypeInterface parent; 3027 /** */ 3028 extern(C) void function(AtkValue* obj, GValue* value) getCurrentValue; 3029 /** */ 3030 extern(C) void function(AtkValue* obj, GValue* value) getMaximumValue; 3031 /** */ 3032 extern(C) void function(AtkValue* obj, GValue* value) getMinimumValue; 3033 /** 3034 * 3035 * Params: 3036 * obj = a GObject instance that implements AtkValueIface 3037 * value = a #GValue which is the desired new accessible value. 3038 * Returns: %TRUE if new value is successfully set, %FALSE otherwise. 3039 */ 3040 extern(C) int function(AtkValue* obj, GValue* value) setCurrentValue; 3041 /** */ 3042 extern(C) void function(AtkValue* obj, GValue* value) getMinimumIncrement; 3043 /** */ 3044 extern(C) void function(AtkValue* obj, double* value, char** text) getValueAndText; 3045 /** 3046 * 3047 * Params: 3048 * obj = a GObject instance that implements AtkValueIface 3049 * Returns: a newly allocated #AtkRange 3050 * that represents the minimum, maximum and descriptor (if available) 3051 * of @obj. NULL if that range is not defined. 3052 */ 3053 extern(C) AtkRange* function(AtkValue* obj) getRange; 3054 /** 3055 * 3056 * Params: 3057 * obj = a GObject instance that implements AtkValueIface 3058 * Returns: the minimum increment by which the value of this 3059 * object may be changed. zero if undefined. 3060 */ 3061 extern(C) double function(AtkValue* obj) getIncrement; 3062 /** 3063 * 3064 * Params: 3065 * obj = a GObject instance that implements AtkValueIface 3066 * Returns: an #GSList of 3067 * #AtkRange which each of the subranges defined for this object. Free 3068 * the returns list with g_slist_free(). 3069 */ 3070 extern(C) GSList* function(AtkValue* obj) getSubRanges; 3071 /** */ 3072 extern(C) void function(AtkValue* obj, double newValue) setValue; 3073 } 3074 3075 struct AtkWindow; 3076 3077 struct AtkWindowIface 3078 { 3079 GTypeInterface parent; 3080 } 3081 3082 /** 3083 * A function which is called when an object emits a matching event, 3084 * as used in #atk_add_focus_tracker. 3085 * Currently the only events for which object-specific handlers are 3086 * supported are events of type "focus:". Most clients of ATK will prefer to 3087 * attach signal handlers for the various ATK signals instead. 3088 * 3089 * see atk_add_focus_tracker. 3090 * 3091 * Params: 3092 * obj = An #AtkObject instance for whom the callback will be called when 3093 * the specified event (e.g. 'focus:') takes place. 3094 */ 3095 public alias extern(C) void function(AtkObject* obj) AtkEventListener; 3096 3097 /** 3098 * An #AtkEventListenerInit function is a special function that is 3099 * called in order to initialize the per-object event registration system 3100 * used by #AtkEventListener, if any preparation is required. 3101 * 3102 * see atk_focus_tracker_init. 3103 */ 3104 public alias extern(C) void function() AtkEventListenerInit; 3105 3106 /** 3107 * The type of callback function used for 3108 * atk_component_add_focus_handler() and 3109 * atk_component_remove_focus_handler() 3110 * 3111 * Deprecated: Deprecated with atk_component_add_focus_handler() 3112 * and atk_component_remove_focus_handler(). See those 3113 * methods for more information. 3114 * 3115 * Params: 3116 * object = the #AtkObject that receives/lose the focus 3117 * focusIn = TRUE if the object receives the focus 3118 */ 3119 public alias extern(C) void function(AtkObject* object, int focusIn) AtkFocusHandler; 3120 3121 /** 3122 * An AtkFunction is a function definition used for padding which has 3123 * been added to class and interface structures to allow for expansion 3124 * in the future. 3125 * 3126 * Params: 3127 * userData = custom data defined by the user 3128 * 3129 * Returns: not used 3130 */ 3131 public alias extern(C) int function(void* userData) AtkFunction; 3132 3133 /** 3134 * An #AtkKeySnoopFunc is a type of callback which is called whenever a key event occurs, 3135 * if registered via atk_add_key_event_listener. It allows for pre-emptive 3136 * interception of key events via the return code as described below. 3137 * 3138 * Params: 3139 * event = an AtkKeyEventStruct containing information about the key event for which 3140 * notification is being given. 3141 * userData = a block of data which will be passed to the event listener, on notification. 3142 * 3143 * Returns: TRUE (nonzero) if the event emission should be stopped and the event 3144 * discarded without being passed to the normal GUI recipient; FALSE (zero) if the 3145 * event dispatch to the client application should proceed as normal. 3146 * 3147 * see atk_add_key_event_listener. 3148 */ 3149 public alias extern(C) int function(AtkKeyEventStruct* event, void* userData) AtkKeySnoopFunc; 3150 3151 /** 3152 * An AtkPropertyChangeHandler is a function which is executed when an 3153 * AtkObject's property changes value. It is specified in a call to 3154 * atk_object_connect_property_change_handler(). 3155 * 3156 * Deprecated: Since 2.12. 3157 * 3158 * Params: 3159 * obj = atkobject which property changes 3160 * vals = values changed 3161 */ 3162 public alias extern(C) void function(AtkObject* obj, AtkPropertyValues* vals) AtkPropertyChangeHandler; 3163 3164 /** 3165 * Like atk_get_binary_age(), but from the headers used at 3166 * application compile time, rather than from the library linked 3167 * against at application run time. 3168 */ 3169 enum BINARY_AGE = 23610; 3170 alias ATK_BINARY_AGE = BINARY_AGE; 3171 3172 /** 3173 * Like atk_get_interface_age(), but from the headers used at 3174 * application compile time, rather than from the library linked 3175 * against at application run time. 3176 */ 3177 enum INTERFACE_AGE = 1; 3178 alias ATK_INTERFACE_AGE = INTERFACE_AGE; 3179 3180 /** 3181 * Like atk_get_major_version(), but from the headers used at 3182 * application compile time, rather than from the library linked 3183 * against at application run time. 3184 */ 3185 enum MAJOR_VERSION = 2; 3186 alias ATK_MAJOR_VERSION = MAJOR_VERSION; 3187 3188 /** 3189 * Like atk_get_micro_version(), but from the headers used at 3190 * application compile time, rather than from the library linked 3191 * against at application run time. 3192 */ 3193 enum MICRO_VERSION = 0; 3194 alias ATK_MICRO_VERSION = MICRO_VERSION; 3195 3196 /** 3197 * Like atk_get_minor_version(), but from the headers used at 3198 * application compile time, rather than from the library linked 3199 * against at application run time. 3200 */ 3201 enum MINOR_VERSION = 36; 3202 alias ATK_MINOR_VERSION = MINOR_VERSION; 3203 3204 /** 3205 * A macro that should be defined by the user prior to including 3206 * the atk/atk.h header. 3207 * The definition should be one of the predefined ATK version 3208 * macros: %ATK_VERSION_2_12, %ATK_VERSION_2_14,... 3209 * 3210 * This macro defines the earliest version of ATK that the package is 3211 * required to be able to compile against. 3212 * 3213 * If the compiler is configured to warn about the use of deprecated 3214 * functions, then using functions that were deprecated in version 3215 * %ATK_VERSION_MIN_REQUIRED or earlier will cause warnings (but 3216 * using functions deprecated in later releases will not). 3217 */ 3218 enum VERSION_MIN_REQUIRED = 2; 3219 alias ATK_VERSION_MIN_REQUIRED = VERSION_MIN_REQUIRED;