Blame atk/atkstate.c

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
}