atkobject.html

linux下图形库开发包atk-1.4.0.tar.gz

  ATK_ROLE_ALERT,
  ATK_ROLE_ANIMATION,
  ATK_ROLE_ARROW,
  ATK_ROLE_CALENDAR,
  ATK_ROLE_CANVAS,
  ATK_ROLE_CHECK_BOX,
  ATK_ROLE_CHECK_MENU_ITEM,
  ATK_ROLE_COLOR_CHOOSER,
  ATK_ROLE_COLUMN_HEADER,
  ATK_ROLE_COMBO_BOX,
  ATK_ROLE_DATE_EDITOR,
  ATK_ROLE_DESKTOP_ICON,
  ATK_ROLE_DESKTOP_FRAME,
  ATK_ROLE_DIAL,
  ATK_ROLE_DIALOG,
  ATK_ROLE_DIRECTORY_PANE,
  ATK_ROLE_DRAWING_AREA,
  ATK_ROLE_FILE_CHOOSER,
  ATK_ROLE_FILLER,
  ATK_ROLE_FONT_CHOOSER,
  ATK_ROLE_FRAME,
  ATK_ROLE_GLASS_PANE,
  ATK_ROLE_HTML_CONTAINER,
  ATK_ROLE_ICON,
  ATK_ROLE_IMAGE,
  ATK_ROLE_INTERNAL_FRAME,
  ATK_ROLE_LABEL,
  ATK_ROLE_LAYERED_PANE,
  ATK_ROLE_LIST,
  ATK_ROLE_LIST_ITEM,
  ATK_ROLE_MENU,
  ATK_ROLE_MENU_BAR,
  ATK_ROLE_MENU_ITEM,
  ATK_ROLE_OPTION_PANE,
  ATK_ROLE_PAGE_TAB,
  ATK_ROLE_PAGE_TAB_LIST,
  ATK_ROLE_PANEL,
  ATK_ROLE_PASSWORD_TEXT,
  ATK_ROLE_POPUP_MENU,
  ATK_ROLE_PROGRESS_BAR,
  ATK_ROLE_PUSH_BUTTON,
  ATK_ROLE_RADIO_BUTTON,
  ATK_ROLE_RADIO_MENU_ITEM,
  ATK_ROLE_ROOT_PANE,
  ATK_ROLE_ROW_HEADER,
  ATK_ROLE_SCROLL_BAR,
  ATK_ROLE_SCROLL_PANE,
  ATK_ROLE_SEPARATOR,
  ATK_ROLE_SLIDER,
  ATK_ROLE_SPLIT_PANE,
  ATK_ROLE_SPIN_BUTTON,
  ATK_ROLE_STATUSBAR,
  ATK_ROLE_TABLE,
  ATK_ROLE_TABLE_CELL,
  ATK_ROLE_TABLE_COLUMN_HEADER,
  ATK_ROLE_TABLE_ROW_HEADER,
  ATK_ROLE_TEAR_OFF_MENU_ITEM,
  ATK_ROLE_TERMINAL,
  ATK_ROLE_TEXT,
  ATK_ROLE_TOGGLE_BUTTON,
  ATK_ROLE_TOOL_BAR,
  ATK_ROLE_TOOL_TIP,
  ATK_ROLE_TREE,
  ATK_ROLE_TREE_TABLE,
  ATK_ROLE_UNKNOWN,
  ATK_ROLE_VIEWPORT,
  ATK_ROLE_WINDOW,
  ATK_ROLE_HEADER,
  ATK_ROLE_FOOTER,
  ATK_ROLE_PARAGRAPH,
  ATK_ROLE_RULER,
  ATK_ROLE_APPLICATION,
  ATK_ROLE_AUTOCOMPLETE,
  ATK_ROLE_LAST_DEFINED
} AtkRole;
</pre><p>
Describes the role of an object
</p><p>
These are the built-in enumerated roles that UI components can have in
ATK.  Other roles may be added at runtime, so an AtkRole &gt;=
ATK_ROLE_LAST_DEFINED is not necessarily an error.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><tt>ATK_ROLE_INVALID</tt></span></td><td> Invalid role
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_ACCEL_LABEL</tt></span></td><td> A label which represents an accelerator
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_ALERT</tt></span></td><td> An object which is an alert to the user
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_ANIMATION</tt></span></td><td> An object which is an animated image
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_ARROW</tt></span></td><td> An arrow in one of the four cardinal directions
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_CALENDAR</tt></span></td><td>  An object that displays a calendar and allows the user to select a date
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_CANVAS</tt></span></td><td> An object that can be drawn into and is used to trap events
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_CHECK_BOX</tt></span></td><td> A choice that can be checked or unchecked and provides a separate indicator for the current state
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_CHECK_MENU_ITEM</tt></span></td><td> A menu item with a check box
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_COLOR_CHOOSER</tt></span></td><td> A specialized dialog that lets the user choose a color
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_COLUMN_HEADER</tt></span></td><td> The header for a column of data
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_COMBO_BOX</tt></span></td><td> A list of choices the user can select from
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_DATE_EDITOR</tt></span></td><td> An object whose purpose is to allow a user to edit a date
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_DESKTOP_ICON</tt></span></td><td> An inconifed internal frame within a DESKTOP_PANE
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_DESKTOP_FRAME</tt></span></td><td> A pane that supports internal frames and iconified versions of those internal frames
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_DIAL</tt></span></td><td> An object whose purpose is to allow a user to set a value
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_DIALOG</tt></span></td><td> A top level window with title bar and a border
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_DIRECTORY_PANE</tt></span></td><td> A pane that allows the user to navigate through and select the contents of a directory
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_DRAWING_AREA</tt></span></td><td> An object used for drawing custom user interface elements
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_FILE_CHOOSER</tt></span></td><td> A specialized dialog that lets the user choose a file
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_FILLER</tt></span></td><td> A object that fills up space in a user interface
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_FONT_CHOOSER</tt></span></td><td> A specialized dialog that lets the user choose a font
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_FRAME</tt></span></td><td> A top level window with a title bar, border, menubar, etc.
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_GLASS_PANE</tt></span></td><td> A pane that is guaranteed to be painted on top of all panes beneath it
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_HTML_CONTAINER</tt></span></td><td> A document container for HTML, whose children represent the document content
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_ICON</tt></span></td><td> A small fixed size picture, typically used to decorate components
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_IMAGE</tt></span></td><td> An object whose primary purpose is to display an image
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_INTERNAL_FRAME</tt></span></td><td> A frame-like object that is clipped by a desktop pane
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_LABEL</tt></span></td><td> An object used to present an icon or short string in an interface
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_LAYERED_PANE</tt></span></td><td> A specialized pane that allows its children to be drawn in layers, providing a form of stacking order
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_LIST</tt></span></td><td> An object that presents a list of objects to the user and allows the user to select one or more of them 
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_LIST_ITEM</tt></span></td><td> An object that represents an element of a list 
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_MENU</tt></span></td><td> An object usually found inside a menu bar that contains a list of actions the user can choose from
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_MENU_BAR</tt></span></td><td> 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 
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_MENU_ITEM</tt></span></td><td> An object usually contained in a menu that presents an action the user can choose
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_OPTION_PANE</tt></span></td><td> A specialized pane whose primary use is inside a DIALOG
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_PAGE_TAB</tt></span></td><td> An object that is a child of a page tab list
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_PAGE_TAB_LIST</tt></span></td><td> An object that presents a series of panels (or page tabs), one at a time, through some mechanism provided by the object 
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_PANEL</tt></span></td><td> A generic container that is often used to group objects
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_PASSWORD_TEXT</tt></span></td><td> A text object uses for passwords, or other places where the text content is not shown visibly to the user
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_POPUP_MENU</tt></span></td><td> 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
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_PROGRESS_BAR</tt></span></td><td> An object used to indicate how much of a task has been completed
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_PUSH_BUTTON</tt></span></td><td> An object the user can manipulate to tell the application to do something
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_RADIO_BUTTON</tt></span></td><td> A specialized check box that will cause other radio buttons in the same group to become unchecked when this one is checked
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_RADIO_MENU_ITEM</tt></span></td><td> A check menu item which belongs to a group. At each instant exactly one of the radio menu items from a group is selected
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_ROOT_PANE</tt></span></td><td> A specialized pane that has a glass pane and a layered pane as its children
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_ROW_HEADER</tt></span></td><td> The header for a row of data
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_SCROLL_BAR</tt></span></td><td> An object usually used to allow a user to incrementally view a large amount of data.
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_SCROLL_PANE</tt></span></td><td> An object that allows a user to incrementally view a large amount of information
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_SEPARATOR</tt></span></td><td> An object usually contained in a menu to provide a visible and logical separation of the contents in a menu
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_SLIDER</tt></span></td><td> An object that allows the user to select from a bounded range
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_SPLIT_PANE</tt></span></td><td> A specialized panel that presents two other panels at the same time
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_SPIN_BUTTON</tt></span></td><td> An object used to get an integer or floating point number from the user
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_STATUSBAR</tt></span></td><td> An object which reports messages of minor importance to the user
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_TABLE</tt></span></td><td> An object used to represent information in terms of rows and columns
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_TABLE_CELL</tt></span></td><td> A cell in a table
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_TABLE_COLUMN_HEADER</tt></span></td><td> The header for a column of a table
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_TABLE_ROW_HEADER</tt></span></td><td> The header for a row of a table
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_TEAR_OFF_MENU_ITEM</tt></span></td><td> A menu item used to tear off and reattach its menu
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_TERMINAL</tt></span></td><td> An object that represents an accessible terminal
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_TEXT</tt></span></td><td> An object that presents text to the user
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_TOGGLE_BUTTON</tt></span></td><td> A specialized push button that can be checked or unchecked, but does not provide a separate indicator for the current state
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_TOOL_BAR</tt></span></td><td> A bar or palette usually composed of push buttons or toggle buttons
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_TOOL_TIP</tt></span></td><td> An object that provides information about another object
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_TREE</tt></span></td><td> An object used to represent hierarchical information to the user
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_TREE_TABLE</tt></span></td><td> An object capable of expanding and collapsing rows as well as showing multiple columns of data
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_UNKNOWN</tt></span></td><td> The object contains some Accessible information, but its role is not known
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_VIEWPORT</tt></span></td><td> An object usually used in a scroll pane
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_WINDOW</tt></span></td><td> A top level window with no title or border.
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_HEADER</tt></span></td><td> An object that serves as a document header.
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_FOOTER</tt></span></td><td> An object that serves as a document footer.
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_PARAGRAPH</tt></span></td><td> An object which is contains a paragraph of text content.
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_RULER</tt></span></td><td> An object which describes margins and tab stops, etc. for text objects which it controls (should have CONTROLLER_FOR relation to such).
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_APPLICATION</tt></span></td><td> The object is an application object, which may contain <i><tt>ATK_ROLE_FRAME</tt></i> objects or other types of accessibles.
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_AUTOCOMPLETE</tt></span></td><td> 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.
</td></tr><tr><td><span class="term"><tt>ATK_ROLE_LAST_DEFINED</tt></span></td><td> not a valid role, used for finding end of enumeration
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="atk-role-register"></a>atk_role_register ()</h3><a class="indexterm" name="id277457"></a><pre class="programlisting"><a href="AtkObject.html#AtkRole">AtkRole</a>     atk_role_register               (const gchar *name);</pre><p>
Registers the role specified by <i><tt>name</tt></i>.</p><p>

</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>name</tt></i>