|  |  |  | 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
         +----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.
| 
 | a GWeatherLocationEntry | 
| 
 | a GWeatherLocation in entry, orNULLto
clearentry. [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 NULLif 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 : | TRUEifentry's text was modified by the user, orFALSEif
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 : | TRUEifentry's location could be set to a matching city,FALSEotherwise. | 
"top" property"top" GWeatherLocation* : Write / Construct Only
The GWeatherLocation whose children will be used to fill in the entry.