|
Packit |
d0bcc1 |
/* ATK - Accessibility Toolkit
|
|
Packit |
d0bcc1 |
* Copyright 2001 Sun Microsystems Inc.
|
|
Packit |
d0bcc1 |
*
|
|
Packit |
d0bcc1 |
* This library is free software; you can redistribute it and/or
|
|
Packit |
d0bcc1 |
* modify it under the terms of the GNU Lesser General Public
|
|
Packit |
d0bcc1 |
* License as published by the Free Software Foundation; either
|
|
Packit |
d0bcc1 |
* version 2 of the License, or (at your option) any later version.
|
|
Packit |
d0bcc1 |
*
|
|
Packit |
d0bcc1 |
* This library is distributed in the hope that it will be useful,
|
|
Packit |
d0bcc1 |
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
Packit |
d0bcc1 |
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Packit |
d0bcc1 |
* Lesser General Public License for more details.
|
|
Packit |
d0bcc1 |
*
|
|
Packit |
d0bcc1 |
* You should have received a copy of the GNU Lesser General Public
|
|
Packit |
d0bcc1 |
* License along with this library; if not, write to the
|
|
Packit |
d0bcc1 |
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
Packit |
d0bcc1 |
* Boston, MA 02111-1307, USA.
|
|
Packit |
d0bcc1 |
*/
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
#include "config.h"
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
#include "atk.h"
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
#include <string.h>
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
/**
|
|
Packit |
d0bcc1 |
* SECTION:atkstate
|
|
Packit |
d0bcc1 |
* @Short_description: An AtkState describes a single state of an object.
|
|
Packit |
d0bcc1 |
* @Title:AtkState
|
|
Packit |
d0bcc1 |
*
|
|
Packit |
d0bcc1 |
* An AtkState describes a single state of an object. The full set of states
|
|
Packit |
d0bcc1 |
* that apply to an object at a given time are contained in its #AtkStateSet.
|
|
Packit |
d0bcc1 |
* See also #atk_object_ref_state_set and #atk_object_notify_state_change.
|
|
Packit |
d0bcc1 |
*/
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
static guint last_type = ATK_STATE_LAST_DEFINED;
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
#define NUM_POSSIBLE_STATES (sizeof(AtkState)*8)
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
static gchar* state_names[NUM_POSSIBLE_STATES];
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
/**
|
|
Packit |
d0bcc1 |
* atk_state_type_register:
|
|
Packit |
d0bcc1 |
* @name: a character string describing the new state.
|
|
Packit |
d0bcc1 |
*
|
|
Packit |
d0bcc1 |
* Register a new object state.
|
|
Packit |
d0bcc1 |
*
|
|
Packit |
d0bcc1 |
* Returns: an #AtkState value for the new state.
|
|
Packit |
d0bcc1 |
**/
|
|
Packit |
d0bcc1 |
AtkStateType
|
|
Packit |
d0bcc1 |
atk_state_type_register (const gchar *name)
|
|
Packit |
d0bcc1 |
{
|
|
Packit |
d0bcc1 |
g_return_val_if_fail (name, ATK_STATE_INVALID);
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
if (last_type < NUM_POSSIBLE_STATES -1)
|
|
Packit |
d0bcc1 |
{
|
|
Packit |
d0bcc1 |
state_names[++last_type] = g_strdup (name);
|
|
Packit |
d0bcc1 |
return (last_type);
|
|
Packit |
d0bcc1 |
}
|
|
Packit |
d0bcc1 |
return ATK_STATE_INVALID; /* caller needs to check */
|
|
Packit |
d0bcc1 |
}
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
/**
|
|
Packit |
d0bcc1 |
* atk_state_type_get_name:
|
|
Packit |
d0bcc1 |
* @type: The #AtkStateType whose name is required
|
|
Packit |
d0bcc1 |
*
|
|
Packit |
d0bcc1 |
* Gets the description string describing the #AtkStateType @type.
|
|
Packit |
d0bcc1 |
*
|
|
Packit |
d0bcc1 |
* Returns: the string describing the AtkStateType
|
|
Packit |
d0bcc1 |
*/
|
|
Packit |
d0bcc1 |
const gchar*
|
|
Packit |
d0bcc1 |
atk_state_type_get_name (AtkStateType type)
|
|
Packit |
d0bcc1 |
{
|
|
Packit |
d0bcc1 |
GTypeClass *type_class;
|
|
Packit |
d0bcc1 |
GEnumValue *value;
|
|
Packit |
d0bcc1 |
const gchar *name = NULL;
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
type_class = g_type_class_ref (ATK_TYPE_STATE_TYPE);
|
|
Packit |
d0bcc1 |
g_return_val_if_fail (G_IS_ENUM_CLASS (type_class), NULL);
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
value = g_enum_get_value (G_ENUM_CLASS (type_class), type);
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
if (value)
|
|
Packit |
d0bcc1 |
{
|
|
Packit |
d0bcc1 |
name = value->value_nick;
|
|
Packit |
d0bcc1 |
}
|
|
Packit |
d0bcc1 |
else
|
|
Packit |
d0bcc1 |
{
|
|
Packit |
d0bcc1 |
if (type <= last_type)
|
|
Packit |
d0bcc1 |
{
|
|
Packit |
d0bcc1 |
if (type >= 0)
|
|
Packit |
d0bcc1 |
name = state_names[type];
|
|
Packit |
d0bcc1 |
}
|
|
Packit |
d0bcc1 |
}
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
g_type_class_unref (type_class);
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
return name;
|
|
Packit |
d0bcc1 |
}
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
/**
|
|
Packit |
d0bcc1 |
* atk_state_type_for_name:
|
|
Packit |
d0bcc1 |
* @name: a character string state name
|
|
Packit |
d0bcc1 |
*
|
|
Packit |
d0bcc1 |
* Gets the #AtkStateType corresponding to the description string @name.
|
|
Packit |
d0bcc1 |
*
|
|
Packit |
d0bcc1 |
* Returns: an #AtkStateType corresponding to @name
|
|
Packit |
d0bcc1 |
*/
|
|
Packit |
d0bcc1 |
AtkStateType
|
|
Packit |
d0bcc1 |
atk_state_type_for_name (const gchar *name)
|
|
Packit |
d0bcc1 |
{
|
|
Packit |
d0bcc1 |
GTypeClass *type_class;
|
|
Packit |
d0bcc1 |
GEnumValue *value;
|
|
Packit |
d0bcc1 |
AtkStateType type = ATK_STATE_INVALID;
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
g_return_val_if_fail (name, ATK_STATE_INVALID);
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
type_class = g_type_class_ref (ATK_TYPE_STATE_TYPE);
|
|
Packit |
d0bcc1 |
g_return_val_if_fail (G_IS_ENUM_CLASS (type_class), ATK_STATE_INVALID);
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
value = g_enum_get_value_by_nick (G_ENUM_CLASS (type_class), name);
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
if (value)
|
|
Packit |
d0bcc1 |
{
|
|
Packit |
d0bcc1 |
type = value->value;
|
|
Packit |
d0bcc1 |
}
|
|
Packit |
d0bcc1 |
else
|
|
Packit |
d0bcc1 |
{
|
|
Packit |
d0bcc1 |
gint i;
|
|
Packit |
d0bcc1 |
|
|
Packit |
d0bcc1 |
for (i = ATK_STATE_LAST_DEFINED + 1; i <= last_type; i++)
|
|
Packit |
d0bcc1 |
{
|
|
Packit |
d0bcc1 |
if (state_names[i] == NULL)
|
|
Packit |
d0bcc1 |
continue;
|
|
Packit |
d0bcc1 |
if (!strcmp(name, state_names[i]))
|
|
Packit |
d0bcc1 |
{
|
|
Packit |
d0bcc1 |
type = i;
|
|
Packit |
d0bcc1 |
break;
|
|
Packit |
d0bcc1 |
}
|
|
Packit |
d0bcc1 |
}
|
|
Packit |
d0bcc1 |
}
|
|
Packit |
d0bcc1 |
return type;
|
|
Packit |
d0bcc1 |
}
|