aboutsummaryrefslogtreecommitdiffstats
path: root/widgets/misc/e-search-bar.h
blob: 0694682e02ed9fe630fc1bcc4eed68d6ec051cfb (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/* e-search-bar.h
 * Copyright (C) 2000  Ximian, Inc.
 * Author: Chris Lahey <clahey@ximian.com>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License as
 * published by the Free Software Foundation; either version 2 of the
 * License, or (at your option) any later version.
 *
 * This program 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
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */
#ifndef __E_SEARCH_BAR_H__
#define __E_SEARCH_BAR_H__

#include <gtk/gtkhbox.h>

#ifdef __cplusplus
extern "C" {
#pragma }
#endif /* __cplusplus */

/* ESearchBar - A card displaying information about a contact.
 *
 * The following arguments are available:
 *
 * name      type       read/write  description
 * ---------------------------------------------------------------------------------
 * option_choice int            RW              Which option choice is currently selected.
 * text          string         RW              Text in the entry box.
 */

#define E_SEARCH_BAR_TYPE           (e_search_bar_get_type ())
#define E_SEARCH_BAR(obj)           (GTK_CHECK_CAST ((obj), E_SEARCH_BAR_TYPE, ESearchBar))
#define E_SEARCH_BAR_CLASS(klass)       (GTK_CHECK_CLASS_CAST ((klass), E_SEARCH_BAR_TYPE, ESearchBarClass))
#define E_IS_SEARCH_BAR(obj)        (GTK_CHECK_TYPE ((obj), E_SEARCH_BAR_TYPE))
#define E_IS_SEARCH_BAR_CLASS(klass)    (GTK_CHECK_CLASS_TYPE ((obj), E_SEARCH_BAR_TYPE))

typedef struct {
    char *text;
    int id;
    gboolean translate; /* whether to translate the text */
} ESearchBarSubitem;
    
typedef struct {
    char *text;
    int id;
    ESearchBarSubitem *subitems;
} ESearchBarItem;

typedef struct _ESearchBar       ESearchBar;
typedef struct _ESearchBarClass  ESearchBarClass;

struct _ESearchBar
{
    GtkHBox parent;
    
    /* item specific fields */
    GtkWidget *dropdown;
    GtkWidget *option;
    GtkWidget *entry;
    GtkWidget *suboption; /* an option menu for the choices associated with some options */
    

    /* PRIVATE */
    GtkWidget *dropdown_holder; /* holds the dropdown */
    GtkWidget *option_menu;
    GtkWidget *suboption_menu;
    GtkWidget *dropdown_menu;
    GtkWidget *activate_button;
    GtkWidget *entry_box;
    guint      pending_change;

    int        option_choice;
    int        suboption_choice; /* < 0 if the entry widget is active */
};

struct _ESearchBarClass
{
    GtkHBoxClass parent_class;

    void (*set_menu)       (ESearchBar *, ESearchBarItem *);
    void (*set_option)     (ESearchBar *, ESearchBarItem *);

    void (*query_changed)  (ESearchBar *search);
    void (*menu_activated) (ESearchBar *search, int item);
};


GtkType    e_search_bar_get_type   (void);
void       e_search_bar_set_menu   (ESearchBar *search_bar, ESearchBarItem *menu_items);
void       e_search_bar_add_menu   (ESearchBar *search_bar, ESearchBarItem *menu_item);

void       e_search_bar_set_option (ESearchBar *search_bar, ESearchBarItem *option_items);
void       e_search_bar_set_suboption (ESearchBar *search_bar, int option_id,
                       ESearchBarSubitem *subitems);

void       e_search_bar_construct  (ESearchBar     *search_bar,
                    ESearchBarItem *menu_items,
                    ESearchBarItem *option_items);
GtkWidget *e_search_bar_new        (ESearchBarItem *menu_items,
                    ESearchBarItem *option_items);

void       e_search_bar_set_menu_sensitive(ESearchBar *search_bar, int id, gboolean state);

void       e_search_bar_set_option_choice    (ESearchBar *search_bar, int id);
int        e_search_bar_get_option_choice    (ESearchBar *search_bar);

void       e_search_bar_set_suboption_choice (ESearchBar *search_bar, int id);
int        e_search_bar_get_suboption_choice (ESearchBar *search_bar);

void       e_search_bar_set_text             (ESearchBar *search_bar, const char *text);
char      *e_search_bar_get_text             (ESearchBar *search_bar);

#ifdef __cplusplus
}
#endif /* __cplusplus */


#endif /* __E_SEARCH_BAR_H__ */