Ewl_Widget: The Parent Widget Class Common to All Widgets

Detailed Description

Defines the Ewl_Widget class and it's accessor/modifier functions.

The Ewl_Widget extends the Ewl_Object to provide the basic facilities necessary for widgets to interact with the end user. This includes basic callbacks for input events, window information changes, and drawing to the display.

Remarks:: Inherits from Ewl_Object.

Tutorial

Small as small can be (originally at http://everburning.com/news/small-as-small-can-be)

Whats the minimum amount of work you need to do to create your own EWL widget? Just want something you can build on but dont know where to start?

Well, hopefully this should give you the base for starting your widget. Assuming you're creating a widget called My_Widget, the EWL convention is to have a my_widget.c and my_widget.h files. There are only a couple things you need to implement to get a working widget.

First, my_widget.h.

     #ifndef MY_WIDGET_H
     #define MY_WIDGET_H

     #include <Ewl.h>

     #define MY_WIDGET(w) ((My_Widget *)w)
     #define MY_WIDGET_TYPE "my_widget"

     typedef struct My_Widget My_Widget;
     struct My_Widget
     {
         Ewl_Widget widget;
     };

     Ewl_Widget *my_widget_new(void);
     int my_widget_init(My_Widget *w);

     #endif

That wasn't so bad. What have we got? Well, the MY_WIDGET(w) define gives us a simple macro to cast other widgets to our widget. The second define, MY_WIDGET_TYPE, is a simple macro containing the type name of the widget. Well use that a bit later (and in any type checking we add to our widget.)

We then create the widget structure. In this case were inheriting from Ewl_Widget so its the first item in our struct (and not a pointer, thats important). This is how EWLs inhertiance works. The widget you're inheriting from is the first item in the struct and not a pointer. You will now be able to call any of the methods of the inherited class on the new class.

We then declare two methods. The convention in EWL is that the _new() function always takes no parameters (void). There is also always a _init() function that takes the widget as its only parameter and returns an int, if the initialization succeeded or failed.

With that out of the way, lets take a look at my_widget.c.

     #include "my_widget.h"

     Ewl_Widget *
     my_widget_new(void)
     {
         Ewl_Widget *w;

         w = calloc(1, sizeof(My_Widget)));
         if (!w) return NULL;

         if (!my_widget_init(MY_WIDGET(w)))
         {
                 free(w);
                 return NULL;
         }
         return w;
     }

     int
     my_widget_init(My_Widget *w)
     {
          if (!ewl_widget_init(EWL_WIDGET(w)))
                 return 0;

         ewl_widget_appearance_set(EWL_WIDGET(w), MY_WIDGET_TYPE);
         ewl_widget_inherit(EWL_WIDGET(w), MY_WIDGET_TYPE);

         return 1;
     }

Thats pretty simple. We create a new widget, initialize it and thats about it. In my_widget_init() we make sure we call ewl_widget_init() as thats the widget we are inheriting from and we then set our inheritance and appearance strings (notice the use of our type define from earlier).

With that you've got a simple widget. It doesn't do much, but it exists. Build on as you will.


Data Structures
struct	Ewl_Attach_List
	A list of things attached to a widget. More...
struct	Ewl_Callback_Chain
	The callback chain contains the length, mask and information on the list. More...
struct	Ewl_Color_Set
	Contains an RGBA set of colours. More...
struct	Ewl_Pair
	Contains a key and a value pair. More...
struct	Ewl_Pair_List
	Contains a list of key value pairs. More...
struct	Ewl_Widget
	Inherits from Ewl_Object and extends to provide appearance, parent, and callback capabilities. More...
Defines
#define	CONFIGURED(o)
#define	DESTROYED(o)
#define	DISABLED(o) (ewl_widget_state_has(EWL_WIDGET(o), EWL_FLAG_STATE_DISABLED))
#define	EWL_PAIR(p) ((Ewl_Pair *)p)
#define	EWL_WIDGET(widget) ((Ewl_Widget *) widget)
	Typecast a pointer to an Ewl_Widget pointer.
#define	ewl_widget_flags_get(o, mask) (EWL_WIDGET(o)->flags & mask)
	Retrieves the current setting of the widget flags for o.
#define	ewl_widget_flags_has(o, check_flags, mask) (!!(EWL_WIDGET(o)->flags & ((check_flags) & mask)))
	Determines if widget has the requested flags set.
#define	ewl_widget_flags_has_all(o, check_flags, mask) ((EWL_WIDGET(o)->flags & ((check_flags) & mask)) == ((check_flags) & mask))
	Determines if widget has all of the requested flags set.
#define	ewl_widget_in_tab_list_get(o) (ewl_widget_flags_get(o, EWL_FLAG_PROPERTY_IN_TAB_LIST))
	Retrieves the current setting of the in tab list flag for o.
#define	ewl_widget_in_tab_list_set(o, val)
	Changes the tab list flag value to match val.
#define	EWL_WIDGET_IS(w) (ewl_widget_type_is(EWL_WIDGET(w), EWL_WIDGET_TYPE))
#define	ewl_widget_queued_add(o, queued) ewl_widget_flags_add(o, queued, EWL_FLAGS_QUEUED_MASK)
#define	ewl_widget_queued_get(o, queued) ewl_widget_flags_get(o, queued, EWL_FLAGS_QUEUED_MASK)
#define	ewl_widget_queued_has(o, queued) ewl_widget_flags_has(o, queued, EWL_FLAGS_QUEUED_MASK)
#define	ewl_widget_queued_remove(o, queued) ewl_widget_flags_remove(o, queued, EWL_FLAGS_QUEUED_MASK)
#define	ewl_widget_recursive_get(o) (ewl_widget_flags_get(o, EWL_FLAG_PROPERTY_RECURSIVE))
	Retrieves the current setting of the recursive flag for o.
#define	ewl_widget_recursive_set(o, val)
	Changes the recursive flag value to match val.
#define	ewl_widget_state_add(o, state) ewl_widget_flags_add(o, state, EWL_FLAGS_STATE_MASK)
#define	ewl_widget_state_get(o, state) ewl_widget_flags_get(o, state, EWL_FLAGS_STATE_MASK)
#define	ewl_widget_state_has(o, state) ewl_widget_flags_has(o, state, EWL_FLAGS_STATE_MASK)
#define	ewl_widget_state_remove(o, state) ewl_widget_flags_remove(o, state, EWL_FLAGS_STATE_MASK)
#define	ewl_widget_toplevel_get(o) (ewl_widget_flags_get(o, EWL_FLAG_PROPERTY_TOPLEVEL))
	Retrieves the current setting of the top level flag for o.
#define	ewl_widget_toplevel_set(o, val)
	Changes the top level flag value to match val.
#define	EWL_WIDGET_TYPE "widget"
#define	ewl_widget_visible_add(o, visible) ewl_widget_flags_add(o, visible, EWL_FLAGS_VISIBLE_MASK)
#define	ewl_widget_visible_get(o, visible) ewl_widget_flags_get(o, visible, EWL_FLAGS_VISIBLE_MASK)
#define	ewl_widget_visible_has(o, visible) ewl_widget_flags_has(o, visible, EWL_FLAGS_VISIBLE_MASK)
#define	ewl_widget_visible_remove(o, visible) ewl_widget_flags_remove(o, visible, EWL_FLAGS_VISIBLE_MASK)
#define	HIDDEN(o) (!(EWL_WIDGET(o)->flags & EWL_FLAG_VISIBLE_SHOWN))
#define	REALIZED(o) (EWL_WIDGET(o)->flags & EWL_FLAG_VISIBLE_REALIZED)
#define	RECURSIVE(o) (EWL_WIDGET(o)->flags & EWL_FLAG_PROPERTY_RECURSIVE)
#define	REVEALED(o) (EWL_WIDGET(o)->flags & EWL_FLAG_VISIBLE_REVEALED)
#define	TOPLAYERED(w) (EWL_WIDGET(w)->flags & EWL_FLAG_PROPERTY_TOPLAYERED)
#define	UNMANAGED(w) (EWL_WIDGET(w)->flags & EWL_FLAG_PROPERTY_UNMANAGED)
#define	VISIBLE(o) (EWL_WIDGET(o)->flags & EWL_FLAG_VISIBLE_SHOWN)
Typedefs
typedef struct Ewl_Attach_List	Ewl_Attach_List
typedef struct Ewl_Callback_Chain	Ewl_Callback_Chain
typedef struct Ewl_Color_Set	Ewl_Color_Set
typedef struct Ewl_Pair	Ewl_Pair
typedef struct Ewl_Pair_List	Ewl_Pair_List
typedef struct Ewl_Widget	Ewl_Widget
typedef void (	Ewl_Widget_Drag )(void)
Functions
const char *	ewl_widget_appearance_get (Ewl_Widget *w)
	Retrieve the appearance key of the widget.
const char *	ewl_widget_appearance_part_text_get (Ewl_Widget w, const char part)
	Retrieve a copy of a parts current text.
void	ewl_widget_appearance_part_text_set (Ewl_Widget w, const char part, const char *text)
	Change the text of the given theme part of a widget.
int	ewl_widget_appearance_path_copy (Ewl_Widget w, char buf, int size)
char *	ewl_widget_appearance_path_get (Ewl_Widget *w)
	Retrieve the appearance path key of the widget.
int	ewl_widget_appearance_path_size_get (Ewl_Widget *w)
void	ewl_widget_appearance_set (Ewl_Widget w, const char appearance)
	Change the appearance of the specified widget.
const char *	ewl_widget_appearance_text_get (Ewl_Widget *w)
	Retrieve the text of the given theme part of a widget.
void	ewl_widget_appearance_text_set (Ewl_Widget w, const char text)
	Change the text of the given theme part of a widget.
