自学教程：C++ DLEAVE_FUNCTION函数代码示例

/** * @param win: window to set transient * @param forwin: the window to be transient for * @return Returns no value. * @brief Sets a window to be transient for another window. */voidewl_window_transient_for(Ewl_Window *win, Ewl_Window *forwin){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(win);        DCHECK_TYPE(win, EWL_WINDOW_TYPE);        DCHECK_TYPE(forwin, EWL_WINDOW_TYPE);        win->transient.ewl = forwin;        win->flags &= ~EWL_WINDOW_TRANSIENT_FOREIGN;        /* if there is no forwin remove the transient for state         * and update the window, if it already exists */        if (!forwin) {                win->flags &= ~EWL_WINDOW_TRANSIENT;                if (win->window)                        ewl_engine_window_transient_for(win);                DRETURN(DLEVEL_STABLE);        }        win->flags |= EWL_WINDOW_TRANSIENT;        if (win->window) {                if (forwin->window)                        ewl_engine_window_transient_for(win);                else                        ewl_callback_append(EWL_WIDGET(forwin),                                            EWL_CALLBACK_REALIZE,                                            ewl_window_cb_realize_parent,                                            win);        }        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @return Returns no value * @brief Called when the icon theme is changed so we can clean up any * caching we have in place */voidewl_icon_theme_theme_change(void){        const char *icon_theme;        DENTER_FUNCTION(DLEVEL_STABLE);        icon_theme = ewl_config_string_get(ewl_config, EWL_CONFIG_THEME_ICON_THEME);        /* check if this is an edje theme */        if (icon_theme && (!strncasecmp(icon_theme + (strlen(icon_theme) - 4),                                              ".edj", 4)))                ewl_icon_theme_is_edje = 1;        else                ewl_icon_theme_is_edje = 0;        /* destroy the cache and re-create it */        IF_FREE_HASH(ewl_icon_theme_cache);        ewl_icon_theme_cache = ecore_hash_new(ecore_str_hash, ecore_str_compare);        ecore_hash_free_key_cb_set(ewl_icon_theme_cache, ewl_icon_theme_cb_free);        ecore_hash_free_value_cb_set(ewl_icon_theme_cache, free);        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @internal * @param tx: The context to print * @param indent: The indent level to use * @return Returns no value * @brief Prints out the context information **/voidewl_text_context_print(Ewl_Text_Context *tx, const char *indent){        const char *t, *s;        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(tx);        if (!tx->font) t = "";        else t = tx->font;        if (!tx->font_source) s = "";        else s = tx->font_source;        printf("%sfont: %s (source: %s)/n"                "%ssize %d/n"                "%sstyle %d/n"                "%salign %d/n"                "%swrap %d/n"                "%sred %d/n"                "%sgreen %d/n"                "%sblue %d/n"                "%salpha %d",                        indent, t, s, indent, tx->size, indent,                        tx->styles, indent, tx->align,                        indent, tx->wrap, indent, tx->color.r,                        indent, tx->color.g, indent, tx->color.b,                        indent, tx->color.a);        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param menu: the menu to work with * @return Returns no value * @brief Expand the popup portion of the menu */voidewl_menu_expand(Ewl_Menu *menu){        Ewl_Menu_Item *item;        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(menu);        DCHECK_TYPE(menu, EWL_MENU_TYPE);        item = EWL_MENU_ITEM(menu);        /* nothing to do if the popup is already visible */        if (VISIBLE(menu->popup))                DRETURN(DLEVEL_STABLE);        ewl_widget_show(menu->popup);        ewl_window_raise(EWL_WINDOW(menu->popup));        if (item->inmenu) {                Ewl_Context_Menu *cm;                cm = EWL_CONTEXT_MENU(item->inmenu);                cm->open_menu = EWL_WIDGET(menu);        }        else                ewl_widget_focus_send(menu->popup);        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @internal * @param w: The widget to work with * @ev_data: The Ewl_Event_Mouse_Down data * @param data: The scrollport * @return Returns no value * @brief The mouse down function for kinetic scrolling */static voidewl_scrollport_kinetic_cb_mouse_down_embedded(Ewl_Widget *w, void *ev,                void *data){        Ewl_Scrollport *s;        Ewl_Event_Mouse *md;        Ewl_Scrollport_Kinetic_Info_Embedded *info;        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(ev);        DCHECK_PARAM_PTR(data);        DCHECK_TYPE(w, EWL_WIDGET_TYPE);        s = EWL_SCROLLPORT(data);        md = EWL_EVENT_MOUSE(ev);        info = s->kinfo->extra;        s->kinfo->clicked = !!TRUE;        s->kinfo->active = !!FALSE;        memset(&(info->back[0]), 0, sizeof(info->back[0]) * HIST_NUM);        info->back[0].x = md->x;        info->back[0].y = md->y;        info->back[0].time = ecore_time_get();        info->xs = md->x;        info->ys = md->y;        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param p: The popup to set the follow widget * @param w: The widget to follow * @return Returns no value * @brief Set the follow widget of the popup */voidewl_popup_follow_set(Ewl_Popup *p, Ewl_Widget *w){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(p);        DCHECK_TYPE(p, EWL_POPUP_TYPE);        if (p->follow == w)                DRETURN(DLEVEL_STABLE);        if (p->follow) {                ewl_callback_del_with_data(p->follow, EWL_CALLBACK_DESTROY,                                                ewl_popup_cb_follow_destroy, p);                ewl_callback_del_with_data(p->follow, EWL_CALLBACK_CONFIGURE,                                                ewl_popup_cb_follow_configure,                                                p);        }        if (w) {                ewl_callback_prepend(w, EWL_CALLBACK_DESTROY,                                        ewl_popup_cb_follow_destroy, p);                ewl_callback_append(w, EWL_CALLBACK_CONFIGURE,                                        ewl_popup_cb_follow_configure, p);        }        p->follow = w;        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param ps: the ps to change the orientation * @param o: the orientation * @return Returns no value. * @brief Set an orientation of the document * * Sets an orientation @p o of the document */voidewl_ps_orientation_set(Ewl_Ps *ps, Eps_Page_Orientation o){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(ps);        DCHECK_TYPE(ps, EWL_PS_TYPE);        if (!ps->ps_page || (eps_page_orientation_get(ps->ps_page) == o))                DLEAVE_FUNCTION(DLEVEL_STABLE);        ps->dirty = 1;        eps_page_orientation_set(ps->ps_page, o);        ewl_widget_configure(EWL_WIDGET(ps));        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param e: The Ewl_Entry to set the editable status of * @param editable: The value to set for the editable flag * @return Returns no value * @brief Set if the entry is editable or not */voidewl_entry_editable_set(Ewl_Entry *e, unsigned int editable){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(e);        DCHECK_TYPE(e, EWL_ENTRY_TYPE);        if (e->editable == !!editable)                DRETURN(DLEVEL_STABLE);        e->editable = !!editable;        if (e->editable)        {                ewl_callback_append(EWL_WIDGET(e), EWL_CALLBACK_KEY_DOWN,                                                ewl_entry_cb_key_down, NULL);                if (ewl_widget_state_has(EWL_WIDGET(e), EWL_STATE_FOCUSED))                        ewl_widget_show(e->cursor);                ewl_widget_state_add(EWL_WIDGET(e), EWL_STATE_ON);        }        else        {                ewl_callback_del(EWL_WIDGET(e), EWL_CALLBACK_KEY_DOWN,                                                ewl_entry_cb_key_down);                if (ewl_widget_state_has(EWL_WIDGET(e), EWL_STATE_FOCUSED))                        ewl_widget_hide(e->cursor);                ewl_widget_state_remove(EWL_WIDGET(e), EWL_STATE_ON);        }        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param sp: The Ewl_Spectrum to set the hsv value into * @param h: The hue to set * @param s: The saturation to set * @param v: The value to set * @return Returns no value * @brief Set the HSV values for the spectrum */voidewl_spectrum_hsv_set(Ewl_Spectrum *sp, double h, double s, double v){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(sp);        DCHECK_TYPE(sp, EWL_SPECTRUM_TYPE);        sp->hsv.h = h;        sp->hsv.s = s;        sp->hsv.v = v;        if (sp->hsv.h > 360) sp->hsv.h = 360.0;        if (sp->hsv.h <= 0) sp->hsv.h = 360.0;        if (sp->hsv.s > 1.0) sp->hsv.s = 1.0;        if (sp->hsv.s < 0.0) sp->hsv.s = 0.0;        if (sp->hsv.v > 1.0) sp->hsv.v = 1.0;        if (sp->hsv.v < 0.0) sp->hsv.v = 0.0;        ewl_spectrum_rgb_from_hsv(sp);        sp->dirty = TRUE;        ewl_widget_configure(EWL_WIDGET(sp));        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param menu: The menu to setup * @param info: The info to set into the menu * @return Returns no value * @brief Initializes @a menu with @a info */voidewl_menu_from_info(Ewl_Menu *menu, Ewl_Menu_Info *info){        int i;        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(menu);        DCHECK_PARAM_PTR(info);        DCHECK_TYPE(menu, EWL_MENU_TYPE);        for (i = 0; info[i].name != NULL; i++)        {                Ewl_Widget *item;                item = ewl_menu_item_new();                ewl_button_label_set(EWL_BUTTON(item), info[i].name);                ewl_button_image_set(EWL_BUTTON(item), info[i].img, NULL);                ewl_container_child_append(EWL_CONTAINER(menu), item);                if (info[i].cb)                        ewl_callback_append(item, EWL_CALLBACK_CLICKED,                                                        info[i].cb, NULL);                ewl_widget_show(item);        }        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param s: The separator to set the orientation on * @param o: The orientation to set on the separator * @return Returns no value * @brief Set the orientation of the separator */voidewl_separator_orientation_set(Ewl_Separator *s, Ewl_Orientation o){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(s);        DCHECK_TYPE(s, EWL_SEPARATOR_TYPE);        if (s->orientation == o)                DRETURN(DLEVEL_STABLE);        s->orientation = o;        if (o == EWL_ORIENTATION_HORIZONTAL) {                ewl_widget_appearance_set(EWL_WIDGET(s), "hseparator");                ewl_object_fill_policy_set(EWL_OBJECT(s),                                           EWL_FLAG_FILL_HFILL |                                           EWL_FLAG_FILL_HSHRINKABLE);        }        else {                ewl_widget_appearance_set(EWL_WIDGET(s), "vseparator");                ewl_object_fill_policy_set(EWL_OBJECT(s),                                           EWL_FLAG_FILL_VFILL |                                           EWL_FLAG_FILL_VSHRINKABLE);        }        ewl_widget_configure(EWL_WIDGET(s));        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @internal * @param c: The container to work with * @param w: The widget to work with * @return Returns no value * @brief The child add callback */voidewl_notebook_cb_child_add(Ewl_Container *c, Ewl_Widget *w){        Ewl_Notebook *n;        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(c);        DCHECK_PARAM_PTR(w);        DCHECK_TYPE(c, EWL_CONTAINER_TYPE);        DCHECK_TYPE(w, EWL_WIDGET_TYPE);        n = EWL_NOTEBOOK(EWL_WIDGET(c)->parent);        /* stick a null tab in there so that it at least shows up */        ewl_notebook_page_tab_widget_set(n, w, NULL);        /* we have no current page, make it this one */        if (!n->cur_page)        {                ewl_notebook_visible_page_set(n, w);                ewl_widget_show(w);        }        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @internal * @return Returns no value * @brief Shuts the context system down */voidewl_text_context_shutdown(void){        DENTER_FUNCTION(DLEVEL_STABLE);        IF_FREE_HASH(context_hash);        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @internal * @param tx: The context to work with * @return Returns no value * @brief Acquires a reference to the given context */voidewl_text_context_acquire(Ewl_Text_Context *tx){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(tx);        tx->ref_count ++;        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param ps: the ps widget * @return Returns  no value. * @brief go to the next page and render it */voidewl_ps_page_next(Ewl_Ps *ps){        int page;        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(ps);        DCHECK_TYPE(ps, EWL_PS_TYPE);        if (!ps->ps_page)                DLEAVE_FUNCTION(DLEVEL_STABLE);        page = eps_page_page_get(ps->ps_page);        if (page < (eps_document_page_count_get(ps->ps_document) - 1))                page++;        ewl_ps_page_set(ps, page);        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param v: The Ewl_View to set the widget fetch callback into * @param fetch: The Ewl_View_Widget_Fetch to set into the view * @return Returns no value. * @brief This will set the given widget fetch callback into the view */voidewl_view_widget_constructor_set(Ewl_View *v, Ewl_View_Widget_Constructor c){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(v);        v->constructor = c;        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param v: View that will be destroyed * @return Returns no value * @brief Destroys the view, so its memory is returned to the system */voidewl_view_destroy(Ewl_View *v){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(v);        FREE(v);        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param v: The Ewl_View to set the expansion_view_fetch callback on * @param f: The Ewl_View_Expansion_View_Fetch callback * @return Returns no value. * @brief Sets the expansion view fetch callback into the view */voidewl_view_expansion_view_fetch_set(Ewl_View *v, Ewl_View_Expansion_View_Fetch f){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(v);        v->expansion = f;        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param v: The Ewl_View to set the header_fetch callback on * @param f: The Ewl_View_Header_Fetch callback * @return Returns no value. * @brief Sets the header fetch callback into the view */voidewl_view_header_fetch_set(Ewl_View *v, Ewl_View_Header_Fetch f){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(v);        v->header_fetch = f;        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param v: The Ewl_View to set the widget assign callback into * @param fetch: The Ewl_View_Widget_Assign to set into the view * @return Returns no value. * @brief This will set the given widget assign callback into the view */voidewl_view_widget_assign_set(Ewl_View *v, Ewl_View_Widget_Assign assign){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(v);        v->assign = assign;        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @return Returns no value. * @brief The main execution loop of EWL * * This is the  main execution loop of ewl. It dispatches * incoming events and renders updates to the evas's used by ewl. */voidewl_main(void){        DENTER_FUNCTION(DLEVEL_STABLE);        ecore_main_loop_begin();        ewl_shutdown();        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @return Returns no value. * @brief Shuts down the icon theme system */voidewl_icon_theme_shutdown(void){        DENTER_FUNCTION(DLEVEL_STABLE);        IF_FREE_HASH(ewl_icon_theme_cache);        IF_FREE_HASH(ewl_icon_fallback_theme_cache);        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param ps: the ps widget * @return Returns  no value. * @brief go to the previous page and render it */voidewl_ps_page_previous(Ewl_Ps *ps){        int page;        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(ps);        DCHECK_TYPE(ps, EWL_PS_TYPE);        if (!ps->ps_page)                DLEAVE_FUNCTION(DLEVEL_STABLE);        page = eps_page_page_get(ps->ps_page);        if (page > 0)                page--;        ewl_ps_page_set(ps, page);        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param p: The popup * @param fit: TRUE or FALSE * @return Returns no value * @brief */voidewl_popup_fit_to_follow_set(Ewl_Popup *p, int fit){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(p);        DCHECK_TYPE(p, EWL_POPUP_TYPE);        p->fit_to_follow = !!fit;        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param b: the border widget to change the text * @param t: the text to set for the border label * @return Returns no value. * @brief Set the label for the border * * Change the text of the border label to the string @a t. */voidewl_border_label_set(Ewl_Border *b, const char *t){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(b);        DCHECK_TYPE(b, EWL_BORDER_TYPE);        ewl_label_text_set(EWL_LABEL(b->label), t);        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param s: The scrollport to work with * @param fps: The desired frames per second * @return Returns no value * @brief Sets the number of times per second to recalculate velocity and update the tree */voidewl_scrollport_kinetic_fps_set(Ewl_Scrollport *s, int fps){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(s);        DCHECK_TYPE(s, EWL_SCROLLPORT_TYPE);        s->kinfo->fps = fps;        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param s: The scrollport to work with * @param d: The multiplier to reduce velocity * @return Returns no value * @brief Sets the multiplier to reduce the velocity of kinetic scrolling */voidewl_scrollport_kinetic_dampen_set(Ewl_Scrollport *s, double d){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(s);        DCHECK_TYPE(s, EWL_SCROLLPORT_TYPE);        s->kinfo->dampen = d;        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param s: The scrollport to work with * @param v: The minimum velocity * @return Returns no value * @brief Sets the minimum velocity for kinetic scrolling */voidewl_scrollport_kinetic_min_velocity_set(Ewl_Scrollport *s, double v){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(s);        DCHECK_TYPE(s, EWL_SCROLLPORT_TYPE);        s->kinfo->vmin = v;        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param n: The Ewl_Notebook to set the tabbar alignment of * @param align: The Ewl_Alignment to set the alignment too * @return Returns no value. * @brief Set the alignment of the tabbar in the notebook widget */voidewl_notebook_tabbar_alignment_set(Ewl_Notebook *n, unsigned int align){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(n);        DCHECK_TYPE(n, EWL_NOTEBOOK_TYPE);        ewl_object_alignment_set(EWL_OBJECT(n->body.tabbar), align);        DLEAVE_FUNCTION(DLEVEL_STABLE);}

/** * @param n: The Ewl_Notebook to make homogeneous * @param h: Boolean value to set the notebook's homogeneous value * @return Returns no value * @brief Sets the tabs in the notebook to be the same size **/voidewl_notebook_tabbar_homogeneous_set(Ewl_Notebook *n, unsigned int h){        DENTER_FUNCTION(DLEVEL_STABLE);        DCHECK_PARAM_PTR(n);        DCHECK_TYPE(n, EWL_NOTEBOOK_TYPE);        ewl_box_homogeneous_set(EWL_BOX(n->body.tabbar), !!h);        DLEAVE_FUNCTION(DLEVEL_STABLE);}