![]() |
![]() |
![]() |
libgweather-3.0 Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
#include <libgweather/gweather.h> 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 +----GtkWidget +----GtkEntry +----GWeatherLocationEntry
GWeatherLocationEntry implements AtkImplementorIface, GtkBuildable, GtkEditable and GtkCellEditable.
"location" GWeatherLocation* : Read / Write "top" GWeatherLocation* : Write / Construct Only
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.
Note that if the database contains a location that compares
equal to loc
, that will be chosen in place of loc
.
|
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. |
"top"
property"top" GWeatherLocation* : Write / Construct Only
The GWeatherLocation whose children will be used to fill in the entry.