void	ewl_widget_cb_configure (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_cb_disable (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_cb_enable (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_cb_focus_in (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_cb_focus_out (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_cb_hide (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_cb_mouse_down (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_cb_mouse_in (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_cb_mouse_move (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_cb_mouse_out (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_cb_mouse_up (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_cb_obscure (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_cb_realize (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_cb_reparent (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_cb_reveal (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_cb_show (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_cb_unrealize (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_widget_color_get (Ewl_Widget w, unsigned int r, unsigned int g, unsigned int b, unsigned int *a)
	Gets the colour settings of the widget.
void	ewl_widget_color_set (Ewl_Widget *w, unsigned int r, unsigned int g, unsigned int b, unsigned int a)
	sets the colour of the widget
void	ewl_widget_configure (Ewl_Widget *widget)
	Initiate configuring of the specified widget.
void *	ewl_widget_data_del (Ewl_Widget w, void k)
	Remove the specified key / value pair from the widget and return the value.
void *	ewl_widget_data_get (Ewl_Widget w, void k)
	retrieve the specified key / value pair from the widget
void	ewl_widget_data_set (Ewl_Widget w, void k, void *v)
	Attach the specified key / value pair to the widget.
void	ewl_widget_destroy (Ewl_Widget *widget)
	Destroy the specified widget.
void	ewl_widget_disable (Ewl_Widget *w)
	Prevent a widget from receiving any events.
void	ewl_widget_enable (Ewl_Widget *w)
	Re-enable a disabled widget.
void	ewl_widget_flags_add (Ewl_Widget *o, unsigned int flags, unsigned int mask)
	Add the set of flags specified in flags to w.
void	ewl_widget_flags_remove (Ewl_Widget *o, unsigned int flags, unsigned int mask)
	Removes the set of state flags specified in flags from w.
void	ewl_widget_focus_send (Ewl_Widget *w)
	Changes the keyboard focus to the widget w.
unsigned int	ewl_widget_focusable_get (Ewl_Widget *w)
	Checks the focusable state of the widget.
void	ewl_widget_focusable_set (Ewl_Widget *w, unsigned int val)
	Set if the given widget is focusable or not.
Ewl_Widget *	ewl_widget_focused_get (void)
	Retrieve the currently focused widget.
void	ewl_widget_free (Ewl_Widget *w)
void	ewl_widget_hide (Ewl_Widget *widget)
	Mark a widget as invisible.
unsigned int	ewl_widget_ignore_focus_change_get (Ewl_Widget *w)
	Get if the widget is ignoring focus changes.
void	ewl_widget_ignore_focus_change_set (Ewl_Widget *w, unsigned int val)
	Set if the widget should ignore focus changes.
void	ewl_widget_inherit (Ewl_Widget widget, const char type)
	Appends the given inheritance to this widgets inheritance string.
int	ewl_widget_init (Ewl_Widget *w)
	Initialize a widget to default values and callbacks.
unsigned int	ewl_widget_internal_is (Ewl_Widget *w)
void	ewl_widget_internal_set (Ewl_Widget *w, unsigned int val)
int	ewl_widget_layer_priority_get (Ewl_Widget *w)
	Retrieve a widgets layer relative to it's parent.
void	ewl_widget_layer_priority_set (Ewl_Widget *w, int layer)
	Set the relative layer to it's parent.
int	ewl_widget_layer_top_get (Ewl_Widget *w)
	Returns if the widget will be drawn above all the others.
void	ewl_widget_layer_top_set (Ewl_Widget *w, int top)
	set the widget to be layered above all other widgets
Ewl_Widget *	ewl_widget_name_find (const char *name)
	Find a widget identified by a name.
const char *	ewl_widget_name_get (Ewl_Widget *w)
	Get the name for the specified widget.
void	ewl_widget_name_set (Ewl_Widget w, const char name)
	Name the specified widget.
Ewl_Widget *	ewl_widget_new (void)
	Allocate a new widget.
void	ewl_widget_obscure (Ewl_Widget *w)
	Indicate a widget is obscured.
unsigned int	ewl_widget_onscreen_is (Ewl_Widget *widget)
	Checks if the given widget is currently on screen.
Ewl_Widget *	ewl_widget_parent_get (Ewl_Widget *w)
	Retrieves the parent of the given widget.
int	ewl_widget_parent_of (Ewl_Widget c, Ewl_Widget w)
	Determine if a widget is a parent of another widget.
void	ewl_widget_parent_set (Ewl_Widget w, Ewl_Widget p)
	change the parent of the specified widget
void	ewl_widget_print (Ewl_Widget *w)
	Prints info for debugging a widget's state information.
void	ewl_widget_print_verbose (Ewl_Widget *w)
	Prints verbose info for debugging a widget's state information.
void	ewl_widget_realize (Ewl_Widget *widget)
	Realize the specified widget.
void	ewl_widget_reparent (Ewl_Widget *widget)
	initiate reparent of the specified widget
void	ewl_widget_reveal (Ewl_Widget *w)
	Indicate a widget is revealed.
void	ewl_widget_show (Ewl_Widget *widget)
	mark a widget as visible
void	ewl_widget_state_set (Ewl_Widget w, const char state, Ewl_State_Type flag)
	Update the appearance of the widget to a state.
void	ewl_widget_tab_order_append (Ewl_Widget *w)
	Changes the order in the embed so w receives focus first on tab.
void	ewl_widget_tab_order_insert (Ewl_Widget *w, unsigned int idx)
	Changes the order in the embed so w receives focus first on tab.
void	ewl_widget_tab_order_insert_after (Ewl_Widget w, Ewl_Widget after)
	Insert the given widget into the tab order after the after widget.
void	ewl_widget_tab_order_insert_before (Ewl_Widget w, Ewl_Widget before)
	Inserts the widget into the tab order before the before widget.
void	ewl_widget_tab_order_prepend (Ewl_Widget *w)
	Changes the order in the embed so w receives focus first on tab.
void	ewl_widget_tab_order_remove (Ewl_Widget *w)
	Remove the widget from the tab order.
void	ewl_widget_theme_path_set (Ewl_Widget w, const char path)
	Change the path of the specified widget.
void	ewl_widget_tree_print (Ewl_Widget *w)
	Prints to stdout the tree of widgets that are parents of a widget.
unsigned int	ewl_widget_type_is (Ewl_Widget widget, const char type)
	Determine if the widget w has inherited from the type t.
unsigned int	ewl_widget_unmanaged_is (Ewl_Widget *w)
void	ewl_widget_unmanaged_set (Ewl_Widget *w, unsigned int val)
void	ewl_widget_unrealize (Ewl_Widget *w)
	Unrealize the specified widget.

Define Documentation

#define CONFIGURED ( o )

Value:

(ewl_widget_queued_has(EWL_WIDGET(o), \
                                        EWL_FLAG_QUEUED_SCHEDULED_CONFIGURE) \
                        || ewl_widget_queued_has(EWL_WIDGET(o), \
                                        EWL_FLAG_QUEUED_PROCESS_CONFIGURE))

Used to determine if a widget is scheduled for configure

Referenced by ewl_destroy_request().

#define DESTROYED ( o )

Value:

(ewl_widget_queued_has(EWL_WIDGET(o), \
                                        EWL_FLAG_QUEUED_SCHEDULED_DESTROY) \
                        || ewl_widget_queued_has(EWL_WIDGET(o), \
                                        EWL_FLAG_QUEUED_PROCESS_DESTROY))

Used to determine if a widget has been destroyed

Referenced by ewl_container_child_hide_call(), ewl_container_child_remove_call(), ewl_destroy_request(), ewl_embed_mouse_down_feed(), ewl_widget_destroy(), and ewl_widget_print().

#define DISABLED ( o ) (ewl_widget_state_has(EWL_WIDGET(o), EWL_FLAG_STATE_DISABLED))

#define EWL_PAIR ( p ) ((Ewl_Pair *)p)

Typedcasts a pointer to an Ewl_Pair pointer

Referenced by ewl_widget_appearance_part_text_get(), ewl_widget_appearance_part_text_set(), ewl_widget_cb_reveal(), and ewl_widget_free().

#define EWL_WIDGET ( widget ) ((Ewl_Widget *) widget)

Typecast a pointer to an Ewl_Widget pointer.

#define ewl_widget_flags_get	(	o,
		mask		)	(EWL_WIDGET(o)->flags & mask)

Retrieves the current setting of the widget flags for o.

Parameters:

	o,:	the parameter to retrieve the current value of widget flags
	mask,:	get only the flags specified in mask

Returns:: Returns the current setting of the widget flags for o.

Referenced by ewl_realize_request(), and ewl_widget_cb_reveal().

#define ewl_widget_flags_has	(	o,
		check_flags,
		mask	)	(!!(EWL_WIDGET(o)->flags & ((check_flags) & mask)))

Determines if widget has the requested flags set.

Parameters:

	o,:	the widget to check for a specified flags
	check_flags,:	the bitmask of flags to check on the widget
	mask,:	get only the flags specified in mask

Returns:: Returns TRUE if any of the specified flags are set, FALSE otherwise.

Referenced by ewl_container_reset(), ewl_embed_dnd_drop_feed(), ewl_embed_dnd_position_feed(), ewl_widget_cb_mouse_move(), ewl_widget_cb_obscure(), ewl_widget_cb_reveal(), ewl_widget_focusable_get(), ewl_widget_ignore_focus_change_get(), and ewl_widget_internal_is().

#define ewl_widget_flags_has_all	(	o,
		check_flags,
		mask	)	((EWL_WIDGET(o)->flags & ((check_flags) & mask)) == ((check_flags) & mask))

Determines if widget has all of the requested flags set.

Parameters:

	o,:	the widget to check for a specified flags
	check_flags,:	the bitmask of flags to check on the widget
	mask,:	get only the flags specified in mask

Returns:: Returns TRUE if the specified flags are set, FALSE otherwise.

#define ewl_widget_in_tab_list_get ( o ) (ewl_widget_flags_get(o, EWL_FLAG_PROPERTY_IN_TAB_LIST))

Retrieves the current setting of the in tab list flag for o.

Parameters:

o,:

the parameter to retrieve the current value of the in tab list flag

Returns:: Returns the current setting of the in tab list flag for o.

Referenced by ewl_embed_tab_order_insert().

#define ewl_widget_in_tab_list_set	(	o,
		val		)

Value:

(val ? ewl_widget_flags_add(o, EWL_FLAG_PROPERTY_IN_TAB_LIST, \
                                    EWL_FLAGS_PROPERTY_MASK) : \
         ewl_widget_flags_remove(o, EWL_FLAG_PROPERTY_IN_TAB_LIST, \
                                    EWL_FLAGS_PROPERTY_MASK));

Changes the tab list flag value to match val.

Parameters:

	o,:	the widget to change the in tab list
	val,:	a boolean indicating the value of the tab list flag

Returns:: Returns no value.

Referenced by ewl_embed_tab_order_insert(), and ewl_embed_tab_order_remove().

#define EWL_WIDGET_IS ( w ) (ewl_widget_type_is(EWL_WIDGET(w), EWL_WIDGET_TYPE))

Returns TRUE if the widget is an Ewl_Widget, FALSE otherwise

#define ewl_widget_queued_add	(	o,
		queued		)	ewl_widget_flags_add(o, queued, EWL_FLAGS_QUEUED_MASK)

Parameters:

	o,:	The widget to work with
	queued,:	Add the given queue flag to the widget Adds the given queue flag queued to the widget o

Referenced by ewl_configure_request(), ewl_destroy_request(), ewl_realize_request(), and ewl_widget_realize().

#define ewl_widget_queued_get	(	o,
		queued		)	ewl_widget_flags_get(o, queued, EWL_FLAGS_QUEUED_MASK)

Retrieve the value for the queued queue flag

#define ewl_widget_queued_has	(	o,
		queued		)	ewl_widget_flags_has(o, queued, EWL_FLAGS_QUEUED_MASK)

Determine if the o widget has the queued flag set

Referenced by ewl_configure_request(), ewl_container_child_resize(), ewl_realize_request(), ewl_widget_hide(), ewl_widget_obscure(), ewl_widget_realize(), ewl_widget_reveal(), and ewl_widget_unrealize().

#define ewl_widget_queued_remove	(	o,
		queued		)	ewl_widget_flags_remove(o, queued, EWL_FLAGS_QUEUED_MASK)

Remove the queued flag from the o widget

Referenced by ewl_realize_cancel_request(), and ewl_widget_realize().

#define ewl_widget_recursive_get ( o ) (ewl_widget_flags_get(o, EWL_FLAG_PROPERTY_RECURSIVE))

Retrieves the current setting of the recursive flag for o.

Parameters:

o,:

the parameter to retrieve the current value of recursive flag

Returns:: Returns the current setting of the recursive flag for o.

Referenced by ewl_destroy_request().

#define ewl_widget_recursive_set	(	o,
		val		)

Value:

(val ? ewl_widget_flags_add(o, EWL_FLAG_PROPERTY_RECURSIVE, \
                                    EWL_FLAGS_PROPERTY_MASK) : \
         ewl_widget_flags_remove(o, EWL_FLAG_PROPERTY_RECURSIVE, \
                                    EWL_FLAGS_PROPERTY_MASK));

Changes the recursive flag value to match val.

Parameters:

	o,:	the widget to change the recursive flag
	val,:	a boolean indicating the value of the recursive flag

Returns:: Returns no value.

Referenced by ewl_container_init().

#define ewl_widget_state_add	(	o,
		state		)	ewl_widget_flags_add(o, state, EWL_FLAGS_STATE_MASK)

Parameters:

	o,:	The widget to work with
	state,:	The state to set into the widget Adds the given state state to the widget o

Referenced by ewl_embed_mouse_down_feed(), ewl_embed_mouse_move_feed(), ewl_widget_cb_mouse_move(), ewl_widget_disable(), and ewl_widget_enable().

#define ewl_widget_state_get	(	o,
		state		)	ewl_widget_flags_get(o, state, EWL_FLAGS_STATE_MASK)

Parameters:

	o,:	The widget to work with
	state,:	The state to get Retrives the given state state from the widget o

#define ewl_widget_state_has	(	o,
		state		)	ewl_widget_flags_has(o, state, EWL_FLAGS_STATE_MASK)

Parameters:

	o,:	The widget to check
	state,:	The state to check Checks if the given state state is set on the given widget o

Referenced by ewl_embed_cb_focus_out(), ewl_embed_mouse_move_feed(), ewl_embed_mouse_out_feed(), ewl_entry_editable_set(), ewl_seeker_cb_mouse_down(), ewl_seeker_cb_mouse_move(), ewl_widget_cb_mouse_move(), and ewl_widget_cb_mouse_up().

#define ewl_widget_state_remove	(	o,
		state		)	ewl_widget_flags_remove(o, state, EWL_FLAGS_STATE_MASK)

Parameters:

	o,:	The widget to work with
	state,:	The state to remove Removes the given state from the given o widget

Referenced by ewl_embed_active_set(), ewl_embed_info_widgets_cleanup(), ewl_embed_mouse_down_feed(), ewl_embed_mouse_move_feed(), ewl_embed_mouse_out_feed(), ewl_embed_mouse_up_feed(), ewl_widget_cb_mouse_up(), ewl_widget_disable(), ewl_widget_enable(), and ewl_widget_init().

#define ewl_widget_toplevel_get ( o ) (ewl_widget_flags_get(o, EWL_FLAG_PROPERTY_TOPLEVEL))

Retrieves the current setting of the top level flag for o.

Parameters:

o,:

the parameter to retrieve the current value of top level flag

Returns:: Returns the current setting of the top level flag for o.

Referenced by ewl_configure_request(), ewl_embed_widget_find(), and ewl_widget_realize().

#define ewl_widget_toplevel_set	(	o,
		val		)

Value:

(val ? ewl_widget_flags_add(o, EWL_FLAG_PROPERTY_TOPLEVEL, \
                                    EWL_FLAGS_PROPERTY_MASK) : \
         ewl_widget_flags_remove(o, EWL_FLAG_PROPERTY_TOPLEVEL, \
                                    EWL_FLAGS_PROPERTY_MASK));

Changes the top level flag value to match val.

Parameters:

	o,:	the widget to change the top level flag
	val,:	a boolean indicating the value of the top level flag

Returns:: Returns no value.

Referenced by ewl_embed_init().

#define EWL_WIDGET_TYPE "widget"

The type name for the Ewl_Widget widget

#define ewl_widget_visible_add	(	o,
		visible		)	ewl_widget_flags_add(o, visible, EWL_FLAGS_VISIBLE_MASK)

Add the visible flag to the widget o

Referenced by ewl_container_child_show_call(), ewl_container_init(), ewl_image_init(), ewl_media_init(), ewl_widget_realize(), ewl_widget_reveal(), and ewl_widget_show().

#define ewl_widget_visible_get	(	o,
		visible		)	ewl_widget_flags_get(o, visible, EWL_FLAGS_VISIBLE_MASK)

Retrieves the visble flag from the widget o

#define ewl_widget_visible_has	(	o,
		visible		)	ewl_widget_flags_has(o, visible, EWL_FLAGS_VISIBLE_MASK)

