abookimcontactview.h

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

/*  addressbook - Address book
 *abookimcontactview.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_IM_CONTACT_VIEW_H_
#define ABOOK_IM_CONTACT_VIEW_H_

#include <gtk/gtk.h>

#include "gtkautoscrolledwindow.h"

#ifdef __cplusplus
extern "C"
{
#endif

#define	ABOOK_TYPE_IM_CONTACT_VIEW							(abook_im_contact_view_get_type ())
#define	ABOOK_IM_CONTACT_VIEW(obj)							(G_TYPE_CHECK_INSTANCE_CAST ((obj), ABOOK_TYPE_IM_CONTACT_VIEW, ABookImContactView))
#define	ABOOK_IM_CONTACT_VIEW_CLASS(klass)			(G_TYPE_CHECK_CLASS_CAST ((klass), ABOOK_TYPE_IM_CONTACT_VIEW, ABookImContactViewClass))
#define	ABOOK_IS_IM_CONTACT_VIEW(obj)					(G_TYPE_CHECK_INSTANCE_TYPE ((obj), ABOOK_TYPE_IM_CONTACT_VIEW))
#define ABOOK_IS_IM_CONTACT_VIEW_CLASS(klass)	(G_TYPE_CHECK_CLASS_TYPE ((klass), ABOOK_TYPE_IM_CONTACT_VIEW))
#define ABOOK_IM_CONTACT_VIEW_GET_CLASS(obj)		(G_TYPE_INSTANCE_GET_CLASS ((obj), ABOOK_TYPE_IM_CONTACT_VIEW, ABookImContactViewClass))

  typedef struct _ABookImContactView ABookImContactView;
  typedef struct _ABookImContactViewClass ABookImContactViewClass;

  typedef void (*ABookImContactViewCatModifier) (ABookImContactView *view);

  typedef enum
  {
    IM_VIEW_URI = 0,
    IM_VIEW_NICKNAME,
    IM_VIEW_SUBSCRIPTION,
    IM_VIEW_PRESENCE,
    NUM_IM_VIEW_ITEMS
  } ABookImContactViewItems;

  typedef enum
  {
    IM_VIEW_STATUS_SAVE,
    IM_VIEW_STATUS_CANCEL,
  } ABookImContactViewStatus;

  struct _ABookImContactView
  {
    GtkAutoScrolledWindow window;

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

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

    gchar *uuid;
    gboolean editable;
    ABookImContactViewStatus status;
    ABookImContactViewItems focused_item;

    ABookImContactViewCatModifier cat_modifier;
  };

  struct _ABookImContactViewClass
  {
    GtkAutoScrolledWindowClass parent_class;
  };

  GType abook_im_contact_view_get_type (void) G_GNUC_CONST;
  GtkWidget *abook_im_contact_view_new (void);
  G_CONST_RETURN gchar *abook_im_contact_view_get_item_value (const
                                                              ABookImContactView
                                                              *view,
                                                              ABookImContactViewItems
                                                              item);
  void abook_im_contact_view_set_item_value (ABookImContactView *view,
                                             ABookImContactViewItems item,
                                             const gchar *value);
  void abook_im_contact_view_set_uid (ABookImContactView *view,
                                      const gchar *uidstr);
  G_CONST_RETURN gchar *abook_im_contact_view_get_uid (ABookImContactView *
                                                       view);
  void abook_im_contact_view_set_editable (ABookImContactView *view,
                                           gboolean editable);
  gboolean abook_im_contact_view_get_editable (ABookImContactView *view);

  void abook_im_contact_view_set_category_modifier (ABookImContactView *view,
                                                    ABookImContactViewCatModifier
                                                    modifier);
  void abook_im_contact_view_set_categories (ABookImContactView *view,
                                             const gchar *categories_str);
  G_CONST_RETURN gchar *abook_im_contact_view_get_categories (ABookImContactView
                                                              *view);

  void abook_im_contact_view_set_focus_item (ABookImContactView *view,
                                             ABookImContactViewItems item);


#ifdef __cplusplus
}
#endif

#endif                          /* ABOOK_IM_CONTACT_VIEW_H_ */

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