| libgweather-3.0 Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | ||||
GWeatherLocationEntry; GWeatherLocationEntryClass; GtkWidget * gweather_location_entry_new (GWeatherLocation *top); void gweather_location_entry_set_location (GWeatherLocationEntry *entry,GWeatherLocation *loc); GWeatherLocation * gweather_location_entry_get_location (GWeatherLocationEntry *entry); gboolean gweather_location_entry_has_custom_text (GWeatherLocationEntry *entry); gboolean gweather_location_entry_set_city (GWeatherLocationEntry *entry,const char *city_name,const char *code);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkEntry +----GWeatherLocationEntry
GWeatherLocationEntry implements AtkImplementorIface, GtkBuildable, GtkEditable and GtkCellEditable.
typedef struct _GWeatherLocationEntry GWeatherLocationEntry;
A subclass of GtkEntry that provides autocompletion on GWeatherLocations
typedef struct {
GtkEntryClass parent_class;
} GWeatherLocationEntryClass;
GtkWidget * gweather_location_entry_new (GWeatherLocation *top);
Creates a new GWeatherLocationEntry.
top will normally be a location returned from
gweather_location_new_world(), but you can create an entry that
only accepts a smaller set of locations if you want.
|
the top-level location for the entry. |
Returns : |
the new GWeatherLocationEntry |
void gweather_location_entry_set_location (GWeatherLocationEntry *entry,GWeatherLocation *loc);
Sets entry's location to loc, and updates the text of the
entry accordingly.
|
a GWeatherLocationEntry |
|
a GWeatherLocation in entry, or NULL to
clear entry. [allow-none]
|
GWeatherLocation * gweather_location_entry_get_location
(GWeatherLocationEntry *entry);
Gets the location that was set by a previous call to
gweather_location_entry_set_location() or was selected by the user.
|
a GWeatherLocationEntry |
Returns : |
the selected location
(which you must unref when you are done with it), or NULL if no
location is selected. [transfer full][allow-none]
|
gboolean gweather_location_entry_has_custom_text
(GWeatherLocationEntry *entry);
Checks whether or not entry's text has been modified by the user.
Note that this does not mean that no location is associated with entry.
gweather_location_entry_get_location() should be used for this.
|
a GWeatherLocationEntry |
Returns : |
TRUE if entry's text was modified by the user, or FALSE if
it's set to the default text of a location. |
gboolean gweather_location_entry_set_city (GWeatherLocationEntry *entry,const char *city_name,const char *code);
Sets entry's location to a city with the given code, and given
city_name, if non-NULL. If there is no matching city, sets
entry's location to NULL.
|
a GWeatherLocationEntry |
|
the city name, or NULL. [allow-none]
|
|
the METAR station code |
Returns : |
TRUE if entry's location could be set to a matching city,
FALSE otherwise. |