Check if the visible flag is set in the widget o

Referenced by ewl_container_child_hide_call(), and ewl_container_child_show_call().

#define ewl_widget_visible_remove	(	o,
		visible		)	ewl_widget_flags_remove(o, visible, EWL_FLAGS_VISIBLE_MASK)

Remove the visible flag from the widget o

Referenced by ewl_container_child_hide_call(), ewl_widget_hide(), ewl_widget_obscure(), and ewl_widget_unrealize().

#define HIDDEN ( o ) (!(EWL_WIDGET(o)->flags & EWL_FLAG_VISIBLE_SHOWN))

Used to determine if a widget is hidden.

Referenced by ewl_container_child_resize(), ewl_tree_cb_node_child_add(), and ewl_widget_hide().

#define REALIZED ( o ) (EWL_WIDGET(o)->flags & EWL_FLAG_VISIBLE_REALIZED)

Used to test if a widget has been realized.

Referenced by ewl_container_cb_obscure(), ewl_container_child_remove(), ewl_container_child_resize(), ewl_container_largest_prefer(), ewl_container_sum_prefer(), ewl_dnd_accepted_types_set(), ewl_embed_dnd_aware_set(), ewl_embed_engine_name_set(), ewl_embed_font_path_add(), ewl_engine_embed_selection_text_set(), ewl_engine_keyboard_grab(), ewl_engine_keyboard_ungrab(), ewl_engine_pointer_grab(), ewl_engine_pointer_ungrab(), ewl_engine_window_destroy(), ewl_engine_window_lower(), ewl_engine_window_move(), ewl_engine_window_raise(), ewl_engine_window_resize(), ewl_histogram_channel_set(), ewl_histogram_image_set(), ewl_image_file_set(), ewl_mvc_highlight(), ewl_realize_request(), ewl_seeker_autohide_set(), ewl_spectrum_cb_configure(), ewl_text_coord_index_map(), ewl_text_index_geometry_map(), ewl_text_maximum_size_string_set(), ewl_text_minimum_size_string_set(), ewl_theme_data_str_set(), ewl_theme_theme_set(), ewl_tree_cb_node_child_show(), ewl_tree_row_visible_ensure(), ewl_widget_appearance_set(), ewl_widget_cb_reparent(), ewl_widget_color_set(), ewl_widget_hide(), ewl_widget_layer_priority_set(), ewl_widget_layer_top_set(), ewl_widget_obscure(), ewl_widget_parent_set(), ewl_widget_print(), ewl_widget_realize(), ewl_widget_reveal(), ewl_widget_show(), ewl_widget_theme_path_set(), ewl_widget_unrealize(), and ewl_window_cb_unrealize().

#define RECURSIVE ( o ) (EWL_WIDGET(o)->flags & EWL_FLAG_PROPERTY_RECURSIVE)

Used to test if a widget is recursive, aka. an Ewl_Container

Referenced by ewl_container_child_at_recursive_get(), and ewl_embed_info_widgets_cleanup().

#define REVEALED ( o ) (EWL_WIDGET(o)->flags & EWL_FLAG_VISIBLE_REVEALED)

Used to determine if a widget is marked as revealed.

