Accessible

The #GtkAccessible class is the base class for accessible implementations for #GtkWidget subclasses. It is a thin wrapper around #AtkObject, which adds facilities for associating a widget with its accessible object.

An accessible implementation for a third-party widget should derive from #GtkAccessible and implement the suitable interfaces from ATK, such as #AtkText or #AtkSelection. To establish the connection between the widget class and its corresponding acccessible implementation, override the get_accessible vfunc in #GtkWidgetClass.

Constructors

this
this(GtkAccessible* gtkAccessible, bool ownedRef)

Sets our main struct and passes it to the parent class.

Members

Functions

connectWidgetDestroyed
void connectWidgetDestroyed()

This function specifies the callback function to be called when the widget corresponding to a GtkAccessible is destroyed.

getAccessibleStruct
GtkAccessible* getAccessibleStruct()

Get the main Gtk struct

getStruct
void* getStruct()

the main Gtk struct as a void*

getWidget
Widget getWidget()

Gets the #GtkWidget corresponding to the #GtkAccessible. The returned widget does not have a reference added, so you do not need to unref it.

setStruct
void setStruct(GObject* obj)
Undocumented in source. Be warned that the author may not have intended to support it.
setWidget
void setWidget(Widget widget)

Sets the #GtkWidget corresponding to the #GtkAccessible.

Static functions

getType
GType getType()

Variables

gtkAccessible
GtkAccessible* gtkAccessible;

the main Gtk struct

Inherited Members

From ObjectAtk

atkObject
AtkObject* atkObject;

the main Gtk struct

getObjectAtkStruct
AtkObject* getObjectAtkStruct()

Get the main Gtk struct

getStruct
void* getStruct()

the main Gtk struct as a void*

setStruct
void setStruct(GObject* obj)
Undocumented in source. Be warned that the author may not have intended to support it.
getType
GType getType()
addRelationship
bool addRelationship(AtkRelationType relationship, ObjectAtk target)

Adds a relationship of the specified type with the specified target.

connectPropertyChangeHandler
uint connectPropertyChangeHandler(AtkPropertyChangeHandler* handler)
getAttributes
AtkAttributeSet* getAttributes()

Get a list of properties applied to this object as a whole, as an #AtkAttributeSet consisting of name-value pairs. As such these attributes may be considered weakly-typed properties or annotations, as distinct from strongly-typed object data available via other get/set methods. Not all objects have explicit "name-value pair" #AtkAttributeSet properties.

getDescription
string getDescription()

Gets the accessible description of the accessible.

getIndexInParent
int getIndexInParent()

Gets the 0-based index of this accessible in its parent; returns -1 if the accessible does not have an accessible parent.

getLayer
AtkLayer getLayer()

Gets the layer of the accessible.

getMdiZorder
int getMdiZorder()

Gets the zorder of the accessible. The value G_MININT will be returned if the layer of the accessible is not ATK_LAYER_MDI.

getNAccessibleChildren
int getNAccessibleChildren()

Gets the number of accessible children of the accessible.

getName
string getName()

Gets the accessible name of the accessible.

getObjectLocale
string getObjectLocale()

Gets a UTF-8 string indicating the POSIX-style LC_MESSAGES locale of @accessible.

getParent
ObjectAtk getParent()

Gets the accessible parent of the accessible. By default this is the one assigned with atk_object_set_parent(), but it is assumed that ATK implementors have ways to get the parent of the object without the need of assigning it manually with atk_object_set_parent(), and will return it with this method.

getRole
AtkRole getRole()

Gets the role of the accessible.

initialize
void initialize(void* data)

This function is called when implementing subclasses of #AtkObject. It does initialization required for the new object. It is intended that this function should called only in the ..._new() functions used to create an instance of a subclass of #AtkObject

notifyStateChange
void notifyStateChange(AtkState state, bool value)

Emits a state-change signal for the specified state.

peekParent
ObjectAtk peekParent()

Gets the accessible parent of the accessible, if it has been manually assigned with atk_object_set_parent. Otherwise, this function returns %NULL.

refAccessibleChild
ObjectAtk refAccessibleChild(int i)

Gets a reference to the specified accessible child of the object. The accessible children are 0-based so the first accessible child is at index 0, the second at index 1 and so on.

refRelationSet
RelationSet refRelationSet()

Gets the #AtkRelationSet associated with the object.

refStateSet
StateSet refStateSet()

Gets a reference to the state set of the accessible; the caller must unreference it when it is no longer needed.

removePropertyChangeHandler
void removePropertyChangeHandler(uint handlerId)
removeRelationship
bool removeRelationship(AtkRelationType relationship, ObjectAtk target)

Removes a relationship of the specified type with the specified target.

