AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
d0abe5a919
gtk2/gtk/gtkaccessiblevalueprivate.h

157 lines
8.3 KiB
C
Raw Normal View History

Add GtkAccessibleValue All accessible properties and states may have one of the following types: - true/false - true/false/undefined - true/false/mixed/undefined - reference (to another UI element) - reference list - integer - number (real numerical value) - string - token (one of a limited set of allowed values) - token list See: https://www.w3.org/WAI/PF/aria/states_and_properties#propcharacteristic_value The GtkAccessibleValue is a simple reference counted type that can be "subclassed" to implement each value type. This initial commit adds GtkAccessibleValue and the basic subclasses for plain boolean, tristate (true/false/undefined), and token types, including statically allocated values that can be shared instead of allocated.
2020-07-08 15:34:32 +00:00
/* gtkaccessiblevalueprivate.h: Accessible value
*
* Copyright 2020 GNOME Foundation
*
* SPDX-License-Identifier: LGPL-2.1-or-later
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, see <http://www.gnu.org/licenses/>.
*/
#pragma once
#include <glib-object.h>
Add accessible properties to GtkAccessible We propagate the accessible state and properties to each ATContext in the same virtual function, since they are functionally similar.
2020-07-13 14:51:39 +00:00
#include "gtkaccessible.h"
Add GtkAccessibleValue All accessible properties and states may have one of the following types: - true/false - true/false/undefined - true/false/mixed/undefined - reference (to another UI element) - reference list - integer - number (real numerical value) - string - token (one of a limited set of allowed values) - token list See: https://www.w3.org/WAI/PF/aria/states_and_properties#propcharacteristic_value The GtkAccessibleValue is a simple reference counted type that can be "subclassed" to implement each value type. This initial commit adds GtkAccessibleValue and the basic subclasses for plain boolean, tristate (true/false/undefined), and token types, including statically allocated values that can be shared instead of allocated.
2020-07-08 15:34:32 +00:00
#include "gtkenums.h"
G_BEGIN_DECLS
#define GTK_TYPE_ACCESSIBLE_VALUE (gtk_accessible_value_get_type())
#define GTK_ACCESSIBLE_VALUE_ERROR (gtk_accessible_value_error_quark())
typedef struct _GtkAccessibleValue GtkAccessibleValue;
typedef struct _GtkAccessibleValueClass GtkAccessibleValueClass;
a11y: Simplify GtkAccessibleValue Reduce the amount of subclassing, by handling collection of fundamental types directly from the generic code paths. We now handle boolean, tristate, integer, number, string, and relation values in the generic code path; if an attribute supports the "undefined" value, we return the undefined value singleton.
2020-07-16 17:08:22 +00:00
typedef enum {
GTK_ACCESSIBLE_VALUE_TYPE_UNDEFINED,
GTK_ACCESSIBLE_VALUE_TYPE_BOOLEAN,
GTK_ACCESSIBLE_VALUE_TYPE_TRISTATE,
GTK_ACCESSIBLE_VALUE_TYPE_TOKEN,
GTK_ACCESSIBLE_VALUE_TYPE_INTEGER,
GTK_ACCESSIBLE_VALUE_TYPE_NUMBER,
GTK_ACCESSIBLE_VALUE_TYPE_STRING,
a11y: Allow storing list of references in GtkAccessibleValue It's one of the fundamental accessible value types in ARIA.
2020-07-22 12:07:36 +00:00
GTK_ACCESSIBLE_VALUE_TYPE_REFERENCE,
GTK_ACCESSIBLE_VALUE_TYPE_REFERENCE_LIST
a11y: Simplify GtkAccessibleValue Reduce the amount of subclassing, by handling collection of fundamental types directly from the generic code paths. We now handle boolean, tristate, integer, number, string, and relation values in the generic code path; if an attribute supports the "undefined" value, we return the undefined value singleton.
2020-07-16 17:08:22 +00:00
} GtkAccessibleValueType;
Add GtkAccessibleValue All accessible properties and states may have one of the following types: - true/false - true/false/undefined - true/false/mixed/undefined - reference (to another UI element) - reference list - integer - number (real numerical value) - string - token (one of a limited set of allowed values) - token list See: https://www.w3.org/WAI/PF/aria/states_and_properties#propcharacteristic_value The GtkAccessibleValue is a simple reference counted type that can be "subclassed" to implement each value type. This initial commit adds GtkAccessibleValue and the basic subclasses for plain boolean, tristate (true/false/undefined), and token types, including statically allocated values that can be shared instead of allocated.
2020-07-08 15:34:32 +00:00
struct _GtkAccessibleValue
{
const GtkAccessibleValueClass *value_class;
int ref_count;
};
a11y: Simplify GtkAccessibleValue Reduce the amount of subclassing, by handling collection of fundamental types directly from the generic code paths. We now handle boolean, tristate, integer, number, string, and relation values in the generic code path; if an attribute supports the "undefined" value, we return the undefined value singleton.
2020-07-16 17:08:22 +00:00
#define GTK_ACCESSIBLE_VALUE_INIT(klass) { .value_class = (klass), .ref_count = 1 }
Add GtkAccessibleValue All accessible properties and states may have one of the following types: - true/false - true/false/undefined - true/false/mixed/undefined - reference (to another UI element) - reference list - integer - number (real numerical value) - string - token (one of a limited set of allowed values) - token list See: https://www.w3.org/WAI/PF/aria/states_and_properties#propcharacteristic_value The GtkAccessibleValue is a simple reference counted type that can be "subclassed" to implement each value type. This initial commit adds GtkAccessibleValue and the basic subclasses for plain boolean, tristate (true/false/undefined), and token types, including statically allocated values that can be shared instead of allocated.
2020-07-08 15:34:32 +00:00
struct _GtkAccessibleValueClass
{
a11y: Simplify GtkAccessibleValue Reduce the amount of subclassing, by handling collection of fundamental types directly from the generic code paths. We now handle boolean, tristate, integer, number, string, and relation values in the generic code path; if an attribute supports the "undefined" value, we return the undefined value singleton.
2020-07-16 17:08:22 +00:00
GtkAccessibleValueType type;
Add GtkAccessibleValue All accessible properties and states may have one of the following types: - true/false - true/false/undefined - true/false/mixed/undefined - reference (to another UI element) - reference list - integer - number (real numerical value) - string - token (one of a limited set of allowed values) - token list See: https://www.w3.org/WAI/PF/aria/states_and_properties#propcharacteristic_value The GtkAccessibleValue is a simple reference counted type that can be "subclassed" to implement each value type. This initial commit adds GtkAccessibleValue and the basic subclasses for plain boolean, tristate (true/false/undefined), and token types, including statically allocated values that can be shared instead of allocated.
2020-07-08 15:34:32 +00:00
const char *type_name;
gsize instance_size;
void (* init) (GtkAccessibleValue *self);
void (* finalize) (GtkAccessibleValue *self);
void (* print) (const GtkAccessibleValue *self,
GString *string);
gboolean (* equal) (const GtkAccessibleValue *value_a,
const GtkAccessibleValue *value_b);
};
a11y: Simplify GtkAccessibleValue Reduce the amount of subclassing, by handling collection of fundamental types directly from the generic code paths. We now handle boolean, tristate, integer, number, string, and relation values in the generic code path; if an attribute supports the "undefined" value, we return the undefined value singleton.
2020-07-16 17:08:22 +00:00
#define GTK_IS_ACCESSIBLE_VALUE_TYPE(v,type) \
((v)->value_class->type == (type))
Add GtkAccessibleValue All accessible properties and states may have one of the following types: - true/false - true/false/undefined - true/false/mixed/undefined - reference (to another UI element) - reference list - integer - number (real numerical value) - string - token (one of a limited set of allowed values) - token list See: https://www.w3.org/WAI/PF/aria/states_and_properties#propcharacteristic_value The GtkAccessibleValue is a simple reference counted type that can be "subclassed" to implement each value type. This initial commit adds GtkAccessibleValue and the basic subclasses for plain boolean, tristate (true/false/undefined), and token types, including statically allocated values that can be shared instead of allocated.
2020-07-08 15:34:32 +00:00
typedef enum {
GTK_ACCESSIBLE_VALUE_ERROR_READ_ONLY,
GTK_ACCESSIBLE_VALUE_ERROR_INVALID_VALUE,
GTK_ACCESSIBLE_VALUE_ERROR_INVALID_RANGE,
GTK_ACCESSIBLE_VALUE_ERROR_INVALID_TOKEN
} GtkAccessibleValueError;
GType gtk_accessible_value_get_type (void) G_GNUC_CONST;
GQuark gtk_accessible_value_error_quark (void);
GtkAccessibleValue * gtk_accessible_value_alloc (const GtkAccessibleValueClass *klass);
GtkAccessibleValue * gtk_accessible_value_ref (GtkAccessibleValue *self);
void gtk_accessible_value_unref (GtkAccessibleValue *self);
void gtk_accessible_value_print (const GtkAccessibleValue *self,
GString *buffer);
char * gtk_accessible_value_to_string (const GtkAccessibleValue *self);
gboolean gtk_accessible_value_equal (const GtkAccessibleValue *value_a,
const GtkAccessibleValue *value_b);
GtkAccessibleValue * gtk_accessible_value_get_default_for_state (GtkAccessibleState state);
GtkAccessibleValue * gtk_accessible_value_collect_for_state (GtkAccessibleState state,
a11y: Add proper error reporting to value collection We're currently overloading NULL to mean both "this value is undefined, and should be reset to its default" and "the value collection failed". Let's do error reporting right, by using GError to mean "the collection failed, for this specific reason"; then, we can use a NULL return value to signal that the accessible attribute should be reset to its default value. This is only relevant for pointer-sized attribute values: strings, references, and reference lists; numeric, boolean, tristate, and token values either cannot be undefined, or have a specific "undefined" value.
2020-07-28 15:41:44 +00:00
GError **error,
Add GtkAccessibleValue All accessible properties and states may have one of the following types: - true/false - true/false/undefined - true/false/mixed/undefined - reference (to another UI element) - reference list - integer - number (real numerical value) - string - token (one of a limited set of allowed values) - token list See: https://www.w3.org/WAI/PF/aria/states_and_properties#propcharacteristic_value The GtkAccessibleValue is a simple reference counted type that can be "subclassed" to implement each value type. This initial commit adds GtkAccessibleValue and the basic subclasses for plain boolean, tristate (true/false/undefined), and token types, including statically allocated values that can be shared instead of allocated.
2020-07-08 15:34:32 +00:00
va_list *args);
GtkAccessibleValue * gtk_accessible_value_collect_for_state_value (GtkAccessibleState state,
a11y: Add proper error reporting to value collection We're currently overloading NULL to mean both "this value is undefined, and should be reset to its default" and "the value collection failed". Let's do error reporting right, by using GError to mean "the collection failed, for this specific reason"; then, we can use a NULL return value to signal that the accessible attribute should be reset to its default value. This is only relevant for pointer-sized attribute values: strings, references, and reference lists; numeric, boolean, tristate, and token values either cannot be undefined, or have a specific "undefined" value.
2020-07-28 15:41:44 +00:00
const GValue *value,
GError **error);
Add GtkAccessibleValue All accessible properties and states may have one of the following types: - true/false - true/false/undefined - true/false/mixed/undefined - reference (to another UI element) - reference list - integer - number (real numerical value) - string - token (one of a limited set of allowed values) - token list See: https://www.w3.org/WAI/PF/aria/states_and_properties#propcharacteristic_value The GtkAccessibleValue is a simple reference counted type that can be "subclassed" to implement each value type. This initial commit adds GtkAccessibleValue and the basic subclasses for plain boolean, tristate (true/false/undefined), and token types, including statically allocated values that can be shared instead of allocated.
2020-07-08 15:34:32 +00:00
Plumb all the GtkAccessibleProperty values into GtkAccessibleValue Similarly to how we deal with GtkAccessibleState.
2020-07-13 14:22:24 +00:00
GtkAccessibleValue * gtk_accessible_value_get_default_for_property (GtkAccessibleProperty property);
GtkAccessibleValue * gtk_accessible_value_collect_for_property (GtkAccessibleProperty property,
a11y: Add proper error reporting to value collection We're currently overloading NULL to mean both "this value is undefined, and should be reset to its default" and "the value collection failed". Let's do error reporting right, by using GError to mean "the collection failed, for this specific reason"; then, we can use a NULL return value to signal that the accessible attribute should be reset to its default value. This is only relevant for pointer-sized attribute values: strings, references, and reference lists; numeric, boolean, tristate, and token values either cannot be undefined, or have a specific "undefined" value.
2020-07-28 15:41:44 +00:00
GError **error,
Plumb all the GtkAccessibleProperty values into GtkAccessibleValue Similarly to how we deal with GtkAccessibleState.
2020-07-13 14:22:24 +00:00
va_list *args);
GtkAccessibleValue * gtk_accessible_value_collect_for_property_value (GtkAccessibleProperty property,
a11y: Add proper error reporting to value collection We're currently overloading NULL to mean both "this value is undefined, and should be reset to its default" and "the value collection failed". Let's do error reporting right, by using GError to mean "the collection failed, for this specific reason"; then, we can use a NULL return value to signal that the accessible attribute should be reset to its default value. This is only relevant for pointer-sized attribute values: strings, references, and reference lists; numeric, boolean, tristate, and token values either cannot be undefined, or have a specific "undefined" value.
2020-07-28 15:41:44 +00:00
const GValue *value,
GError **error);
Plumb all the GtkAccessibleProperty values into GtkAccessibleValue Similarly to how we deal with GtkAccessibleState.
2020-07-13 14:22:24 +00:00
a11y: Add relations API Since we split relation attributes from the generic properties, we need to add API for setting and retrieving their values.
2020-07-17 11:00:31 +00:00
GtkAccessibleValue * gtk_accessible_value_get_default_for_relation (GtkAccessibleRelation relation);
GtkAccessibleValue * gtk_accessible_value_collect_for_relation (GtkAccessibleRelation relation,
a11y: Add proper error reporting to value collection We're currently overloading NULL to mean both "this value is undefined, and should be reset to its default" and "the value collection failed". Let's do error reporting right, by using GError to mean "the collection failed, for this specific reason"; then, we can use a NULL return value to signal that the accessible attribute should be reset to its default value. This is only relevant for pointer-sized attribute values: strings, references, and reference lists; numeric, boolean, tristate, and token values either cannot be undefined, or have a specific "undefined" value.
2020-07-28 15:41:44 +00:00
GError **error,
a11y: Add relations API Since we split relation attributes from the generic properties, we need to add API for setting and retrieving their values.
2020-07-17 11:00:31 +00:00
va_list *args);
GtkAccessibleValue * gtk_accessible_value_collect_for_relation_value (GtkAccessibleRelation relation,
a11y: Add proper error reporting to value collection We're currently overloading NULL to mean both "this value is undefined, and should be reset to its default" and "the value collection failed". Let's do error reporting right, by using GError to mean "the collection failed, for this specific reason"; then, we can use a NULL return value to signal that the accessible attribute should be reset to its default value. This is only relevant for pointer-sized attribute values: strings, references, and reference lists; numeric, boolean, tristate, and token values either cannot be undefined, or have a specific "undefined" value.
2020-07-28 15:41:44 +00:00
const GValue *value,
GError **error);
a11y: Add relations API Since we split relation attributes from the generic properties, we need to add API for setting and retrieving their values.
2020-07-17 11:00:31 +00:00
Plumb all the GtkAccessibleProperty values into GtkAccessibleValue Similarly to how we deal with GtkAccessibleState.
2020-07-13 14:22:24 +00:00
/* Basic values */
a11y: Resync with the ARIA spec Drop roles and properties that were deprecated in WAI-ARIA 1.1, and add new roles and properties defined in WAI-ARIA 1.2 and later. We also split the relationship properties into their own enumeration, so we can keep the GtkAccessibleProperty type more compact.
2020-07-15 18:08:37 +00:00
GtkAccessibleValue * gtk_undefined_accessible_value_new (void);
a11y: Simplify GtkAccessibleValue Reduce the amount of subclassing, by handling collection of fundamental types directly from the generic code paths. We now handle boolean, tristate, integer, number, string, and relation values in the generic code path; if an attribute supports the "undefined" value, we return the undefined value singleton.
2020-07-16 17:08:22 +00:00
int gtk_undefined_accessible_value_get (const GtkAccessibleValue *value);
a11y: Resync with the ARIA spec Drop roles and properties that were deprecated in WAI-ARIA 1.1, and add new roles and properties defined in WAI-ARIA 1.2 and later. We also split the relationship properties into their own enumeration, so we can keep the GtkAccessibleProperty type more compact.
2020-07-15 18:08:37 +00:00
Plumb all the GtkAccessibleProperty values into GtkAccessibleValue Similarly to how we deal with GtkAccessibleState.
2020-07-13 14:22:24 +00:00
GtkAccessibleValue * gtk_boolean_accessible_value_new (gboolean value);
gboolean gtk_boolean_accessible_value_get (const GtkAccessibleValue *value);
Add GtkAccessibleValue All accessible properties and states may have one of the following types: - true/false - true/false/undefined - true/false/mixed/undefined - reference (to another UI element) - reference list - integer - number (real numerical value) - string - token (one of a limited set of allowed values) - token list See: https://www.w3.org/WAI/PF/aria/states_and_properties#propcharacteristic_value The GtkAccessibleValue is a simple reference counted type that can be "subclassed" to implement each value type. This initial commit adds GtkAccessibleValue and the basic subclasses for plain boolean, tristate (true/false/undefined), and token types, including statically allocated values that can be shared instead of allocated.
2020-07-08 15:34:32 +00:00
a11y: Simplify GtkAccessibleValue Reduce the amount of subclassing, by handling collection of fundamental types directly from the generic code paths. We now handle boolean, tristate, integer, number, string, and relation values in the generic code path; if an attribute supports the "undefined" value, we return the undefined value singleton.
2020-07-16 17:08:22 +00:00
GtkAccessibleValue * gtk_tristate_accessible_value_new (GtkAccessibleTristate value);
GtkAccessibleTristate gtk_tristate_accessible_value_get (const GtkAccessibleValue *value);
Plumb all the GtkAccessibleProperty values into GtkAccessibleValue Similarly to how we deal with GtkAccessibleState.
2020-07-13 14:22:24 +00:00
GtkAccessibleValue * gtk_int_accessible_value_new (int value);
int gtk_int_accessible_value_get (const GtkAccessibleValue *value);
Add GtkAccessibleValue All accessible properties and states may have one of the following types: - true/false - true/false/undefined - true/false/mixed/undefined - reference (to another UI element) - reference list - integer - number (real numerical value) - string - token (one of a limited set of allowed values) - token list See: https://www.w3.org/WAI/PF/aria/states_and_properties#propcharacteristic_value The GtkAccessibleValue is a simple reference counted type that can be "subclassed" to implement each value type. This initial commit adds GtkAccessibleValue and the basic subclasses for plain boolean, tristate (true/false/undefined), and token types, including statically allocated values that can be shared instead of allocated.
2020-07-08 15:34:32 +00:00
Plumb all the GtkAccessibleProperty values into GtkAccessibleValue Similarly to how we deal with GtkAccessibleState.
2020-07-13 14:22:24 +00:00
GtkAccessibleValue * gtk_number_accessible_value_new (double value);
double gtk_number_accessible_value_get (const GtkAccessibleValue *value);
Add GtkAccessibleValue All accessible properties and states may have one of the following types: - true/false - true/false/undefined - true/false/mixed/undefined - reference (to another UI element) - reference list - integer - number (real numerical value) - string - token (one of a limited set of allowed values) - token list See: https://www.w3.org/WAI/PF/aria/states_and_properties#propcharacteristic_value The GtkAccessibleValue is a simple reference counted type that can be "subclassed" to implement each value type. This initial commit adds GtkAccessibleValue and the basic subclasses for plain boolean, tristate (true/false/undefined), and token types, including statically allocated values that can be shared instead of allocated.
2020-07-08 15:34:32 +00:00
Plumb all the GtkAccessibleProperty values into GtkAccessibleValue Similarly to how we deal with GtkAccessibleState.
2020-07-13 14:22:24 +00:00
GtkAccessibleValue * gtk_string_accessible_value_new (const char *value);
const char * gtk_string_accessible_value_get (const GtkAccessibleValue *value);
Add GtkAccessibleValue All accessible properties and states may have one of the following types: - true/false - true/false/undefined - true/false/mixed/undefined - reference (to another UI element) - reference list - integer - number (real numerical value) - string - token (one of a limited set of allowed values) - token list See: https://www.w3.org/WAI/PF/aria/states_and_properties#propcharacteristic_value The GtkAccessibleValue is a simple reference counted type that can be "subclassed" to implement each value type. This initial commit adds GtkAccessibleValue and the basic subclasses for plain boolean, tristate (true/false/undefined), and token types, including statically allocated values that can be shared instead of allocated.
2020-07-08 15:34:32 +00:00
Add accessible properties to GtkAccessible We propagate the accessible state and properties to each ATContext in the same virtual function, since they are functionally similar.
2020-07-13 14:51:39 +00:00
GtkAccessibleValue * gtk_reference_accessible_value_new (GtkAccessible *value);
GtkAccessible * gtk_reference_accessible_value_get (const GtkAccessibleValue *value);
a11y: Allow storing list of references in GtkAccessibleValue It's one of the fundamental accessible value types in ARIA.
2020-07-22 12:07:36 +00:00
GtkAccessibleValue * gtk_reference_list_accessible_value_new (GList *value);
GList * gtk_reference_list_accessible_value_get (const GtkAccessibleValue *value);
Plumb all the GtkAccessibleProperty values into GtkAccessibleValue Similarly to how we deal with GtkAccessibleState.
2020-07-13 14:22:24 +00:00
/* Token values */
GtkAccessibleValue * gtk_invalid_accessible_value_new (GtkAccessibleInvalidState value);
Add GtkAccessibleValue All accessible properties and states may have one of the following types: - true/false - true/false/undefined - true/false/mixed/undefined - reference (to another UI element) - reference list - integer - number (real numerical value) - string - token (one of a limited set of allowed values) - token list See: https://www.w3.org/WAI/PF/aria/states_and_properties#propcharacteristic_value The GtkAccessibleValue is a simple reference counted type that can be "subclassed" to implement each value type. This initial commit adds GtkAccessibleValue and the basic subclasses for plain boolean, tristate (true/false/undefined), and token types, including statically allocated values that can be shared instead of allocated.
2020-07-08 15:34:32 +00:00
GtkAccessibleInvalidState gtk_invalid_accessible_value_get (const GtkAccessibleValue *value);
Plumb all the GtkAccessibleProperty values into GtkAccessibleValue Similarly to how we deal with GtkAccessibleState.
2020-07-13 14:22:24 +00:00
GtkAccessibleValue * gtk_autocomplete_accessible_value_new (GtkAccessibleAutocomplete value);
GtkAccessibleAutocomplete gtk_autocomplete_accessible_value_get (const GtkAccessibleValue *value);
GtkAccessibleValue * gtk_orientation_accessible_value_new (GtkOrientation value);
GtkOrientation gtk_orientation_accessible_value_get (const GtkAccessibleValue *value);
GtkAccessibleValue * gtk_sort_accessible_value_new (GtkAccessibleSort value);
GtkAccessibleSort gtk_sort_accessible_value_get (const GtkAccessibleValue *value);
Add GtkAccessibleValue All accessible properties and states may have one of the following types: - true/false - true/false/undefined - true/false/mixed/undefined - reference (to another UI element) - reference list - integer - number (real numerical value) - string - token (one of a limited set of allowed values) - token list See: https://www.w3.org/WAI/PF/aria/states_and_properties#propcharacteristic_value The GtkAccessibleValue is a simple reference counted type that can be "subclassed" to implement each value type. This initial commit adds GtkAccessibleValue and the basic subclasses for plain boolean, tristate (true/false/undefined), and token types, including statically allocated values that can be shared instead of allocated.
2020-07-08 15:34:32 +00:00
G_END_DECLS
Reference in New Issue Copy Permalink