Referenced by ewl_dnd_accepted_types_set(), ewl_text_cb_configure(), ewl_widget_cb_reveal(), ewl_widget_configure(), ewl_widget_obscure(), and ewl_widget_reveal().

#define TOPLAYERED ( w ) (EWL_WIDGET(w)->flags & EWL_FLAG_PROPERTY_TOPLAYERED)

Referenced by ewl_container_child_at_get(), ewl_widget_layer_top_get(), and ewl_widget_layer_top_set().

#define UNMANAGED ( w ) (EWL_WIDGET(w)->flags & EWL_FLAG_PROPERTY_UNMANAGED)

Referenced by ewl_box_orientation_set(), ewl_cell_cb_configure(), ewl_container_child_add_call(), ewl_container_child_hide_call(), ewl_container_child_remove_call(), ewl_container_child_show_call(), ewl_grid_cb_configure(), ewl_grid_child_position_get(), ewl_overlay_cb_configure(), ewl_tree_cb_node_configure(), ewl_tree_node_collapse(), ewl_tree_node_expand(), and ewl_widget_unmanaged_is().

#define VISIBLE ( o ) (EWL_WIDGET(o)->flags & EWL_FLAG_VISIBLE_SHOWN)

Used to test if a widget is visible.

Referenced by ewl_box_cb_configure_homogeneous(), ewl_configure_request(), ewl_container_cb_realize(), ewl_container_child_at_get(), ewl_container_child_remove(), ewl_container_largest_prefer(), ewl_container_sum_prefer(), ewl_embed_canvas_set(), ewl_engine_keyboard_grab(), ewl_engine_keyboard_ungrab(), ewl_engine_pointer_grab(), ewl_engine_pointer_ungrab(), ewl_entry_cb_focus_in(), ewl_entry_cb_focus_out(), ewl_menu_cb_mouse_move(), ewl_notebook_tabbar_visible_get(), ewl_row_cb_configure(), ewl_scrollpane_cb_configure(), ewl_theme_theme_set(), ewl_tree_cb_node_child_add(), ewl_tree_cb_node_child_hide(), ewl_tree_cb_node_child_show(), ewl_tree_cb_node_configure(), ewl_widget_cb_reparent(), ewl_widget_cb_reveal(), ewl_widget_configure(), ewl_widget_print(), ewl_widget_show(), ewl_widget_theme_path_set(), and ewl_widget_unrealize().

Typedef Documentation

typedef struct Ewl_Attach_List Ewl_Attach_List

The attachment list

typedef struct Ewl_Callback_Chain Ewl_Callback_Chain

Callback chain contains a list and bitmask of chain properties.

typedef struct Ewl_Color_Set Ewl_Color_Set

A set of colours

typedef struct Ewl_Pair Ewl_Pair

A key/value pair set

typedef struct Ewl_Pair_List Ewl_Pair_List

A list of key value pairs

typedef struct Ewl_Widget Ewl_Widget

The class that all widgets should inherit. Provides reference to a parent widget/container, callbacks, and appearance information.

typedef void*(* Ewl_Widget_Drag)(void)

Function pointer for the Ewl widget drag

Function Documentation

const char* ewl_widget_appearance_get ( Ewl_Widget * w )

Retrieve the appearance key of the widget.

Parameters:

w,:

the widget to retrieve the appearance key

Returns:: Returns a pointer to the appearance key string on success, NULL on failure.

References appearance, DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_PTR, and EWL_WIDGET_TYPE.

Referenced by ewl_box_orientation_set(), and ewl_container_child_remove().

const char* ewl_widget_appearance_part_text_get	(	Ewl_Widget *	w,
		const char *	part
	)

Retrieve a copy of a parts current text.

Parameters:

	w,:	the widget whose text to retrieve
	part,:	the theme part name whose text to retrieve

Returns:: Returns NULL on failure, a copy of the current text on success. Get the text of a given Edje-define TEXT part. This is for widgets whose Edje appearance defines TEXT parts, and enables each of those text parts to be retrieved independently.

The returned string will only be valid until the next time text is set on this part.

References DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, Ewl_Pair_List::direct, DLEVEL_STABLE, DRETURN_PTR, EWL_PAIR, EWL_WIDGET_TYPE, Ewl_Pair::key, Ewl_Pair_List::len, Ewl_Pair_List::list, theme_text, and Ewl_Pair::value.

Referenced by ewl_widget_appearance_text_get().

void ewl_widget_appearance_part_text_set	(	Ewl_Widget *	w,
		const char *	part,
		const char *	text
	)

Change the text of the given theme part of a widget.

Parameters:

	w,:	the widget whose text to change
	part,:	the theme part name whose text to change
	text,:	the new text to change to

Returns:: Returns no value. Changes the text of a given Edje-define TEXT part. This is for widgets whose Edje appearance defines TEXT parts, and enables each of those text parts to be changed independently. The text value is recorded in a hash and reapplied if the theme is reloaded for this widget.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, Ewl_Pair_List::direct, DLEAVE_FUNCTION, DLEVEL_STABLE, DRETURN, EWL_PAIR, EWL_WIDGET_TYPE, IF_FREE, Ewl_Pair::key, Ewl_Pair_List::len, Ewl_Pair_List::list, NEW, REALLOC, theme_text, and Ewl_Pair::value.

Referenced by ewl_widget_appearance_text_set().

int ewl_widget_appearance_path_copy	(	Ewl_Widget *	w,
		char *	buf,
		int	size
	)

References appearance, DLEVEL_STABLE, DRETURN_INT, ewl_widget_appearance_path_copy(), and parent.

Referenced by ewl_theme_data_str_get(), ewl_widget_appearance_path_copy(), and ewl_widget_appearance_path_get().

char* ewl_widget_appearance_path_get ( Ewl_Widget * w )

Retrieve the appearance path key of the widget.

Parameters:

w,:

the widget to retrieve the full appearance key

Returns:: Returns a pointer to the full appearance path string on success, NULL on failure.

References DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_PTR, ewl_widget_appearance_path_copy(), ewl_widget_appearance_path_size_get(), EWL_WIDGET_TYPE, and NEW.

int ewl_widget_appearance_path_size_get ( Ewl_Widget * w )

References appearance, DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_INT, EWL_WIDGET_TYPE, and parent.

Referenced by ewl_theme_data_str_get(), and ewl_widget_appearance_path_get().

void ewl_widget_appearance_set	(	Ewl_Widget *	w,
		const char *	appearance
	)

Change the appearance of the specified widget.

Parameters:

	w,:	the widget to change the appearance
	appearance,:	the new key for the widgets appearance

Returns:: Returns no value. Changes the key associated with the widgets appearance and calls the theme update callback to initiate the change.

References appearance, DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, DRETURN, ewl_widget_realize(), EWL_WIDGET_TYPE, ewl_widget_unrealize(), and REALIZED.

Referenced by ewl_border_init(), ewl_border_label_position_set(), ewl_box_init(), ewl_box_orientation_set(), ewl_button_init(), ewl_calendar_init(), ewl_cell_init(), ewl_check_init(), ewl_checkbutton_init(), ewl_colorpicker_init(), ewl_combo_cell_init(), ewl_combo_init(), ewl_combo_submenu_new(), ewl_context_menu_init(), ewl_cursor_init(), ewl_datepicker_init(), ewl_dialog_init(), ewl_dnd_internal_drag_start(), ewl_embed_init(), ewl_entry_cursor_init(), ewl_entry_init(), ewl_expansion_init(), ewl_filepicker_init(), ewl_floater_init(), ewl_freebox_init(), ewl_freebox_mvc_init(), ewl_grid_init(), ewl_histogram_init(), ewl_icon_init(), ewl_icondialog_init(), ewl_image_init(), ewl_image_thumbnail_init(), ewl_label_init(), ewl_list_init(), ewl_media_init(), ewl_menu_init(), ewl_menu_item_init(), ewl_menubar_init(), ewl_message_init(), ewl_notebook_init(), ewl_notebook_page_tab_widget_set(), ewl_notebook_tabbar_position_set(), ewl_overlay_init(), ewl_paned_grabber_paned_orientation_set(), ewl_paned_init(), ewl_password_new(), ewl_popup_init(), ewl_progressbar_init(), ewl_radiobutton_init(), ewl_row_init(), ewl_scrollbar_init(), ewl_scrollbar_orientation_set(), ewl_scrollpane_init(), ewl_seeker_init(), ewl_seeker_orientation_set(), ewl_separator_init(), ewl_separator_orientation_set(), ewl_shadow_init(), ewl_spacer_init(), ewl_spectrum_init(), ewl_spinner_init(), ewl_statusbar_init(), ewl_table_init(), ewl_text_init(), ewl_text_trigger_init(), ewl_toolbar_init(), ewl_toolbar_orientation_set(), ewl_tree_column_count_set(), ewl_tree_init(), ewl_tree_node_init(), and ewl_window_init().

const char* ewl_widget_appearance_text_get ( Ewl_Widget * w )

Retrieve the text of the given theme part of a widget.

Parameters:

w,:

the widget whose text to retrieve

Returns:: Returns the current text on success, NULL on failure.

Note:: The returned value will only be valid until the next time ewl_widget_appearance_text_set() is called on this widget.

References DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_PTR, ewl_theme_data_str_get(), ewl_widget_appearance_part_text_get(), and EWL_WIDGET_TYPE.

Referenced by ewl_label_text_get().

void ewl_widget_appearance_text_set	(	Ewl_Widget *	w,
		const char *	text
	)

Change the text of the given theme part of a widget.

Parameters:

	w,:	the widget whose text to change
	text,:	the new text to change to

Returns:: Returns no value. Changes the text of an Edje-define TEXT part. This is for widgets whose Edje appearance defines a TEXT part, and identifies it with with a data item called "/WIDGET/textpart". The text value is recorded in a hash and reapplied if the theme is reloaded for this widget.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, ewl_widget_appearance_part_text_set(), and EWL_WIDGET_TYPE.

Referenced by ewl_label_text_set().

