abookcontactview.h

linux手机下的电话本源码（是contact的上层）

/*  addressbook - Address book
 *abookcontactview.h - 
 *
 *Authors: YE Nan <[e-mail]>
 *        ZHAO Liangjing <[e-mail]> 
 *
 *This software and associated documentation files (the "Software") 
 *are copyright (C) 2005 LiPS Linux Phone Standards Forum [FranceTelecom] 
 *All Rights Reserved. 
 *
 *A copyright license is hereby granted for redistribution and use of 
 *the Software in source and binary forms, with or without modification, 
 *provided that the following conditions are met: 
 *- Redistributions of source code must retain the above copyright notice, 
 *this copyright license and the following disclaimer. 
 *- Redistributions in binary form must reproduce the above copyright 
 *notice, this copyright license and the following disclaimer in the 
 *documentation and/or other materials provided with the distribution. 
 *- Neither the name of LiPS  nor the names of its Members may be used 
 *to endorse or promote products derived from the Software without 
 *specific prior written permission. 
 *
 *A patent license for any Necessary Claims owned by Members of LiPS Forum 
 *to make, have made, use, import, offer to sell, lease and sell or otherwise 
 *distribute any implementation compliant with the any specification adopted 
 *by the LiPS Forumcan be obtained from the respective Members on reasonable 
 *and non-discriminatory terms and conditions and under reciprocity, as 
 *regulated in more detail in the Internal Policy of the LiPS Forum. 
 *
 *THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER, ITS MEMBERS AND CONTRIBUTORS 
 *"AS IS", AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, 
 *THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE 
 *AND NON-INFRINGEMENT ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER, 
 *ITS MEMBERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 
 *SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 
 *PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
 *OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 
 *WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
 *ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
 *POSSIBILITY OF SUCH DAMAGE. 
 */


#ifndef ABOOK_CONTACT_VIEW_H_
#define ABOOK_CONTACT_VIEW_H_

#include <gtk/gtk.h>

#include "gtkautoscrolledwindow.h"

#ifdef __cplusplus
extern "C"
{
#endif

#define	ABOOK_TYPE_CONTACT_VIEW							(abook_contact_view_get_type ())
#define	ABOOK_CONTACT_VIEW(obj)							(G_TYPE_CHECK_INSTANCE_CAST ((obj), ABOOK_TYPE_CONTACT_VIEW, ABookContactView))
#define	ABOOK_CONTACT_VIEW_CLASS(klass)			(G_TYPE_CHECK_CLASS_CAST ((klass), ABOOK_TYPE_CONTACT_VIEW, ABookContactViewClass))
#define	ABOOK_IS_CONTACT_VIEW(obj)					(G_TYPE_CHECK_INSTANCE_TYPE ((obj), ABOOK_TYPE_CONTACT_VIEW))
#define ABOOK_IS_CONTACT_VIEW_CLASS(klass)	(G_TYPE_CHECK_CLASS_TYPE ((klass), ABOOK_TYPE_CONTACT_VIEW))
#define ABOOK_CONTACT_VIEW_GET_CLASS(obj)		(G_TYPE_INSTANCE_GET_CLASS ((obj), ABOOK_TYPE_CONTACT_VIEW, ABookContactViewClass))

  typedef struct _ABookContactView ABookContactView;
  typedef struct _ABookContactViewClass ABookContactViewClass;

  typedef void (*ABookContactViewCatModifier) (ABookContactView *view);

  typedef enum
  {
    CNT_VIEW_NAME = 0,
    CNT_VIEW_MOBILENUM,
    CNT_VIEW_HOMENUM,
    CNT_VIEW_BUSINUM,
    CNT_VIEW_FAXNUM,
    CNT_VIEW_COMPANY,
    CNT_VIEW_DEPART,
    CNT_VIEW_WEBSITE,
    CNT_VIEW_EMAIL,
    CNT_VIEW_PICTURE,
    CNT_VIEW_RINGTONE,
    CNT_VIEW_HADDR,
    CNT_VIEW_BADDR,
    NUM_CNT_VIEW_ITEMS
  } ABookContactViewItems;

  typedef enum
  {
    CNT_VIEW_STATUS_SAVE,
    CNT_VIEW_STATUS_CANCEL,
  } ABookContactViewStatus;

  struct _ABookContactView
  {
    GtkAutoScrolledWindow window;

    GtkWidget *labels[NUM_CNT_VIEW_ITEMS];
    GtkWidget *entries[NUM_CNT_VIEW_ITEMS];
    GtkWidget *image;

    GtkWidget *cat_label;
    GtkWidget *cat_entry;
    GtkWidget *cat_image;
//      GPtrArray                                                                                       *cat_uids;

    gchar *uuid;
    gboolean editable;
    ABookContactViewStatus status;
    ABookContactViewItems focused_item;

    ABookContactViewCatModifier cat_modifier;
  };

  struct _ABookContactViewClass
  {
    GtkAutoScrolledWindowClass parent_class;
  };

  GType abook_contact_view_get_type (void) G_GNUC_CONST;
  GtkWidget *abook_contact_view_new (void);
  G_CONST_RETURN gchar *abook_contact_view_get_item_value (const
                                                           ABookContactView *
                                                           view,
                                                           ABookContactViewItems
                                                           item);
  void abook_contact_view_set_item_value (ABookContactView *view,
                                          ABookContactViewItems item,
                                          const gchar *value);
  void abook_contact_view_set_uid (ABookContactView *view,
                                   const gchar *uidstr);
  G_CONST_RETURN gchar *abook_contact_view_get_uid (ABookContactView *view);
  void abook_contact_view_set_editable (ABookContactView *view,
                                        gboolean editable);
  gboolean abook_contact_view_get_editable (ABookContactView *view);

  void abook_contact_view_set_category_modifier (ABookContactView *view,
                                                 ABookContactViewCatModifier
                                                 modifier);
  void abook_contact_view_set_categories (ABookContactView *view,
                                          const gchar *categories_str);
  G_CONST_RETURN gchar *abook_contact_view_get_categories (ABookContactView *
                                                           view);

  void abook_contact_view_set_focus_item (ABookContactView *view,
                                          ABookContactViewItems item);


#ifdef __cplusplus
}
#endif

#endif                          /* ABOOK_CONTACT_VIEW_H_ */

/* 
vi:ts=2:nowrap:ai:expandtab
*/