From 5c997b3aaac6277b8c4965ee8e90d05e1959ac05 Mon Sep 17 00:00:00 2001 From: Lukasz Stanislawski Date: Wed, 1 Nov 2017 21:31:46 +0900 Subject: [PATCH] elm: mark access interfaces as beta Subscribers: cedric, jpeg Differential Revision: https://phab.enlightenment.org/D5365 --- src/lib/elementary/efl_access.eo | 40 +++++++++---------- src/lib/elementary/efl_access_component.c | 1 + src/lib/elementary/efl_access_component.eo | 18 ++++----- .../elementary/efl_access_editable_text.eo | 12 +++--- src/lib/elementary/efl_access_image.eo | 6 +-- src/lib/elementary/efl_access_selection.eo | 16 ++++---- src/lib/elementary/efl_access_text.eo | 32 +++++++-------- src/lib/elementary/efl_access_value.eo | 6 +-- src/lib/elementary/elementary_config.h | 7 ++++ 9 files changed, 73 insertions(+), 65 deletions(-) diff --git a/src/lib/elementary/efl_access.eo b/src/lib/elementary/efl_access.eo index 01a1b4abe2..0ae001a433 100644 --- a/src/lib/elementary/efl_access.eo +++ b/src/lib/elementary/efl_access.eo @@ -241,7 +241,7 @@ mixin Efl.Access (Efl.Interface, Efl.Object) eo_prefix: efl_access; data: Efl_Access_Data; methods { - @property localized_role_name @protected { + @property localized_role_name @protected @beta { [[Gets an localized string describing accessible object role name.]] get { } @@ -249,7 +249,7 @@ mixin Efl.Access (Efl.Interface, Efl.Object) localized_name: string; [[Localized accessible object role name]] } } - @property name { + @property name @beta { [[Accessible name of the object.]] get { } @@ -259,7 +259,7 @@ mixin Efl.Access (Efl.Interface, Efl.Object) name: string; [[Accessible name]] } } - @property relation_set @protected { + @property relation_set @protected @beta { [[Gets an all relations between accessible object and other accessible objects.]] get { } @@ -267,7 +267,7 @@ mixin Efl.Access (Efl.Interface, Efl.Object) relations: Efl.Access.Relation_Set; [[Accessible relation set]] } } - @property role { + @property role @beta { [[The role of the object in accessibility domain.]] get { } @@ -277,7 +277,7 @@ mixin Efl.Access (Efl.Interface, Efl.Object) role: Efl.Access.Role; [[Accessible role]] } } - @property children @protected { + @property children @protected @beta { [[Gets object's accessible children.]] get { } @@ -285,7 +285,7 @@ mixin Efl.Access (Efl.Interface, Efl.Object) children: list @owned; [[List of widget's children]] } } - @property role_name @protected { + @property role_name @protected @beta { [[Gets human-readable string indentifying object accessibility role.]] get { } @@ -293,7 +293,7 @@ mixin Efl.Access (Efl.Interface, Efl.Object) role_name: string; [[Accessible role name]] } } - @property attributes @protected { + @property attributes @protected @beta { [[Gets key-value pairs indentifying object extra attributes. Must be free by a user.]] get { } @@ -302,7 +302,7 @@ mixin Efl.Access (Efl.Interface, Efl.Object) attributes: list @owned; [[List of object attributes]] } } - @property index_in_parent @protected { + @property index_in_parent @protected @beta { [[Gets index of the child in parent's children list.]] get { } @@ -310,7 +310,7 @@ mixin Efl.Access (Efl.Interface, Efl.Object) idx: int; [[Index in children list]] } } - @property description { + @property description @beta { [[Contextual information about object.]] get { } @@ -320,7 +320,7 @@ mixin Efl.Access (Efl.Interface, Efl.Object) description: string; [[Accessible contextual information]] } } - @property parent { + @property parent @beta { [[Object's accessible parent.]] get { } @@ -330,7 +330,7 @@ mixin Efl.Access (Efl.Interface, Efl.Object) parent: Efl.Access; [[Accessible parent]] } } - @property state_set @protected { + @property state_set @protected @beta { [[Gets set describing object accessible states.]] get { } @@ -338,7 +338,7 @@ mixin Efl.Access (Efl.Interface, Efl.Object) states: Efl.Access.State_Set; [[Accessible state set]] } } - event_handler_add @class @protected { + event_handler_add @class @protected @beta { [[Register accessibility event listener]] params { @in cb: Efl_Event_Cb; [[Callback]] @@ -346,13 +346,13 @@ mixin Efl.Access (Efl.Interface, Efl.Object) } return: ptr(Efl.Access.Event.Handler); [[Event handler]] } - event_handler_del @class @protected { + event_handler_del @class @protected @beta { [[Deregister accessibility event listener]] params { @in handler: ptr(Efl.Access.Event.Handler); [[Event handler]] } } - event_emit @class @protected { + event_emit @class @protected @beta { [[Emit event]] params { @in accessible: Efl.Access; [[Accessibility object.]] @@ -360,7 +360,7 @@ mixin Efl.Access (Efl.Interface, Efl.Object) @in event_info: void_ptr; [[Accessibility event details.]] } } - @property translation_domain { + @property translation_domain @beta { [[The translation domain of "name" and "description" properties. @@ -382,7 +382,7 @@ mixin Efl.Access (Efl.Interface, Efl.Object) domain: string; [[Translation domain]] } } - @property type { + @property type @beta { [[Type of accessibility object]] get { } @@ -392,7 +392,7 @@ mixin Efl.Access (Efl.Interface, Efl.Object) type: Efl.Access.Type; [[Object type]] } } - relationship_append { + relationship_append @beta { [[Defines the relationship between two accessible objects. Adds unique relation between source object and relation_object of a @@ -411,7 +411,7 @@ mixin Efl.Access (Efl.Interface, Efl.Object) @in relation_object: const(Efl.Access); [[Object to relate to]] } } - relationship_remove { + relationship_remove @beta { [[Removes the relationship between two accessible objects. If relation_object is NULL function removes all relations @@ -422,10 +422,10 @@ mixin Efl.Access (Efl.Interface, Efl.Object) @in relation_object: const(Efl.Access); [[Object to remove relation from]] } } - relationships_clear { + relationships_clear @beta { [[Removes all relationships in accessible object.]] } - @property root @class { + @property root @class @beta { get { [[Get root object of accessible object hierarchy]] values { diff --git a/src/lib/elementary/efl_access_component.c b/src/lib/elementary/efl_access_component.c index abc72ef3dd..c53c51f294 100644 --- a/src/lib/elementary/efl_access_component.c +++ b/src/lib/elementary/efl_access_component.c @@ -3,6 +3,7 @@ #endif #define EFL_ACCESS_COMPONENT_PROTECTED +#define EFL_ACCESS_COMPONENT_BETA #define EFL_ACCESS_PROTECTED #include diff --git a/src/lib/elementary/efl_access_component.eo b/src/lib/elementary/efl_access_component.eo index dd4d5e4b1f..c6f6964eea 100644 --- a/src/lib/elementary/efl_access_component.eo +++ b/src/lib/elementary/efl_access_component.eo @@ -5,7 +5,7 @@ mixin Efl.Access.Component () [[AT-SPI component mixin]] data: null; methods { - @property size @protected { + @property size @protected @beta { [[Size of accessible widget.]] set { return: bool; [[$true if size was set, $false otherwise]] @@ -17,7 +17,7 @@ mixin Efl.Access.Component () h: int; [[Height of the widget]] } } - @property layer @protected { + @property layer @protected @beta { [[Evas layer of accessible widget.]] get { } @@ -25,7 +25,7 @@ mixin Efl.Access.Component () layer: int; [[Evas layer of the widget]] } } - @property alpha @protected { + @property alpha @protected @beta { [[Gets alpha of accessible widget.]] get { } @@ -33,7 +33,7 @@ mixin Efl.Access.Component () alpha: double; [[Alpha value in [0, 1] range.]] } } - @property z_order @protected { + @property z_order @protected @beta { [[Gets the depth at which the component is shown in relation to other components in the same container.]] get { @@ -42,7 +42,7 @@ mixin Efl.Access.Component () z_order: int; [[Z order of component]] } } - @property extents @protected { + @property extents @protected @beta { [[Geometry of accessible widget.]] get { } @@ -57,7 +57,7 @@ mixin Efl.Access.Component () rect: Eina.Rect; [[The geometry.]] } } - @property position @protected { + @property position @protected @beta { [[Position of accessible widget.]] set { return: bool; [[$true if position was set, $false otherwise]] @@ -73,7 +73,7 @@ mixin Efl.Access.Component () y: int; [[Y coordinate]] } } - contains @protected { + contains @protected @beta { [[Contains accessible widget]] params { screen_coords: bool; [[If $true x and y values will be relative to @@ -83,13 +83,13 @@ mixin Efl.Access.Component () } return: bool; [[$true if params have been set, $false otherwise]] } - focus_grab @protected { + focus_grab @protected @beta { [[Focuses accessible widget.]] return: bool; [[$true if focus grab focus succeed, $false otherwise.]] } - accessible_at_point_get @protected { + accessible_at_point_get @protected @beta { [[Gets top component object occupying space at given coordinates.]] params { screen_coords: bool; [[If $true x and y values will be relative to diff --git a/src/lib/elementary/efl_access_editable_text.eo b/src/lib/elementary/efl_access_editable_text.eo index 21c823b3f0..14d8b280e8 100644 --- a/src/lib/elementary/efl_access_editable_text.eo +++ b/src/lib/elementary/efl_access_editable_text.eo @@ -2,7 +2,7 @@ interface Efl.Access.Editable.Text () { [[Elementary editable text interface]] methods { - @property content @protected { + @property content @protected @beta { [[Editable content property]] set { return: bool; [[$true if setting the value succeeded, $false otherwise]] @@ -11,7 +11,7 @@ interface Efl.Access.Editable.Text () string: string; [[Content]] } } - insert @protected { + insert @protected @beta { [[Insert text at given position]] params { @in string: string; [[String to be inserted]] @@ -19,7 +19,7 @@ interface Efl.Access.Editable.Text () } return: bool; [[$true if insert succeeded, $false otherwise]] } - copy @protected { + copy @protected @beta { [[Copy text between start and end parameter]] params { @in start: int; [[Start position to copy]] @@ -27,7 +27,7 @@ interface Efl.Access.Editable.Text () } return: bool; [[$true if copy succeeded, $false otherwise]] } - cut @protected { + cut @protected @beta { [[Cut text between start and end parameter]] params { @in start: int; [[Start position to cut]] @@ -35,7 +35,7 @@ interface Efl.Access.Editable.Text () } return: bool; [[$true if cut succeeded, $false otherwise]] } - delete @protected { + delete @protected @beta { [[Delete text between start and end parameter]] params { @in start: int; [[Start position to delete]] @@ -43,7 +43,7 @@ interface Efl.Access.Editable.Text () } return: bool; [[$true if delete succeeded, $false otherwise]] } - paste @protected { + paste @protected @beta { [[Paste text at given position]] params { @in position: int; [[Position to insert text]] diff --git a/src/lib/elementary/efl_access_image.eo b/src/lib/elementary/efl_access_image.eo index adfc607d02..1b06edae78 100644 --- a/src/lib/elementary/efl_access_image.eo +++ b/src/lib/elementary/efl_access_image.eo @@ -3,7 +3,7 @@ mixin Efl.Access.Image () [[Accessible image mixin]] data: null; methods { - @property extents @protected { + @property extents @protected @beta { [[Gets an image extents.]] get @pure_virtual { } @@ -17,7 +17,7 @@ mixin Efl.Access.Image () height: int; [[Image height]] } } - @property description @protected { + @property description @protected @beta { [[Textual description of image]] get { } @@ -27,7 +27,7 @@ mixin Efl.Access.Image () description: string; [[Textual image description]] } } - @property locale @protected { + @property locale @protected @beta { [[Gets locale of the image description.]] get { } diff --git a/src/lib/elementary/efl_access_selection.eo b/src/lib/elementary/efl_access_selection.eo index 174cf21b2e..f25b2c245b 100644 --- a/src/lib/elementary/efl_access_selection.eo +++ b/src/lib/elementary/efl_access_selection.eo @@ -2,13 +2,13 @@ interface Efl.Access.Selection () { [[Elementary access selection interface]] methods { - @property selected_children_count @protected { + @property selected_children_count @protected @beta { get { [[Gets the number of currently selected children]] return: int; [[Number of currently selected children]] } } - @property selected_child @protected { + @property selected_child @protected @beta { [[Gets child for given child index]] get { return: Efl.Object; [[Child object]] @@ -17,36 +17,36 @@ interface Efl.Access.Selection () selected_child_index: int; [[Index of child]] } } - child_select @protected { + child_select @protected @beta { [[Adds selection for given child index]] params { @in child_index: int; [[Index of child]] } return: bool; [[$true if selection was added, $false otherwise]] } - selected_child_deselect @protected { + selected_child_deselect @protected @beta { [[Removes selection for given child index]] params { @in child_index: int; [[Index of child]] } return: bool; [[$true if selection was removed, $false otherwise]] } - is_child_selected @protected { + is_child_selected @protected @beta { [[Determines if child specified by index is selected]] params { @in child_index: int; [[Index of child]] } return: bool; [[$true if child is selected, $false otherwise]] } - all_children_select @protected { + all_children_select @protected @beta { [[Adds selection for all children]] return: bool; [[$true if selection was added to all children, $false otherwise]] } - clear @protected { + clear @protected @beta { [[Clears the current selection]] return: bool; [[$true if selection was cleared, $false otherwise]] } - child_deselect @protected { + child_deselect @protected @beta { [[Removes selection for given child index]] params { @in child_index: int; [[Index of child]] diff --git a/src/lib/elementary/efl_access_text.eo b/src/lib/elementary/efl_access_text.eo index 871cb68fc2..2fd823025b 100644 --- a/src/lib/elementary/efl_access_text.eo +++ b/src/lib/elementary/efl_access_text.eo @@ -48,7 +48,7 @@ interface Efl.Access.Text () { [[Elementary accessible text interface]] methods { - @property character @protected { + @property character @protected @beta { get { [[Gets single character present in accessible widget's text at given offset.]] } @@ -59,7 +59,7 @@ interface Efl.Access.Text () character: Eina.Unicode; [[Character at offset. 0 when out-of bounds offset has been given. Codepoints between DC80 and DCFF indicates that string includes invalid UTF8 chars.]] } } - @property string @protected { + @property string @protected @beta { get { [[Gets string, start and end offset in text according to given initial offset and granularity.]] } @@ -72,7 +72,7 @@ interface Efl.Access.Text () string: mstring @owned; [[Newly allocated UTF-8 encoded string. Must be free by a user.]] } } - @property text @protected { + @property text @protected @beta { get { [[Gets text of accessible widget.]] } @@ -84,7 +84,7 @@ interface Efl.Access.Text () text: mstring @owned; [[UTF-8 encoded text.]] } } - @property caret_offset @protected { + @property caret_offset @protected @beta { [[Caret offset property]] get { [[Gets offset position of caret (cursor)]] @@ -96,7 +96,7 @@ interface Efl.Access.Text () offset: int; [[Offset]] } } - @property attribute @protected { + @property attribute @protected @beta { get { [[Indicate if a text attribute with a given name is set]] return: bool; [[$true if attribute name is set, $false otherwise]] @@ -110,7 +110,7 @@ interface Efl.Access.Text () value: mstring @owned; [[Value of text attribute. Should be free()]] } } - @property attributes @protected { + @property attributes @protected @beta { get { [[Gets list of all text attributes.]] } @@ -122,7 +122,7 @@ interface Efl.Access.Text () attributes: list @owned; [[List of text attributes]] } } - @property default_attributes @protected { + @property default_attributes @protected @beta { [[Default attributes]] get { } @@ -130,7 +130,7 @@ interface Efl.Access.Text () attributes: list @owned; [[List of default attributes]] } } - @property character_extents @protected { + @property character_extents @protected @beta { [[Character extents]] get { return: bool; [[$true if character extents, $false otherwise]] @@ -143,7 +143,7 @@ interface Efl.Access.Text () rect: Eina.Rect; [[Extents rectangle]] } } - @property character_count @protected { + @property character_count @protected @beta { [[Character count]] get { } @@ -151,7 +151,7 @@ interface Efl.Access.Text () count: int; [[Character count]] } } - @property offset_at_point @protected { + @property offset_at_point @protected @beta { [[Offset at given point]] get { } @@ -164,7 +164,7 @@ interface Efl.Access.Text () offset: int; [[Offset]] } } - @property bounded_ranges @protected { + @property bounded_ranges @protected @beta { [[Bounded ranges]] get { } @@ -178,7 +178,7 @@ interface Efl.Access.Text () ranges: list @owned; [[List of ranges]] } } - @property range_extents @protected { + @property range_extents @protected @beta { [[Range extents]] get { return: bool; [[$true if range extents, $false otherwise]] @@ -192,7 +192,7 @@ interface Efl.Access.Text () rect: Eina.Rect; [[Range rectangle]] } } - @property selections_count @protected { + @property selections_count @protected @beta { [[Selection count property]] get { } @@ -200,7 +200,7 @@ interface Efl.Access.Text () count: int; [[Selection counter]] } } - @property selection @protected { + @property selection @protected @beta { [[Selection property]] get { } @@ -215,7 +215,7 @@ interface Efl.Access.Text () end_offset: int; [[Selection end offset]] } } - selection_add @protected { + selection_add @protected @beta { [[Add selection]] params { @in start_offset: int; [[Start selection from this offset]] @@ -223,7 +223,7 @@ interface Efl.Access.Text () } return: bool; [[$true if selection was added, $false otherwise]] } - selection_remove @protected { + selection_remove @protected @beta { [[Remove selection]] params { @in selection_number: int; [[Selection number to be removed]] diff --git a/src/lib/elementary/efl_access_value.eo b/src/lib/elementary/efl_access_value.eo index c6c344496b..a1a8fea8f5 100644 --- a/src/lib/elementary/efl_access_value.eo +++ b/src/lib/elementary/efl_access_value.eo @@ -2,7 +2,7 @@ interface Efl.Access.Value () { [[Elementary Access value interface]] methods { - @property value_and_text @protected { + @property value_and_text @protected @beta { [[Value and text property]] get { [[Gets value displayed by a accessible widget.]] @@ -15,7 +15,7 @@ interface Efl.Access.Value () text: string; [[string describing value in given context eg. small, enough]] } } - @property range @protected { + @property range @protected @beta { get { [[Gets a range of all possible values and its description]] } @@ -25,7 +25,7 @@ interface Efl.Access.Value () description: string; [[Description of the range]] } } - @property increment @protected { + @property increment @protected @beta { get { [[Gets an minimal incrementation value]] } diff --git a/src/lib/elementary/elementary_config.h b/src/lib/elementary/elementary_config.h index ce1a00f338..459ebd0213 100644 --- a/src/lib/elementary/elementary_config.h +++ b/src/lib/elementary/elementary_config.h @@ -15,3 +15,10 @@ #define EFL_CANVAS_GROUP_BETA #define EFL_OBJECT_BETA #define EFL_OBJECT_PROTECTED +#define EFL_ACCESS_BETA +#define EFL_ACCESS_COMPONENT_BETA +#define EFL_ACCESS_EDITABLE_TEXT_BETA +#define EFL_ACCESS_IMAGE_BETA +#define EFL_ACCESS_SELECTION_BETA +#define EFL_ACCESS_TEXT_BETA +#define EFL_ACCESS_VALUE_BETA