void ewl_widget_cb_configure	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_cb_disable	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_cb_enable	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_cb_focus_in	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_cb_focus_out	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_cb_hide	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_cb_mouse_down	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_cb_mouse_in	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_cb_mouse_move	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_cb_mouse_out	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_cb_mouse_up	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_cb_obscure	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_cb_realize	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_cb_reparent	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_cb_reveal	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_cb_show	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_cb_unrealize	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_widget_color_get	(	Ewl_Widget *	w,
		unsigned int *	r,
		unsigned int *	g,
		unsigned int *	b,
		unsigned int *	a
	)

Gets the colour settings of the widget.

Parameters:

	w,:	The widget to get the colour from
	r,:	Where to put the red value
	g,:	Where to put the green value
	b,:	Where to put the blue value
	a,:	Where to put the alpha value

Returns:: Returns no value

References Ewl_Color_Set::a, Ewl_Color_Set::b, DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, DRETURN, ewl_attach_color_get, EWL_WIDGET_TYPE, Ewl_Color_Set::g, and Ewl_Color_Set::r.

void ewl_widget_color_set	(	Ewl_Widget *	w,
		unsigned int	r,
		unsigned int	g,
		unsigned int	b,
		unsigned int	a
	)

sets the colour of the widget

Parameters:

	w,:	The widget to set the color of
	r,:	The red value
	g,:	The green value
	b,:	The blue value
	a,:	The alpha value

Returns:: Returns no value

References Ewl_Color_Set::a, Ewl_Color_Set::b, DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, ewl_attach_color_get, ewl_attach_color_set, EWL_WIDGET_TYPE, Ewl_Color_Set::g, NEW, Ewl_Color_Set::r, and REALIZED.

Referenced by ewl_colorpicker_cb_alpha_change(), ewl_colorpicker_current_rgb_set(), ewl_colorpicker_init(), and ewl_colorpicker_previous_rgba_set().

void ewl_widget_configure ( Ewl_Widget * w )

Initiate configuring of the specified widget.

Parameters:

w,:

the widget to configure

Returns:: Returns no value. The configure callback is triggered for the specified widget, this should adjust the widgets size and position.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, DRETURN, ewl_configure_request(), EWL_WIDGET_TYPE, parent, REVEALED, and VISIBLE.

void* ewl_widget_data_del	(	Ewl_Widget *	w,
		void *	k
	)

Remove the specified key / value pair from the widget and return the value.

Parameters:

	w,:	the widget that owns the key value pair
	k,:	the key that is associated with the data

Returns:: Returns the deleted value. Removes a key / value pair with k as the key from the specified widget w and return the value. NULL is returned if there is no stored data or if an error occurs.

References DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_PTR, EWL_WIDGET_TYPE, and IF_FREE_HASH.

void* ewl_widget_data_get	(	Ewl_Widget *	w,
		void *	k
	)

retrieve the specified key / value pair from the widget

Parameters:

	w,:	the widget that owns the key value pair
	k,:	the key that is associated with the data

Returns:: Returns the value associated with k on success, NULL on failure. Retrieves a key / value pair with k as the key from the specified widget w.

References DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_PTR, and EWL_WIDGET_TYPE.

Referenced by ewl_grid_cb_child_remove(), ewl_grid_cb_configure(), ewl_grid_child_position_get(), ewl_grid_child_position_set(), ewl_table_cb_child_select(), ewl_table_col_row_get(), ewl_table_find(), and ewl_table_selected_get().

void ewl_widget_data_set	(	Ewl_Widget *	w,
		void *	k,
		void *	v
	)

Attach the specified key / value pair to the widget.

Parameters:

	w,:	the widget to own the key value pair
	k,:	the key that is associated with the data
	v,:	the data that is to be tracked

Returns:: Returns no value. Assigns a key / value pair with k as the key and v as the value to the specified widget w.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, and EWL_WIDGET_TYPE.

Referenced by ewl_grid_child_position_set().

void ewl_widget_destroy ( Ewl_Widget * w )

Destroy the specified widget.

Parameters:

w,:

the widget to be destroyed

Returns:: Returns no value. The widget calls it's destroy callback to do any clean up necessary and then free's the widget.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DESTROYED, DLEAVE_FUNCTION, DLEVEL_STABLE, DRETURN, ewl_callback_del_type(), EWL_CALLBACK_DESTROY, EWL_CALLBACK_MAX, ewl_destroy_request(), ewl_embed_info_widgets_cleanup(), ewl_embed_widget_find(), ewl_widget_hide(), ewl_widget_parent_set(), EWL_WIDGET_TYPE, and ewl_widget_unrealize().

Referenced by ewl_border_new(), ewl_box_init(), ewl_box_new(), ewl_button_image_set(), ewl_button_label_set(), ewl_button_new(), ewl_calendar_new(), ewl_check_new(), ewl_checkbutton_new(), ewl_colordialog_new(), ewl_colorpicker_new(), ewl_combo_cell_new(), ewl_combo_new(), ewl_container_destroy(), ewl_container_reset(), ewl_context_menu_container_set(), ewl_context_menu_new(), ewl_cursor_new(), ewl_datepicker_cb_destroy(), ewl_datepicker_new(), ewl_dialog_has_separator_set(), ewl_dialog_new(), ewl_embed_new(), ewl_entry_cursor_new(), ewl_entry_new(), ewl_expansion_new(), ewl_filedialog_new(), ewl_filelist_new(), ewl_filepicker_new(), ewl_floater_new(), ewl_freebox_mvc_new(), ewl_freebox_new(), ewl_grid_new(), ewl_icon_extended_data_set(), ewl_icon_image_set(), ewl_icon_label_complex_set(), ewl_icon_new(), ewl_icondialog_icon_set(), ewl_icondialog_new(), ewl_image_new(), ewl_image_thumbnail_new(), ewl_label_new(), ewl_list_new(), ewl_media_new(), ewl_menu_cb_destroy(), ewl_menu_item_new(), ewl_menu_new(), ewl_menubar_new(), ewl_message_cb_quit(), ewl_message_new(), ewl_notebook_cb_child_remove(), ewl_notebook_new(), ewl_overlay_new(), ewl_paned_cb_child_remove(), ewl_paned_grabber_new(), ewl_paned_new(), ewl_popup_new(), ewl_progressbar_new(), ewl_radiobutton_new(), ewl_row_new(), ewl_scrollbar_new(), ewl_scrollpane_new(), ewl_seeker_new(), ewl_separator_new(), ewl_shadow_new(), ewl_shutdown(), ewl_spacer_new(), ewl_spectrum_new(), ewl_spinner_new(), ewl_statusbar_new(), ewl_statusbar_pop(), ewl_table_new(), ewl_text_cb_selection_clear(), ewl_text_new(), ewl_text_text_delete(), ewl_text_trigger_new(), ewl_toolbar_new(), ewl_tree_content_view_set(), ewl_tree_new(), ewl_tree_node_new(), ewl_tree_view_plain_new(), ewl_tree_view_scrolled_new(), and ewl_window_new().

void ewl_widget_disable ( Ewl_Widget * w )

Prevent a widget from receiving any events.

Parameters:

w,:

the widget to disable

Returns:: Returns no value. Disables a specified widget. This prevents that widget from receiving any user input events.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DISABLED, DLEAVE_FUNCTION, DLEVEL_STABLE, ewl_callback_call(), EWL_CALLBACK_WIDGET_DISABLE, ewl_embed_info_widgets_cleanup(), ewl_embed_widget_find(), EWL_FLAG_STATE_DISABLED, EWL_FLAGS_STATE_MASK, ewl_widget_state_add, ewl_widget_state_remove, and EWL_WIDGET_TYPE.

Referenced by ewl_container_cb_disable(), ewl_table_init(), ewl_table_reset(), and ewl_tree_node_expandable_set().

void ewl_widget_enable ( Ewl_Widget * w )

Re-enable a disabled widget.

Parameters:

w,:

the widget to re-enable

Returns:: Returns no value. Re-enables a previously disabled widget.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DISABLED, DLEAVE_FUNCTION, DLEVEL_STABLE, ewl_callback_call(), EWL_CALLBACK_WIDGET_ENABLE, EWL_FLAG_STATE_NORMAL, EWL_FLAGS_STATE_MASK, ewl_widget_state_add, ewl_widget_state_remove, and EWL_WIDGET_TYPE.

Referenced by ewl_container_cb_enable(), and ewl_tree_node_expandable_set().

void ewl_widget_flags_add	(	Ewl_Widget *	w,
		unsigned int	flags,
		unsigned int	mask
	)

Add the set of flags specified in flags to w.

Parameters:

	w,:	the widget to set the specified widget flags
	flags,:	a bitmask of new flags to be set in the widget
	mask,:	a bitmask limiting added flags to a certain set

Returns:: Returns no value.

References DCHECK_PARAM_PTR, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, and flags.

Referenced by ewl_dnd_accepted_types_set(), ewl_dnd_provided_types_set(), ewl_widget_focusable_set(), ewl_widget_ignore_focus_change_set(), ewl_widget_internal_set(), ewl_widget_layer_top_set(), and ewl_widget_unmanaged_set().

void ewl_widget_flags_remove	(	Ewl_Widget *	w,
		unsigned int	flags,
		unsigned int	mask
	)

Removes the set of state flags specified in flags from w.

Parameters:

	w,:	the widget to remove specified state flags
	flags,:	a bitmask of flags to be removed from the widget
	mask,:	a bitmask limiting removed flags to a certain set

Returns:: Returns no value.

References DCHECK_PARAM_PTR, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, and flags.

Referenced by ewl_dnd_accepted_types_set(), ewl_dnd_provided_types_set(), ewl_widget_focusable_set(), ewl_widget_ignore_focus_change_set(), ewl_widget_internal_set(), ewl_widget_layer_top_set(), and ewl_widget_unmanaged_set().

void ewl_widget_focus_send ( Ewl_Widget * w )

Changes the keyboard focus to the widget w.

Parameters:

w,:

the widget to receive keyboard focus

Returns:: Returns no value. This function will send the keyboard focus to the given widget.