setDescription
void setDescription(string description)

Sets the accessible description of the accessible. You can't set the description to NULL. This is reserved for the initial value. In this aspect NULL is similar to ATK_ROLE_UNKNOWN. If you want to set the name to a empty value you can use "".

setName
void setName(string name)

Sets the accessible name of the accessible. You can't set the name to NULL. This is reserved for the initial value. In this aspect NULL is similar to ATK_ROLE_UNKNOWN. If you want to set the name to a empty value you can use "".

setParent
void setParent(ObjectAtk parent)

Sets the accessible parent of the accessible. @parent can be NULL.

setRole
void setRole(AtkRole role)

Sets the role of the accessible.

connectedSignals
int[string] connectedSignals;
Undocumented in source.
onActiveDescendantChangedListeners
void delegate(void*, ObjectAtk)[] onActiveDescendantChangedListeners;
Undocumented in source.
addOnActiveDescendantChanged
void addOnActiveDescendantChanged(void delegate(void*, ObjectAtk) dlg, ConnectFlags connectFlags)

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

callBackActiveDescendantChanged
void callBackActiveDescendantChanged(AtkObject* objectatkStruct, void* arg1, ObjectAtk _objectatk)
Undocumented in source. Be warned that the author may not have intended to support it.
onChildrenChangedListeners
void delegate(uint, void*, ObjectAtk)[] onChildrenChangedListeners;
Undocumented in source.
addOnChildrenChanged
void addOnChildrenChanged(void delegate(uint, void*, ObjectAtk) dlg, ConnectFlags connectFlags)

The signal "children-changed" is emitted when a child is added or removed form an object. It supports two details: "add" and "remove"

callBackChildrenChanged
void callBackChildrenChanged(AtkObject* objectatkStruct, uint arg1, void* arg2, ObjectAtk _objectatk)
Undocumented in source. Be warned that the author may not have intended to support it.
onFocusListeners
void delegate(bool, ObjectAtk)[] onFocusListeners;
Undocumented in source.
addOnFocus
void addOnFocus(void delegate(bool, ObjectAtk) dlg, ConnectFlags connectFlags)

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

callBackFocus
void callBackFocus(AtkObject* objectatkStruct, bool arg1, ObjectAtk _objectatk)
Undocumented in source. Be warned that the author may not have intended to support it.
onPropertyChangeListeners
void delegate(void*, ObjectAtk)[] onPropertyChangeListeners;
Undocumented in source.
addOnPropertyChange
void addOnPropertyChange(void delegate(void*, ObjectAtk) dlg, ConnectFlags connectFlags)

The signal "property-change" is emitted when an object's property value changes. @arg1 contains an #AtkPropertyValues with the name and the new value of the property whose value has changed. Note that, as with GObject notify, getting this signal does not guarantee that the value of the property has actually changed; it may also be emitted when the setter of the property is called to reinstate the previous value.

callBackPropertyChange
void callBackPropertyChange(AtkObject* objectatkStruct, void* arg1, ObjectAtk _objectatk)
Undocumented in source. Be warned that the author may not have intended to support it.
onStateChangeListeners
void delegate(string, bool, ObjectAtk)[] onStateChangeListeners;
Undocumented in source.
addOnStateChange
void addOnStateChange(void delegate(string, bool, ObjectAtk) dlg, ConnectFlags connectFlags)

The "state-change" signal is emitted when an object's state changes. The detail value identifies the state type which has changed.

callBackStateChange
void callBackStateChange(AtkObject* objectatkStruct, char* arg1, bool arg2, ObjectAtk _objectatk)
Undocumented in source. Be warned that the author may not have intended to support it.
onVisibleDataChangedListeners
void delegate(ObjectAtk)[] onVisibleDataChangedListeners;
Undocumented in source.
addOnVisibleDataChanged
void addOnVisibleDataChanged(void delegate(ObjectAtk) dlg, ConnectFlags connectFlags)

The "visible-data-changed" signal is emitted when the visual appearance of the object changed.

callBackVisibleDataChanged
void callBackVisibleDataChanged(AtkObject* objectatkStruct, ObjectAtk _objectatk)
Undocumented in source. Be warned that the author may not have intended to support it.
roleForName
AtkRole roleForName(string name)

Get the #AtkRole type corresponding to a rolew name.

roleGetLocalizedName
string roleGetLocalizedName(AtkRole role)

Gets the localized description string describing the #AtkRole @role.

roleGetName
string roleGetName(AtkRole role)

Gets the description string describing the #AtkRole @role.

roleRegister
AtkRole roleRegister(string name)

Registers the role specified by @name. @name must be a meaningful name. So it should not be empty, or consisting on whitespaces.

Meta