Note:: Since the focus handling is done by the embed, this function will only work proper if the widget has already an embed (in most cases a window) as an (indirect) parent.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, DRETURN, ewl_embed_active_set(), ewl_embed_focused_widget_set(), ewl_embed_widget_find(), and EWL_WIDGET_TYPE.

Referenced by ewl_combo_cb_decrement_clicked(), ewl_context_menu_cb_attach_mouse_down(), ewl_context_menu_cb_child_mouse_in(), ewl_embed_info_widgets_cleanup(), ewl_entry_cb_dnd_position(), and ewl_menu_cb_expand().

unsigned int ewl_widget_focusable_get ( Ewl_Widget * w )

Checks the focusable state of the widget.

Parameters:

w,:

The widget to get the focusable state from

Returns:: Returns TRUE if the widget is focusable, FALSE otherwise

References DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_INT, EWL_FLAG_PROPERTY_FOCUSABLE, EWL_FLAGS_PROPERTY_MASK, ewl_widget_flags_has, and EWL_WIDGET_TYPE.

Referenced by ewl_context_menu_cb_child_add(), ewl_context_menu_cb_child_remove(), and ewl_embed_tab_order_insert().

void ewl_widget_focusable_set	(	Ewl_Widget *	w,
		unsigned int	val
	)

Set if the given widget is focusable or not.

Parameters:

	w,:	The widget to set the focusable values
	val,:	The focusable value to set

Returns:: Returns no value

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, EWL_FLAG_PROPERTY_FOCUSABLE, EWL_FLAGS_PROPERTY_MASK, ewl_widget_flags_add(), ewl_widget_flags_remove(), and EWL_WIDGET_TYPE.

Referenced by ewl_box_init(), ewl_button_init(), ewl_entry_cursor_init(), ewl_entry_init(), ewl_freebox_init(), ewl_grid_init(), ewl_label_init(), ewl_paned_init(), ewl_row_init(), ewl_scrollpane_init(), ewl_separator_init(), ewl_spacer_init(), ewl_text_init(), ewl_text_trigger_init(), ewl_tree_init(), ewl_tree_node_init(), and ewl_widget_init().

Ewl_Widget* ewl_widget_focused_get ( void )

Retrieve the currently focused widget.

Returns:: Returns the currnetly focused widget.

References DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_PTR, ewl_embed_active_embed_get(), and ewl_embed_focused_widget_get().

void ewl_widget_free ( Ewl_Widget * w )

void ewl_widget_hide ( Ewl_Widget * w )

Mark a widget as invisible.

Parameters:

w,:

the widget to be marked as invisible

Returns:: Returns no value. Marks the widget as invisible so that it will not be displayed the next time through the rendering loop.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, DRETURN, ewl_callback_call(), EWL_CALLBACK_HIDE, ewl_embed_info_widgets_cleanup(), ewl_embed_widget_find(), EWL_FLAG_QUEUED_SCHEDULED_REVEAL, EWL_FLAG_VISIBLE_SHOWN, ewl_realize_cancel_request(), ewl_widget_queued_has, EWL_WIDGET_TYPE, ewl_widget_visible_remove, HIDDEN, and REALIZED.

Referenced by ewl_colorpicker_has_alpha_set(), ewl_context_menu_cb_child_clicked(), ewl_context_menu_cb_mouse_down(), ewl_datepicker_cb_value_changed(), ewl_datepicker_cb_window_mouse_down(), ewl_entry_cb_focus_out(), ewl_entry_editable_set(), ewl_filedialog_init(), ewl_filepicker_show_favorites_set(), ewl_icon_alt_text_set(), ewl_icon_extended_data_set(), ewl_icon_type_set(), ewl_menu_cb_mouse_move(), ewl_menu_collapse(), ewl_notebook_cb_child_show(), ewl_notebook_tabbar_visible_set(), ewl_notebook_visible_page_set(), ewl_popup_cb_follow_destroy(), ewl_scrollpane_cb_configure(), ewl_seeker_cb_configure(), ewl_statusbar_left_hide(), ewl_statusbar_push(), ewl_statusbar_right_hide(), ewl_text_cb_mouse_down(), ewl_text_trigger_cb_hide(), ewl_theme_theme_set(), ewl_tree_cb_node_child_add(), ewl_tree_cb_node_child_hide(), ewl_tree_cb_node_child_show(), ewl_tree_headers_visible_set(), ewl_tree_node_collapse(), ewl_widget_destroy(), and ewl_widget_theme_path_set().

unsigned int ewl_widget_ignore_focus_change_get ( Ewl_Widget * w )

Get if the widget is ignoring focus changes.

Parameters:

w,:

The widget to check if it blocks tab focus

Returns:: Returns TRUE if the widget blocks tab focus, FALSE otherwise.

References DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_INT, EWL_FLAG_PROPERTY_BLOCK_TAB_FOCUS, EWL_FLAGS_PROPERTY_MASK, EWL_OBJECT, ewl_widget_flags_has, and EWL_WIDGET_TYPE.

Referenced by ewl_embed_key_down_feed(), and ewl_embed_key_up_feed().

void ewl_widget_ignore_focus_change_set	(	Ewl_Widget *	w,
		unsigned int	val
	)

Set if the widget should ignore focus changes.

Parameters:

	w,:	The widget to set if it accepts or blocks focus changes
	val,:	TRUE or FALSE on if this widget blocks tabbing off

Returns:: Returns no value.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, EWL_FLAG_PROPERTY_BLOCK_TAB_FOCUS, EWL_FLAGS_PROPERTY_MASK, ewl_widget_flags_add(), ewl_widget_flags_remove(), and EWL_WIDGET_TYPE.

void ewl_widget_inherit	(	Ewl_Widget *	widget,
		const char *	inherit
	)

Appends the given inheritance to this widgets inheritance string.

Parameters:

	widget,:	the widget to set the inheritance on
	inherit,:	the string to append to the inheritance

Returns:: Returns no value.

References alloca(), DCHECK_PARAM_PTR, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, and inheritance.

Referenced by ewl_border_init(), ewl_box_init(), ewl_button_init(), ewl_calendar_init(), ewl_cell_init(), ewl_check_init(), ewl_checkbutton_init(), ewl_colordialog_init(), ewl_colorpicker_init(), ewl_combo_cell_init(), ewl_combo_init(), ewl_container_init(), ewl_context_menu_init(), ewl_cursor_init(), ewl_datepicker_init(), ewl_dialog_init(), ewl_embed_init(), ewl_entry_cursor_init(), ewl_entry_init(), ewl_expansion_init(), ewl_filedialog_init(), ewl_filelist_init(), ewl_filepicker_init(), ewl_floater_init(), ewl_freebox_init(), ewl_freebox_mvc_init(), ewl_grid_init(), ewl_histogram_init(), ewl_icon_init(), ewl_icondialog_init(), ewl_image_init(), ewl_image_thumbnail_init(), ewl_label_init(), ewl_list_init(), ewl_media_init(), ewl_menu_init(), ewl_menu_item_init(), ewl_menubar_init(), ewl_message_init(), ewl_mvc_init(), ewl_notebook_init(), ewl_overlay_init(), ewl_paned_grabber_init(), ewl_paned_init(), ewl_popup_init(), ewl_progressbar_init(), ewl_radiobutton_init(), ewl_range_init(), ewl_row_init(), ewl_scrollbar_init(), ewl_scrollpane_init(), ewl_seeker_init(), ewl_separator_init(), ewl_shadow_init(), ewl_spacer_init(), ewl_spectrum_init(), ewl_spinner_init(), ewl_statusbar_init(), ewl_stock_init(), ewl_table_init(), ewl_text_init(), ewl_text_trigger_init(), ewl_toolbar_init(), ewl_tree_init(), ewl_tree_node_init(), ewl_tree_view_init(), ewl_tree_view_plain_init(), ewl_tree_view_scrolled_init(), ewl_widget_init(), and ewl_window_init().

int ewl_widget_init ( Ewl_Widget * w )

Initialize a widget to default values and callbacks.

Parameters:

w,:

the widget to initialize

Returns:: Returns TRUE on success, FALSE on failure. The widget w is initialized to default values and is assigned the default callbacks.

References DCHECK_PARAM_PTR_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_INT, ewl_callback_append(), EWL_CALLBACK_CONFIGURE, EWL_CALLBACK_FOCUS_IN, EWL_CALLBACK_FOCUS_OUT, EWL_CALLBACK_HIDE, EWL_CALLBACK_MOUSE_DOWN, EWL_CALLBACK_MOUSE_IN, EWL_CALLBACK_MOUSE_MOVE, EWL_CALLBACK_MOUSE_OUT, EWL_CALLBACK_MOUSE_UP, EWL_CALLBACK_OBSCURE, EWL_CALLBACK_REALIZE, EWL_CALLBACK_REPARENT, EWL_CALLBACK_REVEAL, EWL_CALLBACK_SHOW, EWL_CALLBACK_UNREALIZE, EWL_CALLBACK_WIDGET_DISABLE, EWL_CALLBACK_WIDGET_ENABLE, EWL_FLAGS_STATE_MASK, EWL_OBJECT, ewl_object_init(), ewl_theme_widget_init(), ewl_widget_cb_configure(), ewl_widget_cb_disable(), ewl_widget_cb_enable(), ewl_widget_cb_focus_in(), ewl_widget_cb_focus_out(), ewl_widget_cb_hide(), ewl_widget_cb_mouse_down(), ewl_widget_cb_mouse_in(), ewl_widget_cb_mouse_move(), ewl_widget_cb_mouse_out(), ewl_widget_cb_mouse_up(), ewl_widget_cb_obscure(), ewl_widget_cb_realize(), ewl_widget_cb_reparent(), ewl_widget_cb_reveal(), ewl_widget_cb_show(), ewl_widget_cb_unrealize(), ewl_widget_focusable_set(), ewl_widget_inherit(), ewl_widget_state_remove, and EWL_WIDGET_TYPE.

Referenced by ewl_check_init(), ewl_container_init(), ewl_entry_cursor_init(), ewl_image_init(), ewl_label_init(), ewl_media_init(), ewl_progressbar_init(), ewl_separator_init(), ewl_spacer_init(), ewl_text_trigger_init(), and ewl_widget_new().

unsigned int ewl_widget_internal_is ( Ewl_Widget * w )

References DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_INT, EWL_FLAG_PROPERTY_INTERNAL, EWL_FLAGS_PROPERTY_MASK, ewl_widget_flags_has, and EWL_WIDGET_TYPE.

Referenced by ewl_container_child_next(), ewl_context_menu_cb_child_add(), ewl_context_menu_cb_child_remove(), and ewl_embed_mouse_down_feed().

void ewl_widget_internal_set	(	Ewl_Widget *	w,
		unsigned int	val
	)

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, EWL_FLAG_PROPERTY_INTERNAL, EWL_FLAGS_PROPERTY_MASK, ewl_widget_flags_add(), ewl_widget_flags_remove(), and EWL_WIDGET_TYPE.

Referenced by ewl_border_init(), ewl_button_image_set(), ewl_button_init(), ewl_button_label_set(), ewl_calendar_init(), ewl_checkbutton_init(), ewl_colordialog_init(), ewl_colorpicker_init(), ewl_combo_init(), ewl_context_menu_container_set(), ewl_dialog_init(), ewl_entry_init(), ewl_filedialog_init(), ewl_icon_extended_data_set(), ewl_icon_image_set(), ewl_icondialog_init(), ewl_menu_init(), ewl_menubar_init(), ewl_notebook_init(), ewl_paned_grabber_init(), ewl_scrollbar_init(), ewl_scrollpane_init(), ewl_seeker_init(), ewl_spectrum_init(), ewl_spinner_init(), ewl_statusbar_init(), ewl_text_trigger_init(), ewl_tree_node_expandable_set(), and ewl_tree_node_row_set().

int ewl_widget_layer_priority_get ( Ewl_Widget * w )

Retrieve a widgets layer relative to it's parent.

Parameters:

w,:

the widget to retrieve current relative layer

Returns:: Returns a widgets current layer relative to it's parent.

References DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_INT, EWL_WIDGET_TYPE, and layer.

Referenced by ewl_container_child_at_get().

void ewl_widget_layer_priority_set	(	Ewl_Widget *	w,
		int	layer
	)

Set the relative layer to it's parent.

Parameters:

	w,:	the widget to change relative layers
	layer,:	the new relative layer of the widget

Returns:: Returns no value. Changes the current layer of w relative to it's parent. The default value is 0.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, EWL_WIDGET_TYPE, layer, and REALIZED.

Referenced by ewl_progressbar_init(), and ewl_spectrum_init().

int ewl_widget_layer_top_get ( Ewl_Widget * w )

Returns if the widget will be drawn above all the others.

Parameters:

w,:

the widget to get the top value

Returns:: Returns TRUE or FALSE

References DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_INT, EWL_WIDGET_TYPE, and TOPLAYERED.

void ewl_widget_layer_top_set	(	Ewl_Widget *	w,
		int	top
	)

set the widget to be layered above all other widgets

Parameters:

	w,:	the widget to set the top value
	top,:	TRUE or FALSE

Returns:: Returns no value. This set the widget to be layered above all other widgets.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, DRETURN, EWL_FLAG_PROPERTY_TOPLAYERED, EWL_FLAGS_PROPERTY_MASK, ewl_widget_flags_add(), ewl_widget_flags_remove(), EWL_WIDGET_TYPE, REALIZED, and TOPLAYERED.

Ewl_Widget* ewl_widget_name_find ( const char * name )

Find a widget identified by a name.

Parameters:

name,:

the name of the widget to retrieve

Returns:: Returns an pointer a matched widget on success.

References DCHECK_PARAM_PTR_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_PTR, and EWL_WIDGET.

const char* ewl_widget_name_get ( Ewl_Widget * w )

Get the name for the specified widget.

Parameters:

w,:

the widget to retrieve the name

Returns:: Returns an pointer to an allocated name string on success.

References DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_PTR, ewl_attach_name_get, and EWL_WIDGET_TYPE.

void ewl_widget_name_set	(	Ewl_Widget *	w,
		const char *	name
	)

Name the specified widget.

Parameters:

	w,:	the widget to name
	name,:	the new name for the widget

Returns:: Returns no value.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, ewl_attach_name_set, ewl_shutdown_add(), and EWL_WIDGET_TYPE.

Ewl_Widget* ewl_widget_new ( void )

Allocate a new widget.

Returns:: Returns a newly allocated widget on success, NULL on failure. Do not use this function unless you know what you are doing! It is only intended to easily create custom widgets that are not containers.

References DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_PTR, ewl_widget_init(), FREE, and NEW.

Referenced by ewl_colorpicker_init().

void ewl_widget_obscure ( Ewl_Widget * w )

Indicate a widget is obscured.

Parameters:

w,:

the widget to mark as obscured

Returns:: Returns no value.

References DCHECK_PARAM_PTR, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, DRETURN, ewl_callback_call(), EWL_CALLBACK_OBSCURE, EWL_FLAG_QUEUED_SCHEDULED_REVEAL, EWL_FLAG_VISIBLE_REVEALED, ewl_widget_queued_has, ewl_widget_visible_remove, REALIZED, and REVEALED.

Referenced by ewl_container_cb_obscure(), ewl_image_file_set(), ewl_widget_cb_hide(), ewl_widget_parent_set(), ewl_widget_realize(), and ewl_widget_unrealize().

unsigned int ewl_widget_onscreen_is ( Ewl_Widget * w )

Checks if the given widget is currently on screen.

Parameters:

w,:

The widget to check

Returns:: Returns TRUE if the widget is onscreen

References CURRENT_H, CURRENT_W, CURRENT_X, CURRENT_Y, DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_INT, ewl_embed_widget_find(), EWL_OBJECT, ewl_object_current_h_get(), ewl_object_current_w_get(), ewl_object_current_x_get(), ewl_object_current_y_get(), ewl_widget_onscreen_is(), EWL_WIDGET_TYPE, and parent.

Referenced by ewl_scrollpane_cb_focus_jump(), and ewl_widget_onscreen_is().

Ewl_Widget* ewl_widget_parent_get ( Ewl_Widget * w )

Retrieves the parent of the given widget.

Parameters:

w,:

The widget to get the parent from

Returns:: Returns the parent of the given widget, or NULL if none set

References DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_PTR, EWL_WIDGET_TYPE, and parent.

int ewl_widget_parent_of	(	Ewl_Widget *	c,
		Ewl_Widget *	w
	)

Determine if a widget is a parent of another widget.

Parameters:

	c,:	the widget to compare against
	w,:	the widget to check parentage

Returns:: Returns TRUE if c is a parent of w, otherwise returns FALSE.

References DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_INT, EWL_WIDGET_TYPE, and parent.

Referenced by ewl_container_cb_container_focus_out(), ewl_container_child_append(), ewl_container_child_prepend(), ewl_embed_info_widgets_cleanup(), ewl_embed_mouse_down_feed(), ewl_embed_mouse_move_feed(), ewl_embed_tab_order_insert(), and ewl_scrollpane_cb_focus_jump().

void ewl_widget_parent_set	(	Ewl_Widget *	w,
		Ewl_Widget *	p
	)

change the parent of the specified widget

Parameters:

	w,:	the widget to change the parent
	p,:	the new parent of the widget

Returns:: Returns no value. Changes the parent of the widget w, to the container p. The reparent callback is triggered to notify children of w of the change in parent.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, DRETURN, DWARNING, EWL_CONTAINER, ewl_container_child_remove(), ewl_embed_info_widgets_cleanup(), ewl_embed_widget_find(), ewl_widget_obscure(), ewl_widget_reparent(), EWL_WIDGET_TYPE, ewl_widget_unrealize(), parent, and REALIZED.

Referenced by ewl_container_child_append(), ewl_container_child_prepend(), ewl_container_child_remove(), and ewl_widget_destroy().

void ewl_widget_print ( Ewl_Widget * w )

Prints info for debugging a widget's state information.

Parameters:

w,:

the widget to print info

Returns:: Returns no value.

References appearance, DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DESTROYED, DISABLED, DLEAVE_FUNCTION, DLEVEL_STABLE, EWL_OBJECT, ewl_object_current_h_get(), ewl_object_current_w_get(), ewl_object_current_x_get(), ewl_object_current_y_get(), EWL_WIDGET_TYPE, REALIZED, and VISIBLE.

Referenced by ewl_container_child_hide_call(), ewl_container_child_show_call(), ewl_widget_print_verbose(), and ewl_widget_tree_print().

void ewl_widget_print_verbose ( Ewl_Widget * w )

Prints verbose info for debugging a widget's state information.

Parameters:

w,:

the widget to print verbose info

Returns:: Returns no value.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, EWL_FLAG_ALIGN_BOTTOM, EWL_FLAG_ALIGN_LEFT, EWL_FLAG_ALIGN_RIGHT, EWL_FLAG_ALIGN_TOP, EWL_FLAG_FILL_HFILL, EWL_FLAG_FILL_HSHRINKABLE, EWL_FLAG_FILL_VFILL, EWL_FLAG_FILL_VSHRINKABLE, EWL_OBJECT, ewl_object_alignment_get(), ewl_object_fill_policy_get(), ewl_object_insets_bottom_get(), ewl_object_insets_left_get(), ewl_object_insets_right_get(), ewl_object_insets_top_get(), ewl_object_maximum_h_get(), ewl_object_maximum_w_get(), ewl_object_minimum_h_get(), ewl_object_minimum_w_get(), ewl_object_padding_bottom_get(), ewl_object_padding_left_get(), ewl_object_padding_right_get(), ewl_object_padding_top_get(), ewl_object_preferred_h_get(), ewl_object_preferred_w_get(), ewl_widget_print(), and EWL_WIDGET_TYPE.

void ewl_widget_realize ( Ewl_Widget * w )

Realize the specified widget.

Parameters:

w,:

the widget to realize

Returns:: Returns no value. The specified widget is realized, ie. actually displayed to the screen.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, DRETURN, ewl_callback_call(), EWL_CALLBACK_REALIZE, EWL_FLAG_QUEUED_PROCESS_REVEAL, EWL_FLAG_QUEUED_SCHEDULED_REVEAL, EWL_FLAG_VISIBLE_REALIZED, ewl_realize_cancel_request(), ewl_widget_obscure(), ewl_widget_queued_add, ewl_widget_queued_has, ewl_widget_queued_remove, ewl_widget_realize(), ewl_widget_toplevel_get, EWL_WIDGET_TYPE, ewl_widget_visible_add, parent, and REALIZED.

Referenced by ewl_embed_engine_name_set(), ewl_theme_data_str_set(), ewl_theme_theme_set(), ewl_widget_appearance_set(), ewl_widget_realize(), ewl_widget_theme_path_set(), and ewl_window_borderless_set().

void ewl_widget_reparent ( Ewl_Widget * w )

initiate reparent of the specified widget

Parameters:

w,:

the widget to reparent

Returns:: Returns no value. The reparent callback is triggered for the specified widget, this should adjust the widgets attributes based on the new parent.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, ewl_callback_call_with_event_data(), EWL_CALLBACK_REPARENT, EWL_WIDGET_TYPE, and parent.

Referenced by ewl_container_cb_reparent(), and ewl_widget_parent_set().

void ewl_widget_reveal ( Ewl_Widget * w )

Indicate a widget is revealed.

Parameters:

w,:

the widget to mark as revealed

Returns:: Returns no value.

References Ewl_Embed::canvas, DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, DRETURN, ewl_callback_call(), EWL_CALLBACK_REVEAL, ewl_embed_widget_find(), EWL_FLAG_QUEUED_PROCESS_REVEAL, EWL_FLAG_VISIBLE_REVEALED, ewl_widget_configure(), ewl_widget_queued_has, EWL_WIDGET_TYPE, ewl_widget_visible_add, REALIZED, and REVEALED.

Referenced by ewl_image_file_set(), and ewl_widget_cb_realize().

void ewl_widget_show ( Ewl_Widget * w )

mark a widget as visible

Parameters:

w,:

the widget to be marked as visible

Returns:: Returns no value. Marks the widget as visible so that it will be displayed the next time through the rendering loop. Note that the show callback may be delayed until the widget has been realized.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, DRETURN, ewl_callback_call(), EWL_CALLBACK_SHOW, EWL_FLAG_VISIBLE_SHOWN, ewl_realize_request(), EWL_WIDGET_TYPE, ewl_widget_visible_add, REALIZED, and VISIBLE.

Referenced by ewl_border_init(), ewl_button_image_set(), ewl_button_init(), ewl_button_label_set(), ewl_calendar_init(), ewl_checkbutton_init(), ewl_colordialog_init(), ewl_colorpicker_has_alpha_set(), ewl_colorpicker_init(), ewl_combo_cb_decrement_clicked(), ewl_combo_init(), ewl_combo_scrollable_set(), ewl_container_children_show(), ewl_context_menu_cb_attach_mouse_down(), ewl_context_menu_container_set(), ewl_datepicker_init(), ewl_dialog_has_separator_set(), ewl_dialog_init(), ewl_dnd_internal_drag_start(), ewl_entry_cb_focus_in(), ewl_entry_editable_set(), ewl_filedialog_init(), ewl_filelist_multi_select_preview_get(), ewl_filelist_selected_file_preview_get(), ewl_filelist_view_header_fetch(), ewl_filelist_view_widget_fetch(), ewl_filepicker_init(), ewl_filepicker_show_favorites_set(), ewl_freebox_mvc_cb_configure(), ewl_freebox_mvc_init(), ewl_icon_alt_text_set(), ewl_icon_extended_data_set(), ewl_icon_image_set(), ewl_icon_type_set(), ewl_icondialog_icon_set(), ewl_icondialog_init(), ewl_list_cb_configure(), ewl_menu_cb_expand(), ewl_menu_from_info(), ewl_menubar_from_info(), ewl_menubar_init(), ewl_message_init(), ewl_notebook_cb_child_add(), ewl_notebook_cb_child_hide(), ewl_notebook_init(), ewl_notebook_page_tab_text_set(), ewl_notebook_page_tab_widget_set(), ewl_notebook_tabbar_visible_set(), ewl_notebook_visible_page_set(), ewl_progressbar_init(), ewl_scrollbar_init(), ewl_scrollpane_cb_configure(), ewl_scrollpane_init(), ewl_seeker_autohide_set(), ewl_seeker_init(), ewl_spectrum_init(), ewl_spinner_init(), ewl_statusbar_init(), ewl_statusbar_left_show(), ewl_statusbar_pop(), ewl_statusbar_push(), ewl_statusbar_right_show(), ewl_table_add(), ewl_table_init(), ewl_table_reset(), ewl_text_cb_mouse_down(), ewl_text_trigger_area_add(), ewl_text_trigger_cb_show(), ewl_theme_theme_set(), ewl_tree_cb_node_child_add(), ewl_tree_column_count_set(), ewl_tree_content_view_set(), ewl_tree_headers_visible_set(), ewl_tree_init(), ewl_tree_node_expand(), ewl_tree_node_expandable_set(), ewl_tree_view_scrolled_init(), and ewl_widget_theme_path_set().

void ewl_widget_state_set	(	Ewl_Widget *	w,
		const char *	state,
		Ewl_State_Type	flag
	)

Update the appearance of the widget to a state.

Parameters:

	w,:	the widget to update the appearance
	state,:	the new state of the widget
	flag,:	the flag for the state e.g. EWL_STATE_TRANSIENT

Returns:: Returns no value. Changes the appearance of the widget depending on the state string passed by the state parameter.

References appearance, DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN, ewl_callback_call_with_event_data(), EWL_CALLBACK_STATE_CHANGED, ewl_config_cache, EWL_STATE_PERSISTENT, EWL_WIDGET_TYPE, Ewl_Event_State_Change::flag, Ewl_Config_Cache::print_signals, Ewl_Event_State_Change::state, theme_object, and theme_state.

Referenced by ewl_cell_cb_state_changed(), ewl_check_cb_update_check(), ewl_combo_cb_decrement_clicked(), ewl_combo_cb_popup_hide(), ewl_container_cb_container_focus_out(), ewl_container_cb_widget_focus_in(), ewl_container_cb_widget_focus_out(), ewl_entry_cb_key_down(), ewl_entry_editable_set(), ewl_notebook_page_tab_widget_set(), ewl_notebook_tabbar_visible_set(), ewl_notebook_visible_page_set(), ewl_widget_cb_disable(), ewl_widget_cb_enable(), ewl_widget_cb_focus_in(), ewl_widget_cb_focus_out(), ewl_widget_cb_mouse_down(), ewl_widget_cb_mouse_in(), ewl_widget_cb_mouse_move(), ewl_widget_cb_mouse_out(), ewl_widget_cb_mouse_up(), and ewl_widget_cb_reveal().

void ewl_widget_tab_order_append ( Ewl_Widget * w )

Changes the order in the embed so w receives focus first on tab.

Parameters:

w,:

the widget to be moved to the front of the focus list

Returns:: Returns no value. This moves the widget w to the end of the tab order list in the embed that holds it.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, ewl_embed_tab_order_append(), ewl_embed_widget_find(), and EWL_WIDGET_TYPE.

void ewl_widget_tab_order_insert	(	Ewl_Widget *	w,
		unsigned int	idx
	)

Changes the order in the embed so w receives focus first on tab.

Parameters:

	w,:	the widget to be moved to the front of the focus list
	idx,:	The index to insert the tab into

Returns:: Returns no value. This moves the widget w to the given index in the tab order list in the embed that holds it.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, ewl_embed_tab_order_insert(), ewl_embed_widget_find(), and EWL_WIDGET_TYPE.

void ewl_widget_tab_order_insert_after	(	Ewl_Widget *	w,
		Ewl_Widget *	after
	)

Insert the given widget into the tab order after the after widget.

Parameters:

	w,:	The widget to insert into the tab order
	after,:	The widget to insert after

Returns:: Returns no value.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, ewl_embed_tab_order_insert_after(), ewl_embed_widget_find(), and EWL_WIDGET_TYPE.

void ewl_widget_tab_order_insert_before	(	Ewl_Widget *	w,
		Ewl_Widget *	before
	)

Inserts the widget into the tab order before the before widget.

Parameters:

	w,:	The widget to be inserted into the tab order
	before,:	The widget we are to be inserted before

Returns:: Returns no value.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, ewl_embed_tab_order_insert_before(), ewl_embed_widget_find(), and EWL_WIDGET_TYPE.

void ewl_widget_tab_order_prepend ( Ewl_Widget * w )

Changes the order in the embed so w receives focus first on tab.

Parameters:

w,:

the widget to be moved to the front of the focus list

Returns:: Returns no value. This moves the widget w to the front of the tab order list in the embed that holds it.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, ewl_embed_tab_order_prepend(), ewl_embed_widget_find(), and EWL_WIDGET_TYPE.

Referenced by ewl_widget_cb_show().

void ewl_widget_tab_order_remove ( Ewl_Widget * w )

Remove the widget from the tab order.

Parameters:

w,:

The widget to remove from the tab order

Returns:: Returns no value.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, ewl_embed_tab_order_remove(), ewl_embed_widget_find(), and EWL_WIDGET_TYPE.

void ewl_widget_theme_path_set	(	Ewl_Widget *	w,
		const char *	path
	)

Change the path of the specified widget.

Parameters:

	w,:	the widget to change the theme path
	path,:	the new path to find the theme file for the widget's appearance

Returns:: Returns no value. Sets and applies the theme path for the given widget. This will also change the theme of possible children. If the path is NULL, the default path will be used instead.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, ewl_theme_data_reset(), ewl_theme_data_str_set(), ewl_widget_hide(), ewl_widget_realize(), ewl_widget_show(), EWL_WIDGET_TYPE, ewl_widget_unrealize(), REALIZED, and VISIBLE.