1 /* 2 * DO NOT INCLUDE THIS HEADER INSIDE ANY SOURCE. 3 * THIS IS ONLY FOR ELEMENTARY API DEPRECATION HISTORY AND WILL BE REMOVED LATER. 4 * THIS WILL BE MAINLY MANAGED BY JIYOUN PARK (jypark). 5 * 6 * (deprecation process) 7 * 1. mark EINA_DEPRECATED and move declarations to elm_deprecated.h. 8 * 2. remove it from elm_deprecated.h and apply it to all trunk. 9 * 3. move it to elm_removed.h. 10 */ 11 12 #error "do not include this" 13 14 /** 15 * @image html img/widget/toggle/preview-00.png 16 * @image latex img/widget/toggle/preview-00.eps 17 * 18 * @brief A toggle is a slider which can be used to toggle between 19 * two values. It has two states: on and off. 20 * 21 * This widget is deprecated. Please use elm_check_add() instead using the 22 * toggle style like: 23 * 24 * @code 25 * obj = elm_check_add(parent); 26 * elm_object_style_set(obj, "toggle"); 27 * elm_object_part_text_set(obj, "on", "ON"); 28 * elm_object_part_text_set(obj, "off", "OFF"); 29 * @endcode 30 * 31 * Signals that you can add callbacks for are: 32 * @li "changed" - Whenever the toggle value has been changed. Is not called 33 * until the toggle is released by the cursor (assuming it 34 * has been triggered by the cursor in the first place). 35 * 36 * Default content parts of the toggle widget that you can use for are: 37 * @li "icon" - An icon of the toggle 38 * 39 * Default text parts of the toggle widget that you can use for are: 40 * @li "elm.text" - Label of the toggle 41 * 42 * @ref tutorial_toggle show how to use a toggle. 43 * @{ 44 */ 45 46 /** 47 * @brief Add a toggle to @p parent. 48 * 49 * @param parent The parent object 50 * 51 * @return The toggle object 52 */ 53 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_add(Evas_Object *parent); 54 55 /** 56 * @brief Sets the label to be displayed with the toggle. 57 * 58 * @param obj The toggle object 59 * @param label The label to be displayed 60 * 61 * @deprecated use elm_object_text_set() instead. 62 */ 63 EINA_DEPRECATED EAPI void elm_toggle_label_set(Evas_Object *obj, const char *label); 64 65 /** 66 * @brief Get the label of the toggle 67 * 68 * @param obj toggle object 69 * @return The label of the toggle 70 * 71 * @deprecated use elm_object_text_get() instead. 72 */ 73 EINA_DEPRECATED EAPI const char *elm_toggle_label_get(const Evas_Object *obj); 74 75 /** 76 * @brief Set the icon used for the toggle 77 * 78 * @param obj The toggle object 79 * @param icon The icon object for the button 80 * 81 * Once the icon object is set, a previously set one will be deleted 82 * If you want to keep that old content object, use the 83 * elm_toggle_icon_unset() function. 84 * 85 * @deprecated use elm_object_part_content_set() instead. 86 */ 87 EINA_DEPRECATED EAPI void elm_toggle_icon_set(Evas_Object *obj, Evas_Object *icon); 88 89 /** 90 * @brief Get the icon used for the toggle 91 * 92 * @param obj The toggle object 93 * @return The icon object that is being used 94 * 95 * Return the icon object which is set for this widget. 96 * 97 * @deprecated use elm_object_part_content_get() instead. 98 */ 99 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_get(const Evas_Object *obj); 100 101 /** 102 * @brief Unset the icon used for the toggle 103 * 104 * @param obj The toggle object 105 * @return The icon object that was being used 106 * 107 * Unparent and return the icon object which was set for this widget. 108 * 109 * @deprecated use elm_object_part_content_unset() instead. 110 */ 111 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_unset(Evas_Object *obj); 112 113 /** 114 * @brief Sets the labels to be associated with the on and off states of the toggle. 115 * 116 * @param obj The toggle object 117 * @param onlabel The label displayed when the toggle is in the "on" state 118 * @param offlabel The label displayed when the toggle is in the "off" state 119 * 120 * @deprecated use elm_object_part_text_set() for "on" and "off" parts 121 * instead. 122 */ 123 EINA_DEPRECATED EAPI void elm_toggle_states_labels_set(Evas_Object *obj, const char *onlabel, const char *offlabel); 124 125 /** 126 * @brief Get the labels associated with the on and off states of the 127 * toggle. 128 * 129 * @param obj The toggle object 130 * @param onlabel A char** to place the onlabel of @p obj into 131 * @param offlabel A char** to place the offlabel of @p obj into 132 * 133 * @deprecated use elm_object_part_text_get() for "on" and "off" parts 134 * instead. 135 */ 136 EINA_DEPRECATED EAPI void elm_toggle_states_labels_get(const Evas_Object *obj, const char **onlabel, const char **offlabel); 137 138 /** 139 * @brief Sets the state of the toggle to @p state. 140 * 141 * @param obj The toggle object 142 * @param state The state of @p obj 143 * 144 * @deprecated use elm_check_state_set() instead. 145 */ 146 EINA_DEPRECATED EAPI void elm_toggle_state_set(Evas_Object *obj, Eina_Bool state); 147 148 /** 149 * @brief Get the state of the toggle to @p state. 150 * 151 * @param obj The toggle object 152 * @return The state of @p obj 153 * 154 * @deprecated use elm_check_state_get() instead. 155 */ 156 EINA_DEPRECATED EAPI Eina_Bool elm_toggle_state_get(const Evas_Object *obj); 157 158 /** 159 * @brief Sets the state pointer of the toggle to @p statep. 160 * 161 * @param obj The toggle object 162 * @param statep The state pointer of @p obj 163 * 164 * @deprecated use elm_check_state_pointer_set() instead. 165 */ 166 EINA_DEPRECATED EAPI void elm_toggle_state_pointer_set(Evas_Object *obj, Eina_Bool *statep); 167 168 /** 169 * @} 170 */ 171 172 /** 173 * @brief Get Elementary's rendering engine in use. 174 * 175 * @return The rendering engine's name 176 * @note there's no need to free the returned string, here. 177 * 178 * This gets the global rendering engine that is applied to all Elementary 179 * applications. 180 * 181 * @see elm_engine_set() 182 * @deprecated Use elm_engine_get() instead. 183 */ 184 EINA_DEPRECATED EAPI const char *elm_engine_current_get(void); 185 186 /** 187 * Set the configured finger size for all applications on the display 188 * 189 * This sets the globally configured finger size in pixels for all 190 * applications on the display 191 * 192 * @param size The finger size 193 * @ingroup Elm_Fingers 194 * @deprecated Use elm_config_finger_size_set() and elm_config_all_flush() 195 */ 196 EINA_DEPRECATED EAPI void elm_finger_size_all_set(Evas_Coord size); 197 198 /** 199 * Set the global scaling factor for all applications on the display 200 * 201 * This sets the globally configured scaling factor that is applied to all 202 * objects for all applications. 203 * @param scale The scaling factor to set 204 * @ingroup Elm_Scaling 205 * @deprecated use elm_scale_set() and elm_config_all_flush() 206 */ 207 EINA_DEPRECATED EAPI void elm_scale_all_set(double scale); 208 209 /** 210 * Apply the changes made with elm_font_overlay_set() and 211 * elm_font_overlay_unset() on all Elementary application windows. 212 * 213 * @ingroup Elm_Fonts 214 * 215 * This applies all font overlays set to all objects in the UI. 216 * @deprecated Use elm_font_overlay_apply and elm_config_all_flush() 217 */ 218 EINA_DEPRECATED EAPI void elm_font_overlay_all_apply(void); 219 220 /** 221 * Set the configured cache flush interval time for all applications on the 222 * display 223 * 224 * This sets the globally configured cache flush interval time -- in ticks 225 * -- for all applications on the display. 226 * 227 * @param size The cache flush interval time 228 * @deprecated Use elm_cache_flush_interval_set() and elm_config_all_flush() 229 * @ingroup Elm_Caches 230 */ 231 EINA_DEPRECATED EAPI void elm_cache_flush_interval_all_set(int size); 232 233 /** 234 * Set the configured cache flush enabled state for all applications on the 235 * display 236 * 237 * This sets the globally configured cache flush enabled state for all 238 * applications on the display. 239 * 240 * @param enabled The cache flush enabled state 241 * @deprecated Use elm_cache_flush_enabled_set and elm_config_all_flush() 242 * @ingroup Elm_Caches 243 */ 244 EINA_DEPRECATED EAPI void elm_cache_flush_enabled_all_set(Eina_Bool enabled); 245 246 /** 247 * Set the configured font cache size for all applications on the 248 * display 249 * 250 * This sets the globally configured font cache size -- in bytes 251 * -- for all applications on the display. 252 * 253 * @param size The font cache size 254 * @deprecated Use elm_font_cache_set() and elm_config_all_flush() 255 * @ingroup Elm_Caches 256 */ 257 EINA_DEPRECATED EAPI void elm_font_cache_all_set(int size); 258 259 /** 260 * Set the configured image cache size for all applications on the 261 * display 262 * 263 * This sets the globally configured image cache size -- in bytes 264 * -- for all applications on the display. 265 * 266 * @param size The image cache size 267 * @deprecated Use elm_image_cache_set() and elm_config_all_flush() 268 * @ingroup Elm_Caches 269 */ 270 EINA_DEPRECATED EAPI void elm_image_cache_all_set(int size); 271 272 /** 273 * Set the configured edje file cache size for all applications on the 274 * display 275 * 276 * This sets the globally configured edje file cache size -- in number 277 * of files -- for all applications on the display. 278 * 279 * @param size The edje file cache size 280 * @deprecated Use elm_edje_file_cache_set() and elm_config_all_flush() 281 * @ingroup Elm_Caches 282 */ 283 EINA_DEPRECATED EAPI void elm_edje_file_cache_all_set(int size); 284 285 /** 286 * Set the configured edje collections (groups) cache size for all 287 * applications on the display 288 * 289 * This sets the globally configured edje collections cache size -- in 290 * number of collections -- for all applications on the display. 291 * 292 * @param size The edje collections cache size 293 * @deprecated Use elm_edje_collection_cache_set() and elm_config_all_flush() 294 * @ingroup Elm_Caches 295 */ 296 EINA_DEPRECATED EAPI void elm_edje_collection_cache_all_set(int size); 297 298 /** 299 * Set Elementary's profile. 300 * 301 * This sets the global profile that is applied to all Elementary 302 * applications. All running Elementary windows will be affected. 303 * 304 * @param profile The profile's name 305 * @deprecated Use elm_profile_set() and elm_config_all_flush() 306 * @ingroup Elm_Profile 307 * 308 */ 309 EINA_DEPRECATED EAPI void elm_profile_all_set(const char *profile); 310 311 /** 312 * Set whether scrollers should bounce when they reach their 313 * viewport's edge during a scroll, for all Elementary application 314 * windows. 315 * 316 * @param enabled the thumb scroll bouncing state 317 * 318 * @see elm_thumbscroll_bounce_enabled_get() 319 * @deprecated Use elm_scroll_bounce_enabled_set() and elm_config_all_flush() 320 * @ingroup Elm_Scrolling 321 */ 322 EINA_DEPRECATED EAPI void elm_scroll_bounce_enabled_all_set(Eina_Bool enabled); 323 324 /** 325 * Set the amount of inertia a scroller will impose at bounce 326 * animations, for all Elementary application windows. 327 * 328 * @param friction the thumb scroll bounce friction 329 * 330 * @see elm_thumbscroll_bounce_friction_get() 331 * @deprecated Use elm_scroll_bounce_friction_set() and elm_config_all_flush() 332 * @ingroup Elm_Scrolling 333 */ 334 EINA_DEPRECATED EAPI void elm_scroll_bounce_friction_all_set(double friction); 335 336 /** 337 * Set the amount of inertia a <b>paged</b> scroller will impose at 338 * page fitting animations, for all Elementary application windows. 339 * 340 * @param friction the page scroll friction 341 * 342 * @see elm_thumbscroll_page_scroll_friction_get() 343 * @deprecated Use elm_scroll_page_scroll_friction_set() and 344 * elm_config_all_flush() 345 * @ingroup Elm_Scrolling 346 */ 347 EINA_DEPRECATED EAPI void elm_scroll_page_scroll_friction_all_set(double friction); 348 349 /** 350 * Set the amount of inertia a scroller will impose at region bring 351 * animations, for all Elementary application windows. 352 * 353 * @param friction the bring in scroll friction 354 * 355 * @see elm_thumbscroll_bring_in_scroll_friction_get() 356 * @deprecated Use elm_scroll_bring_in_scroll_friction_set() and 357 * elm_config_all_flush() 358 * @ingroup Elm_Scrolling 359 */ 360 EINA_DEPRECATED EAPI void elm_scroll_bring_in_scroll_friction_all_set(double friction); 361 362 /** 363 * Set the amount of inertia scrollers will impose at animations 364 * triggered by Elementary widgets' zooming API, for all Elementary 365 * application windows. 366 * 367 * @param friction the zoom friction 368 * 369 * @see elm_thumbscroll_zoom_friction_get() 370 * @deprecated Use elm_scroll_zoom_friction_set() and elm_config_all_flush() 371 * @ingroup Elm_Scrolling 372 */ 373 EINA_DEPRECATED EAPI void elm_scroll_zoom_friction_all_set(double friction); 374 375 /** 376 * Set whether scrollers should be draggable from any point in their 377 * views, for all Elementary application windows. 378 * 379 * @param enabled the thumb scroll state 380 * 381 * @see elm_thumbscroll_enabled_get() 382 * @deprecated Use elm_scroll_thumbscroll_enabled_set() 383 * and elm_config_all_flush() 384 * 385 * @ingroup Elm_Scrolling 386 */ 387 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_enabled_all_set(Eina_Bool enabled); 388 389 /** 390 391 * Set the number of pixels one should travel while dragging a 392 * scroller's view to actually trigger scrolling, for all Elementary 393 * application windows. 394 * 395 * @param threshold the thumb scroll threshold 396 * 397 * @see elm_thumbscroll_threshold_get() 398 * @deprecated Use elm_scroll_thumbscroll_threshold_set() 399 * and elm_config_all_flush() 400 * 401 * @ingroup Elm_Scrolling 402 */ 403 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_threshold_all_set(unsigned int threshold); 404 405 /** 406 * Set the minimum speed of mouse cursor movement which will trigger 407 * list self scrolling animation after a mouse up event 408 * (pixels/second), for all Elementary application windows. 409 * 410 * @param threshold the thumb scroll momentum threshold 411 * 412 * @see elm_thumbscroll_momentum_threshold_get() 413 * @deprecated Use elm_scroll_thumbscroll_momentum_threshold_set() 414 * and elm_config_all_flush() 415 * 416 * @ingroup Elm_Scrolling 417 */ 418 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_momentum_threshold_all_set(double threshold); 419 420 /** 421 * Set the amount of inertia a scroller will impose at self scrolling 422 * animations, for all Elementary application windows. 423 * 424 * @param friction the thumb scroll friction 425 * 426 * @see elm_thumbscroll_friction_get() 427 * @deprecated Use elm_scroll_thumbscroll_friction_set() 428 * and elm_config_all_flush() 429 * 430 * @ingroup Elm_Scrolling 431 */ 432 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_friction_all_set(double friction); 433 434 /** 435 * Set the amount of lag between your actual mouse cursor dragging 436 * movement and a scroller's view movement itself, while pushing it 437 * into bounce state manually, for all Elementary application windows. 438 * 439 * @param friction the thumb scroll border friction. @c 0.0 for 440 * perfect synchrony between two movements, @c 1.0 for maximum 441 * lag. 442 * 443 * @see elm_thumbscroll_border_friction_get() 444 * @note parameter value will get bound to 0.0 - 1.0 interval, always 445 * @deprecated Use elm_scroll_thumbscroll_border_friction_set() 446 * and elm_config_all_flush() 447 * 448 * @ingroup Elm_Scrolling 449 */ 450 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_border_friction_all_set(double friction); 451 452 /** 453 * Set the sensitivity amount which is be multiplied by the length of 454 * mouse dragging, for all Elementary application windows. 455 * 456 * @param friction the thumb scroll sensitivity friction. @c 0.1 for 457 * minimum sensitivity, @c 1.0 for maximum sensitivity. 0.25 458 * is proper. 459 * 460 * @see elm_thumbscroll_sensitivity_friction_get() 461 * @note parameter value will get bound to 0.1 - 1.0 interval, always 462 * @deprecated Use elm_scroll_thumbscroll_sensitivity_friction_set() 463 * and elm_config_all_flush() 464 * 465 * @ingroup Elm_Scrolling 466 */ 467 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_sensitivity_friction_all_set(double friction); 468 469 EINA_DEPRECATED EAPI void elm_gen_clear(Evas_Object *obj); 470 EINA_DEPRECATED EAPI void elm_gen_item_selected_set(Elm_Gen_Item *it, Eina_Bool selected); 471 EINA_DEPRECATED EAPI Eina_Bool elm_gen_item_selected_get(const Elm_Gen_Item *it); 472 EINA_DEPRECATED EAPI void elm_gen_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select); 473 EINA_DEPRECATED EAPI Eina_Bool elm_gen_always_select_mode_get(const Evas_Object *obj); 474 EINA_DEPRECATED EAPI void elm_gen_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select); 475 EINA_DEPRECATED EAPI Eina_Bool elm_gen_no_select_mode_get(const Evas_Object *obj); 476 EINA_DEPRECATED EAPI void elm_gen_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce); 477 EINA_DEPRECATED EAPI void elm_gen_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce); 478 EINA_DEPRECATED EAPI void elm_gen_page_relative_set(Evas_Object *obj, double h_pagerel, double v_pagerel); 479 EINA_DEPRECATED EAPI void elm_gen_page_relative_get(const Evas_Object *obj, double *h_pagerel, double *v_pagerel); 480 481 EINA_DEPRECATED EAPI void elm_gen_page_size_set(Evas_Object *obj, Evas_Coord h_pagesize, Evas_Coord v_pagesize); 482 EINA_DEPRECATED EAPI void elm_gen_current_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber); 483 EINA_DEPRECATED EAPI void elm_gen_last_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber); 484 EINA_DEPRECATED EAPI void elm_gen_page_show(const Evas_Object *obj, int h_pagenumber, int v_pagenumber); 485 EINA_DEPRECATED EAPI void elm_gen_page_bring_in(const Evas_Object *obj, int h_pagenumber, int v_pagenumber); 486 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_first_item_get(const Evas_Object *obj); 487 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_last_item_get(const Evas_Object *obj); 488 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_next_get(const Elm_Gen_Item *it); 489 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_prev_get(const Elm_Gen_Item *it); 490 EINA_DEPRECATED EAPI Evas_Object *elm_gen_item_widget_get(const Elm_Gen_Item *it); 491 492 /** 493 * Set the text to show in the anchorblock 494 * 495 * Sets the text of the anchorblock to @p text. This text can include markup 496 * format tags, including <c>\<a href=anchorname\></a></c> to begin a segment 497 * of text that will be specially styled and react to click events, ended 498 * with either of \</a\> or \</\>. When clicked, the anchor will emit an 499 * "anchor,clicked" signal that you can attach a callback to with 500 * evas_object_smart_callback_add(). The name of the anchor given in the 501 * event info struct will be the one set in the href attribute, in this 502 * case, anchorname. 503 * 504 * Other markup can be used to style the text in different ways, but it's 505 * up to the style defined in the theme which tags do what. 506 * @deprecated use elm_object_text_set() instead. 507 */ 508 EINA_DEPRECATED EAPI void elm_anchorblock_text_set(Evas_Object *obj, const char *text); 509 510 /** 511 * Get the markup text set for the anchorblock 512 * 513 * Gets the text set on the anchorblock, with markup tags included. 514 * 515 * @param obj The anchorblock object 516 * @return The markup text set or @c NULL if nothing was set or an error 517 * occurred 518 * @deprecated use elm_object_text_set() instead. 519 */ 520 EINA_DEPRECATED EAPI const char *elm_anchorblock_text_get(const Evas_Object *obj); 521 522 /** 523 * Set the text to show in the anchorview 524 * 525 * Sets the text of the anchorview to @p text. This text can include markup 526 * format tags, including <c>\<a href=anchorname\></c> to begin a segment of 527 * text that will be specially styled and react to click events, ended with 528 * either of \</a\> or \</\>. When clicked, the anchor will emit an 529 * "anchor,clicked" signal that you can attach a callback to with 530 * evas_object_smart_callback_add(). The name of the anchor given in the 531 * event info struct will be the one set in the href attribute, in this 532 * case, anchorname. 533 * 534 * Other markup can be used to style the text in different ways, but it's 535 * up to the style defined in the theme which tags do what. 536 * @deprecated use elm_object_text_set() instead. 537 */ 538 EINA_DEPRECATED EAPI void elm_anchorview_text_set(Evas_Object *obj, const char *text); 539 540 /** 541 * Get the markup text set for the anchorview 542 * 543 * Gets the text set on the anchorview, with markup tags included. 544 * 545 * @param obj The anchorview object 546 * @return The markup text set or @c NULL if nothing was set or an error 547 * occurred 548 * @deprecated use elm_object_text_set() instead. 549 */ 550 EINA_DEPRECATED EAPI const char *elm_anchorview_text_get(const Evas_Object *obj); 551 552 /** 553 * @brief Get the ctxpopup item's disabled/enabled state. 554 * 555 * @param it Ctxpopup item to be enabled/disabled 556 * @return disabled @c EINA_TRUE, if disabled, @c EINA_FALSE otherwise 557 * 558 * @see elm_ctxpopup_item_disabled_set() 559 * @deprecated use elm_object_item_disabled_get() instead 560 * 561 * @ingroup Elm_Ctxpopup 562 */ 563 EINA_DEPRECATED EAPI Eina_Bool elm_ctxpopup_item_disabled_get(const Elm_Object_Item *it); 564 565 /** 566 * @brief Set the ctxpopup item's state as disabled or enabled. 567 * 568 * @param it Ctxpopup item to be enabled/disabled 569 * @param disabled @c EINA_TRUE to disable it, @c EINA_FALSE to enable it 570 * 571 * When disabled the item is greyed out to indicate it's state. 572 * @deprecated use elm_object_item_disabled_set() instead 573 * 574 * @ingroup Elm_Ctxpopup 575 */ 576 EINA_DEPRECATED EAPI void elm_ctxpopup_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled); 577 578 /** 579 * @brief Get the icon object for the given ctxpopup item. 580 * 581 * @param it Ctxpopup item 582 * @return icon object or @c NULL, if the item does not have icon or an error 583 * occurred 584 * 585 * @see elm_ctxpopup_item_append() 586 * @see elm_ctxpopup_item_icon_set() 587 * 588 * @deprecated use elm_object_item_part_content_get() instead 589 * 590 * @ingroup Elm_Ctxpopup 591 */ 592 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_item_icon_get(const Elm_Object_Item *it); 593 594 /** 595 * @brief Sets the side icon associated with the ctxpopup item 596 * 597 * @param it Ctxpopup item 598 * @param icon Icon object to be set 599 * 600 * Once the icon object is set, a previously set one will be deleted. 601 * @warning Setting the same icon for two items will cause the icon to 602 * disappear from the first item. 603 * 604 * @see elm_ctxpopup_item_append() 605 * 606 * @deprecated use elm_object_item_part_content_set() instead 607 * 608 * @ingroup Elm_Ctxpopup 609 */ 610 EINA_DEPRECATED EAPI void elm_ctxpopup_item_icon_set(Elm_Object_Item *it, Evas_Object *icon); 611 612 /** 613 * @brief Get the label for the given ctxpopup item. 614 * 615 * @param it Ctxpopup item 616 * @return label string or @c NULL, if the item does not have label or an 617 * error occurred 618 * 619 * @see elm_ctxpopup_item_append() 620 * @see elm_ctxpopup_item_label_set() 621 * 622 * @deprecated use elm_object_item_text_get() instead 623 * 624 * @ingroup Elm_Ctxpopup 625 */ 626 EINA_DEPRECATED EAPI const char *elm_ctxpopup_item_label_get(const Elm_Object_Item *it); 627 628 /** 629 * @brief (Re)set the label on the given ctxpopup item. 630 * 631 * @param it Ctxpopup item 632 * @param label String to set as label 633 * 634 * @deprecated use elm_object_item_text_set() instead 635 * 636 * @ingroup Elm_Ctxpopup 637 */ 638 EINA_DEPRECATED EAPI void elm_ctxpopup_item_label_set(Elm_Object_Item *it, const char *label); 639 640 /** 641 * @brief Set an elm widget as the content of the ctxpopup. 642 * 643 * @param obj Ctxpopup object 644 * @param content Content to be swallowed 645 * 646 * If the content object is already set, a previous one will be deleted. If 647 * you want to keep that old content object, use the 648 * elm_ctxpopup_content_unset() function. 649 * 650 * @warning Ctxpopup can't hold both a item list and a content at the same 651 * time. When a content is set, any previous items will be removed. 652 * 653 * @deprecated use elm_object_content_set() instead 654 * 655 * @ingroup Elm_Ctxpopup 656 */ 657 EINA_DEPRECATED EAPI void elm_ctxpopup_content_set(Evas_Object *obj, Evas_Object *content); 658 659 /** 660 * @brief Unset the ctxpopup content 661 * 662 * @param obj Ctxpopup object 663 * @return The content that was being used 664 * 665 * Unparent and return the content object which was set for this widget. 666 * 667 * @deprecated use elm_object_content_unset() 668 * 669 * @see elm_ctxpopup_content_set() 670 * 671 * @deprecated use elm_object_content_unset() instead 672 * 673 * @ingroup Elm_Ctxpopup 674 */ 675 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_content_unset(Evas_Object *obj); 676 677 /** 678 * @brief Delete the given item in a ctxpopup object. 679 * 680 * @param it Ctxpopup item to be deleted 681 * 682 * @deprecated Use elm_object_item_del() instead 683 * @see elm_ctxpopup_item_append() 684 * 685 * @ingroup Elm_Ctxpopup 686 */ 687 EINA_DEPRECATED EAPI void elm_ctxpopup_item_del(Elm_Object_Item *it); 688 689 /** 690 * Set the label for a given file selector button widget 691 * 692 * @param obj The file selector button widget 693 * @param label The text label to be displayed on @p obj 694 * 695 * @deprecated use elm_object_text_set() instead. 696 */ 697 EINA_DEPRECATED EAPI void elm_fileselector_button_label_set(Evas_Object *obj, const char *label); 698 699 /** 700 * Get the label set for a given file selector button widget 701 * 702 * @param obj The file selector button widget 703 * @return The button label 704 * 705 * @deprecated use elm_object_text_set() instead. 706 */ 707 EINA_DEPRECATED EAPI const char *elm_fileselector_button_label_get(const Evas_Object *obj); 708 709 /** 710 * Set the icon on a given file selector button widget 711 * 712 * @param obj The file selector button widget 713 * @param icon The icon object for the button 714 * 715 * Once the icon object is set, a previously set one will be 716 * deleted. If you want to keep the latter, use the 717 * elm_fileselector_button_icon_unset() function. 718 * 719 * @deprecated Use elm_object_part_content_set() instead 720 * @see elm_fileselector_button_icon_get() 721 */ 722 EINA_DEPRECATED EAPI void elm_fileselector_button_icon_set(Evas_Object *obj, Evas_Object *icon); 723 724 /** 725 * Get the icon set for a given file selector button widget 726 * 727 * @param obj The file selector button widget 728 * @return The icon object currently set on @p obj or @c NULL, if 729 * none is 730 * 731 * @deprecated Use elm_object_part_content_get() instead 732 * @see elm_fileselector_button_icon_set() 733 */ 734 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_button_icon_get(const Evas_Object *obj); 735 736 /** 737 * Unset the icon used in a given file selector button widget 738 * 739 * @param obj The file selector button widget 740 * @return The icon object that was being used on @p obj or @c 741 * NULL, on errors 742 * 743 * Unparent and return the icon object which was set for this 744 * widget. 745 * 746 * @deprecated Use elm_object_part_content_unset() instead 747 * @see elm_fileselector_button_icon_set() 748 */ 749 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_button_icon_unset(Evas_Object *obj); 750 751 /** 752 * Set the label for a given file selector entry widget's button 753 * 754 * @param obj The file selector entry widget 755 * @param label The text label to be displayed on @p obj widget's 756 * button 757 * 758 * @deprecated use elm_object_text_set() instead. 759 */ 760 EINA_DEPRECATED EAPI void elm_fileselector_entry_button_label_set(Evas_Object *obj, const char *label); 761 762 /** 763 * Get the label set for a given file selector entry widget's button 764 * 765 * @param obj The file selector entry widget 766 * @return The widget button's label 767 * 768 * @deprecated use elm_object_text_set() instead. 769 */ 770 EINA_DEPRECATED EAPI const char *elm_fileselector_entry_button_label_get(const Evas_Object *obj); 771 772 /** 773 * Set the icon on a given file selector entry widget's button 774 * 775 * @param obj The file selector entry widget 776 * @param icon The icon object for the entry's button 777 * 778 * Once the icon object is set, a previously set one will be 779 * deleted. If you want to keep the latter, use the 780 * elm_fileselector_entry_button_icon_unset() function. 781 * 782 * @deprecated Use elm_object_part_content_set() instead 783 * @see elm_fileselector_entry_button_icon_get() 784 */ 785 EINA_DEPRECATED EAPI void elm_fileselector_entry_button_icon_set(Evas_Object *obj, Evas_Object *icon); 786 787 /** 788 * Get the icon set for a given file selector entry widget's button 789 * 790 * @param obj The file selector entry widget 791 * @return The icon object currently set on @p obj widget's button 792 * or @c NULL, if none is 793 * 794 * @deprecated Use elm_object_part_content_get() instead 795 * @see elm_fileselector_entry_button_icon_set() 796 */ 797 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_entry_button_icon_get(const Evas_Object *obj); 798 799 /** 800 * Unset the icon used in a given file selector entry widget's 801 * button 802 * 803 * @param obj The file selector entry widget 804 * @return The icon object that was being used on @p obj widget's 805 * button or @c NULL, on errors 806 * 807 * Unparent and return the icon object which was set for this 808 * widget's button. 809 * 810 * @deprecated Use elm_object_part_content_unset() instead 811 * @see elm_fileselector_entry_button_icon_set() 812 */ 813 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_entry_button_icon_unset(Evas_Object *obj); 814 815 /** 816 * @brief Sets the content of the hover object and the direction in which it 817 * will pop out. 818 * 819 * @param obj The hover object 820 * @param swallow The direction that the object will be displayed 821 * at. Accepted values are "left", "top-left", "top", "top-right", 822 * "right", "bottom-right", "bottom", "bottom-left", "middle" and 823 * "smart". 824 * @param content The content to place at @p swallow 825 * 826 * Once the content object is set for a given direction, a previously 827 * set one (on the same direction) will be deleted. If you want to 828 * keep that old content object, use the elm_object_part_content_unset() 829 * function. 830 * 831 * All directions may have contents at the same time, except for 832 * "smart". This is a special placement hint and its use case 833 * depends of the calculations coming from 834 * elm_hover_best_content_location_get(). Its use is for cases when 835 * one desires only one hover content, but with a dynamic special 836 * placement within the hover area. The content's geometry, whenever 837 * it changes, will be used to decide on a best location, not 838 * extrapolating the hover's parent object view to show it in (still 839 * being the hover's target determinant of its medium part -- move and 840 * resize it to simulate finger sizes, for example). If one of the 841 * directions other than "smart" are used, a previously content set 842 * using it will be deleted, and vice-versa. 843 * 844 * @deprecated Use elm_object_part_content_set() instead 845 */ 846 EINA_DEPRECATED EAPI void elm_hover_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content); 847 848 /** 849 * @brief Get the content of the hover object, in a given direction. 850 * 851 * Return the content object which was set for this widget in the 852 * @p swallow direction. 853 * 854 * @param obj The hover object 855 * @param swallow The direction that the object was display at. 856 * @return The content that was being used 857 * 858 * @deprecated Use elm_object_part_content_get() instead 859 * @see elm_object_part_content_set() 860 */ 861 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_get(const Evas_Object *obj, const char *swallow); 862 863 /** 864 * @brief Unset the content of the hover object, in a given direction. 865 * 866 * Unparent and return the content object set at @p swallow direction. 867 * 868 * @param obj The hover object 869 * @param swallow The direction that the object was display at. 870 * @return The content that was being used. 871 * 872 * @deprecated Use elm_object_part_content_unset() instead 873 * @see elm_object_part_content_set() 874 */ 875 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_unset(Evas_Object *obj, const char *swallow); 876 877 /** 878 * @brief Set the hoversel button label 879 * 880 * @param obj The hoversel object 881 * @param label The label text. 882 * 883 * This sets the label of the button that is always visible (before it is 884 * clicked and expanded). 885 * 886 * @deprecated elm_object_text_set() 887 */ 888 EINA_DEPRECATED EAPI void elm_hoversel_label_set(Evas_Object *obj, const char *label); 889 890 /** 891 * @brief Get the hoversel button label 892 * 893 * @param obj The hoversel object 894 * @return The label text. 895 * 896 * @deprecated elm_object_text_get() 897 */ 898 EINA_DEPRECATED EAPI const char *elm_hoversel_label_get(const Evas_Object *obj); 899 900 /** 901 * @brief Set the icon of the hoversel button 902 * 903 * @param obj The hoversel object 904 * @param icon The icon object 905 * 906 * Sets the icon of the button that is always visible (before it is clicked 907 * and expanded). Once the icon object is set, a previously set one will be 908 * deleted, if you want to keep that old content object, use the 909 * elm_hoversel_icon_unset() function. 910 * 911 * @see elm_object_content_set() for the button widget 912 * @deprecated Use elm_object_item_part_content_set() instead 913 */ 914 EINA_DEPRECATED EAPI void elm_hoversel_icon_set(Evas_Object *obj, Evas_Object *icon); 915 916 /** 917 * @brief Get the icon of the hoversel button 918 * 919 * @param obj The hoversel object 920 * @return The icon object 921 * 922 * Get the icon of the button that is always visible (before it is clicked 923 * and expanded). Also see elm_object_content_get() for the button widget. 924 * 925 * @see elm_hoversel_icon_set() 926 * @deprecated Use elm_object_item_part_content_get() instead 927 */ 928 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_get(const Evas_Object *obj); 929 930 /** 931 * @brief Get and unparent the icon of the hoversel button 932 * 933 * @param obj The hoversel object 934 * @return The icon object that was being used 935 * 936 * Unparent and return the icon of the button that is always visible 937 * (before it is clicked and expanded). 938 * 939 * @see elm_hoversel_icon_set() 940 * @see elm_object_content_unset() for the button widget 941 * @deprecated Use elm_object_item_part_content_unset() instead 942 */ 943 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_unset(Evas_Object *obj); 944 945 /** 946 * @brief This returns the data pointer supplied with elm_hoversel_item_add() 947 * that will be passed to associated function callbacks. 948 * 949 * @param it The item to get the data from 950 * @return The data pointer set with elm_hoversel_item_add() 951 * 952 * @see elm_hoversel_item_add() 953 * @deprecated Use elm_object_item_data_get() instead 954 */ 955 EINA_DEPRECATED EAPI void *elm_hoversel_item_data_get(const Elm_Object_Item *it); 956 957 /** 958 * @brief This returns the label text of the given hoversel item. 959 * 960 * @param it The item to get the label 961 * @return The label text of the hoversel item 962 * 963 * @see elm_hoversel_item_add() 964 * @deprecated Use elm_object_item_text_get() instead 965 */ 966 EINA_DEPRECATED EAPI const char *elm_hoversel_item_label_get(const Elm_Object_Item *it); 967 968 /** 969 * @brief Set the function to be called when an item from the hoversel is 970 * freed. 971 * 972 * @param it The item to set the callback on 973 * @param func The function called 974 * 975 * That function will receive these parameters: 976 * @li void * item data 977 * @li Evas_Object * hoversel object 978 * @li Elm_Object_Item * hoversel item 979 * 980 * @see elm_hoversel_item_add() 981 * @deprecated Use elm_object_item_del_cb_set() instead 982 */ 983 EINA_DEPRECATED EAPI void elm_hoversel_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func); 984 985 /** 986 * @brief Delete an item from the hoversel 987 * 988 * @param it The item to delete 989 * 990 * This deletes the item from the hoversel (should not be called while the 991 * hoversel is active; use elm_hoversel_expanded_get() to check first). 992 * 993 * @deprecated Use elm_object_item_del() instead 994 * @see elm_hoversel_item_add() 995 */ 996 EINA_DEPRECATED EAPI void elm_hoversel_item_del(Elm_Object_Item *it); 997 998 /** 999 * Set actionslider labels. 1000 * 1001 * @param obj The actionslider object 1002 * @param left_label The label to be set on the left. 1003 * @param center_label The label to be set on the center. 1004 * @param right_label The label to be set on the right. 1005 * @deprecated use elm_object_text_set() instead. 1006 */ 1007 EINA_DEPRECATED EAPI void elm_actionslider_labels_set(Evas_Object *obj, const char *left_label, const char *center_label, const char *right_label); 1008 1009 /** 1010 * Get actionslider labels. 1011 * 1012 * @param obj The actionslider object 1013 * @param left_label A char** to place the left_label of @p obj into. 1014 * @param center_label A char** to place the center_label of @p obj into. 1015 * @param right_label A char** to place the right_label of @p obj into. 1016 * @deprecated use elm_object_text_set() instead. 1017 */ 1018 EINA_DEPRECATED EAPI void elm_actionslider_labels_get(const Evas_Object *obj, const char **left_label, const char **center_label, const char **right_label); 1019 1020 /** 1021 * Set the label used on the indicator. 1022 * 1023 * @param obj The actionslider object 1024 * @param label The label to be set on the indicator. 1025 * @deprecated use elm_object_text_set() instead. 1026 */ 1027 EINA_DEPRECATED EAPI void elm_actionslider_indicator_label_set(Evas_Object *obj, const char *label); 1028 1029 /** 1030 * Get the label used on the indicator object. 1031 * 1032 * @param obj The actionslider object 1033 * @return The indicator label 1034 * @deprecated use elm_object_text_get() instead. 1035 */ 1036 EINA_DEPRECATED EAPI const char *elm_actionslider_indicator_label_get(Evas_Object *obj); 1037 1038 /** 1039 * Set the overlay object used for the background object. 1040 * 1041 * @param obj The bg object 1042 * @param overlay The overlay object 1043 * 1044 * This provides a way for elm_bg to have an 'overlay' that will be on top 1045 * of the bg. Once the over object is set, a previously set one will be 1046 * deleted, even if you set the new one to NULL. If you want to keep that 1047 * old content object, use the elm_bg_overlay_unset() function. 1048 * 1049 * @deprecated use elm_object_part_content_set() instead 1050 * 1051 * @ingroup Elm_Bg 1052 */ 1053 1054 EINA_DEPRECATED EAPI void elm_bg_overlay_set(Evas_Object *obj, Evas_Object *overlay); 1055 1056 /** 1057 * Get the overlay object used for the background object. 1058 * 1059 * @param obj The bg object 1060 * @return The content that is being used 1061 * 1062 * Return the content object which is set for this widget 1063 * 1064 * @deprecated use elm_object_part_content_get() instead 1065 * 1066 * @ingroup Elm_Bg 1067 */ 1068 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_get(const Evas_Object *obj); 1069 1070 /** 1071 * Get the overlay object used for the background object. 1072 * 1073 * @param obj The bg object 1074 * @return The content that was being used 1075 * 1076 * Unparent and return the overlay object which was set for this widget 1077 * 1078 * @deprecated use elm_object_part_content_unset() instead 1079 * 1080 * @ingroup Elm_Bg 1081 */ 1082 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_unset(Evas_Object *obj); 1083 1084 1085 /** 1086 * Set the label of the bubble 1087 * 1088 * @param obj The bubble object 1089 * @param label The string to set in the label 1090 * 1091 * This function sets the title of the bubble. Where this appears depends on 1092 * the selected corner. 1093 * @deprecated use elm_object_text_set() instead. 1094 */ 1095 EINA_DEPRECATED EAPI void elm_bubble_label_set(Evas_Object *obj, const char *label); 1096 1097 /** 1098 * Get the label of the bubble 1099 * 1100 * @param obj The bubble object 1101 * @return The string of set in the label 1102 * 1103 * This function gets the title of the bubble. 1104 * @deprecated use elm_object_text_get() instead. 1105 */ 1106 EINA_DEPRECATED EAPI const char *elm_bubble_label_get(const Evas_Object *obj); 1107 1108 /** 1109 * Set the info of the bubble 1110 * 1111 * @param obj The bubble object 1112 * @param info The given info about the bubble 1113 * 1114 * This function sets the info of the bubble. Where this appears depends on 1115 * the selected corner. 1116 * @deprecated use elm_object_part_text_set() instead. (with "info" as the parameter). 1117 */ 1118 EINA_DEPRECATED EAPI void elm_bubble_info_set(Evas_Object *obj, const char *info); 1119 1120 /** 1121 * Get the info of the bubble 1122 * 1123 * @param obj The bubble object 1124 * 1125 * @return The "info" string of the bubble 1126 * 1127 * This function gets the info text. 1128 * @deprecated use elm_object_part_text_get() instead. (with "info" as the parameter). 1129 */ 1130 EINA_DEPRECATED EAPI const char *elm_bubble_info_get(const Evas_Object *obj); 1131 1132 /** 1133 * Set the content to be shown in the bubble 1134 * 1135 * Once the content object is set, a previously set one will be deleted. 1136 * If you want to keep the old content object, use the 1137 * elm_bubble_content_unset() function. 1138 * 1139 * @param obj The bubble object 1140 * @param content The given content of the bubble 1141 * 1142 * This function sets the content shown on the middle of the bubble. 1143 * 1144 * @deprecated use elm_object_content_set() instead 1145 * 1146 */ 1147 EINA_DEPRECATED EAPI void elm_bubble_content_set(Evas_Object *obj, Evas_Object *content); 1148 1149 /** 1150 * Get the content shown in the bubble 1151 * 1152 * Return the content object which is set for this widget. 1153 * 1154 * @param obj The bubble object 1155 * @return The content that is being used 1156 * 1157 * @deprecated use elm_object_content_get() instead 1158 * 1159 */ 1160 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_get(const Evas_Object *obj); 1161 1162 /** 1163 * Unset the content shown in the bubble 1164 * 1165 * Unparent and return the content object which was set for this widget. 1166 * 1167 * @param obj The bubble object 1168 * @return The content that was being used 1169 * 1170 * @deprecated use elm_object_content_unset() instead 1171 * 1172 */ 1173 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_unset(Evas_Object *obj); 1174 1175 /** 1176 * Set the icon of the bubble 1177 * 1178 * Once the icon object is set, a previously set one will be deleted. 1179 * If you want to keep the old content object, use the 1180 * elm_icon_content_unset() function. 1181 * 1182 * @param obj The bubble object 1183 * @param icon The given icon for the bubble 1184 * 1185 * @deprecated use elm_object_part_content_set() instead 1186 * 1187 */ 1188 EINA_DEPRECATED EAPI void elm_bubble_icon_set(Evas_Object *obj, Evas_Object *icon); 1189 1190 /** 1191 * Get the icon of the bubble 1192 * 1193 * @param obj The bubble object 1194 * @return The icon for the bubble 1195 * 1196 * This function gets the icon shown on the top left of bubble. 1197 * 1198 * @deprecated use elm_object_part_content_get() instead 1199 * 1200 */ 1201 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_get(const Evas_Object *obj); 1202 1203 /** 1204 * Unset the icon of the bubble 1205 * 1206 * Unparent and return the icon object which was set for this widget. 1207 * 1208 * @param obj The bubble object 1209 * @return The icon that was being used 1210 * 1211 * @deprecated use elm_object_part_content_unset() instead 1212 * 1213 */ 1214 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_unset(Evas_Object *obj); 1215 1216 1217 /** 1218 * Set the label used in the button 1219 * 1220 * The passed @p label can be NULL to clean any existing text in it and 1221 * leave the button as an icon only object. 1222 * 1223 * @param obj The button object 1224 * @param label The text will be written on the button 1225 * @deprecated use elm_object_text_set() instead. 1226 */ 1227 EINA_DEPRECATED EAPI void elm_button_label_set(Evas_Object *obj, const char *label); 1228 1229 /** 1230 * Get the label set for the button 1231 * 1232 * The string returned is an internal pointer and should not be freed or 1233 * altered. It will also become invalid when the button is destroyed. 1234 * The string returned, if not NULL, is a stringshare, so if you need to 1235 * keep it around even after the button is destroyed, you can use 1236 * eina_stringshare_ref(). 1237 * 1238 * @param obj The button object 1239 * @return The text set to the label, or NULL if nothing is set 1240 * @deprecated use elm_object_text_set() instead. 1241 */ 1242 EINA_DEPRECATED EAPI const char *elm_button_label_get(const Evas_Object *obj); 1243 1244 /** 1245 * Set the icon used for the button 1246 * 1247 * Setting a new icon will delete any other that was previously set, making 1248 * any reference to them invalid. If you need to maintain the previous 1249 * object alive, unset it first with elm_button_icon_unset(). 1250 * 1251 * @param obj The button object 1252 * @param icon The icon object for the button 1253 * @deprecated use elm_object_part_content_set() instead. 1254 */ 1255 EINA_DEPRECATED EAPI void elm_button_icon_set(Evas_Object *obj, Evas_Object *icon); 1256 1257 /** 1258 * Get the icon used for the button 1259 * 1260 * Return the icon object which is set for this widget. If the button is 1261 * destroyed or another icon is set, the returned object will be deleted 1262 * and any reference to it will be invalid. 1263 * 1264 * @param obj The button object 1265 * @return The icon object that is being used 1266 * 1267 * @deprecated use elm_object_part_content_get() instead 1268 */ 1269 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_get(const Evas_Object *obj); 1270 1271 /** 1272 * Remove the icon set without deleting it and return the object 1273 * 1274 * This function drops the reference the button holds of the icon object 1275 * and returns this last object. It is used in case you want to remove any 1276 * icon, or set another one, without deleting the actual object. The button 1277 * will be left without an icon set. 1278 * 1279 * @param obj The button object 1280 * @return The icon object that was being used 1281 * @deprecated use elm_object_part_content_unset() instead. 1282 */ 1283 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_unset(Evas_Object *obj); 1284 1285 /** 1286 * Set a day text color to the same that represents Saturdays. 1287 * 1288 * @param obj The calendar object. 1289 * @param pos The text position. Position is the cell counter, from left 1290 * to right, up to down. It starts on 0 and ends on 41. 1291 * 1292 * @deprecated use elm_calendar_mark_add() instead like: 1293 * 1294 * @code 1295 * struct tm t = { 0, 0, 12, 6, 0, 0, 6, 6, -1 }; 1296 * elm_calendar_mark_add(obj, "weekend/day1", &t, ELM_CALENDAR_WEEKLY); 1297 * @endcode 1298 * 1299 * @see elm_calendar_mark_add() 1300 * 1301 * @ingroup Elm_Calendar 1302 */ 1303 EINA_DEPRECATED EAPI void elm_calendar_text_saturday_color_set(Evas_Object *obj, int pos); 1304 1305 /** 1306 * Set a day text color to the same that represents Sundays. 1307 * 1308 * @param obj The calendar object. 1309 * @param pos The text position. Position is the cell counter, from left 1310 * to right, up to down. It starts on 0 and ends on 41. 1311 1312 * @deprecated use elm_calendar_mark_add() instead like: 1313 * 1314 * @code 1315 * struct tm t = { 0, 0, 12, 7, 0, 0, 0, 0, -1 }; 1316 * elm_calendar_mark_add(obj, "weekend/day2", &t, ELM_CALENDAR_WEEKLY); 1317 * @endcode 1318 * 1319 * @see elm_calendar_mark_add() 1320 * 1321 * @ingroup Elm_Calendar 1322 */ 1323 EINA_DEPRECATED EAPI void elm_calendar_text_sunday_color_set(Evas_Object *obj, int pos); 1324 1325 /** 1326 * Set a day text color to the same that represents Weekdays. 1327 * 1328 * @param obj The calendar object 1329 * @param pos The text position. Position is the cell counter, from left 1330 * to right, up to down. It starts on 0 and ends on 41. 1331 * 1332 * @deprecated use elm_calendar_mark_add() instead like: 1333 * 1334 * @code 1335 * struct tm t = { 0, 0, 12, 1, 0, 0, 0, 0, -1 }; 1336 * 1337 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // monday 1338 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++; 1339 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // tuesday 1340 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++; 1341 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // wednesday 1342 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++; 1343 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // thursday 1344 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++; 1345 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // friday 1346 * @endcode 1347 * 1348 * @see elm_calendar_mark_add() 1349 * 1350 * @ingroup Elm_Calendar 1351 */ 1352 EINA_DEPRECATED EAPI void elm_calendar_text_weekday_color_set(Evas_Object *obj, int pos); 1353 1354 1355 /** 1356 * @brief Set the text label of the check object 1357 * 1358 * @param obj The check object 1359 * @param label The text label string in UTF-8 1360 * 1361 * @deprecated use elm_object_text_set() instead. 1362 */ 1363 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label); 1364 1365 /** 1366 * @brief Get the text label of the check object 1367 * 1368 * @param obj The check object 1369 * @return The text label string in UTF-8 1370 * 1371 * @deprecated use elm_object_text_get() instead. 1372 */ 1373 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj); 1374 1375 /** 1376 * @brief Set the icon object of the check object 1377 * 1378 * @param obj The check object 1379 * @param icon The icon object 1380 * 1381 * Once the icon object is set, a previously set one will be deleted. 1382 * If you want to keep that old content object, use the 1383 * elm_object_content_unset() function. 1384 * 1385 * @deprecated use elm_object_part_content_set() instead. 1386 * 1387 */ 1388 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon); 1389 1390 /** 1391 * @brief Get the icon object of the check object 1392 * 1393 * @param obj The check object 1394 * @return The icon object 1395 * 1396 * @deprecated use elm_object_part_content_get() instead. 1397 * 1398 */ 1399 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj); 1400 1401 /** 1402 * @brief Unset the icon used for the check object 1403 * 1404 * @param obj The check object 1405 * @return The icon object that was being used 1406 * 1407 * Unparent and return the icon object which was set for this widget. 1408 * 1409 * @deprecated use elm_object_part_content_unset() instead. 1410 * 1411 */ 1412 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj); 1413 1414 /** 1415 * @brief Set the text label of the check object 1416 * 1417 * @param obj The check object 1418 * @param label The text label string in UTF-8 1419 * 1420 * @deprecated use elm_object_text_set() instead. 1421 */ 1422 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label); 1423 1424 /** 1425 * @brief Get the text label of the check object 1426 * 1427 * @param obj The check object 1428 * @return The text label string in UTF-8 1429 * 1430 * @deprecated use elm_object_text_get() instead. 1431 */ 1432 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj); 1433 1434 /** 1435 * @brief Set the icon object of the check object 1436 * 1437 * @param obj The check object 1438 * @param icon The icon object 1439 * 1440 * Once the icon object is set, a previously set one will be deleted. 1441 * If you want to keep that old content object, use the 1442 * elm_object_content_unset() function. 1443 * 1444 * @deprecated use elm_object_part_content_set() instead. 1445 * 1446 */ 1447 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon); 1448 1449 /** 1450 * @brief Get the icon object of the check object 1451 * 1452 * @param obj The check object 1453 * @return The icon object 1454 * 1455 * @deprecated use elm_object_part_content_get() instead. 1456 * 1457 */ 1458 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj); 1459 1460 /** 1461 * @brief Unset the icon used for the check object 1462 * 1463 * @param obj The check object 1464 * @return The icon object that was being used 1465 * 1466 * Unparent and return the icon object which was set for this widget. 1467 * 1468 * @deprecated use elm_object_part_content_unset() instead. 1469 * 1470 */ 1471 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj); 1472 1473 EINA_DEPRECATED EAPI void elm_check_states_labels_set(Evas_Object *obj, const char *ontext, const char *offtext); 1474 EINA_DEPRECATED EAPI void elm_check_states_labels_get(const Evas_Object *obj, const char **ontext, const char **offtext); 1475 1476 1477 /** 1478 * Set the content of the conformant widget. 1479 * 1480 * @param obj The conformant object. 1481 * @param content The content to be displayed by the conformant. 1482 * 1483 * Content will be sized and positioned considering the space required 1484 * to display a virtual keyboard. So it won't fill all the conformant 1485 * size. This way is possible to be sure that content won't resize 1486 * or be re-positioned after the keyboard is displayed. 1487 * 1488 * Once the content object is set, a previously set one will be deleted. 1489 * If you want to keep that old content object, use the 1490 * elm_object_content_unset() function. 1491 * 1492 * @see elm_object_content_unset() 1493 * @see elm_object_content_get() 1494 * 1495 * @deprecated use elm_object_content_set() instead 1496 * 1497 * @ingroup Elm_Conformant 1498 */ 1499 EINA_DEPRECATED EAPI void elm_conformant_content_set(Evas_Object *obj, Evas_Object *content); 1500 1501 /** 1502 * Get the content of the conformant widget. 1503 * 1504 * @param obj The conformant object. 1505 * @return The content that is being used. 1506 * 1507 * Return the content object which is set for this widget. 1508 * It won't be unparent from conformant. For that, use 1509 * elm_object_content_unset(). 1510 * 1511 * @see elm_object_content_set(). 1512 * @see elm_object_content_unset() 1513 * 1514 * @deprecated use elm_object_content_get() instead 1515 * 1516 * @ingroup Elm_Conformant 1517 */ 1518 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_get(const Evas_Object *obj); 1519 1520 /** 1521 * Unset the content of the conformant widget. 1522 * 1523 * @param obj The conformant object. 1524 * @return The content that was being used. 1525 * 1526 * Unparent and return the content object which was set for this widget. 1527 * 1528 * @see elm_object_content_set(). 1529 * 1530 * @deprecated use elm_object_content_unset() instead 1531 * 1532 * @ingroup Elm_Conformant 1533 */ 1534 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_unset(Evas_Object *obj); 1535 1536 /** 1537 * Get the side labels max length. 1538 * 1539 * @deprecated use elm_diskselector_side_label_length_get() instead: 1540 * 1541 * @param obj The diskselector object. 1542 * @return The max length defined for side labels, or 0 if not a valid 1543 * diskselector. 1544 * 1545 * @ingroup Elm_Diskselector 1546 */ 1547 EINA_DEPRECATED EAPI int elm_diskselector_side_label_lenght_get(const Evas_Object *obj); 1548 1549 /** 1550 * Set the side labels max length. 1551 * 1552 * @deprecated use elm_diskselector_side_label_length_set() instead: 1553 * 1554 * @param obj The diskselector object. 1555 * @param len The max length defined for side labels. 1556 * 1557 * @ingroup Elm_Diskselector 1558 */ 1559 EINA_DEPRECATED EAPI void elm_diskselector_side_label_lenght_set(Evas_Object *obj, int len); 1560 1561 /** 1562 * Get the data associated to the item. 1563 * 1564 * @param it The diskselector item 1565 * @return The data associated to @p it 1566 * 1567 * The return value is a pointer to data associated to @p item when it was 1568 * created, with function elm_diskselector_item_append(). If no data 1569 * was passed as argument, it will return @c NULL. 1570 * 1571 * @see elm_diskselector_item_append() 1572 * @deprecated Use elm_object_item_data_get() 1573 * 1574 * @ingroup Elm_Diskselector 1575 */ 1576 EINA_DEPRECATED EAPI void *elm_diskselector_item_data_get(const Elm_Object_Item *it); 1577 1578 /** 1579 * Set the icon associated to the item. 1580 * 1581 * @param it The diskselector item 1582 * @param icon The icon object to associate with @p it 1583 * 1584 * The icon object to use at left side of the item. An 1585 * icon can be any Evas object, but usually it is an icon created 1586 * with elm_icon_add(). 1587 * 1588 * Once the icon object is set, a previously set one will be deleted. 1589 * @warning Setting the same icon for two items will cause the icon to 1590 * disappear from the first item. 1591 * 1592 * If an icon was passed as argument on item creation, with function 1593 * elm_diskselector_item_append(), it will be already 1594 * associated to the item. 1595 * 1596 * @see elm_diskselector_item_append() 1597 * @see elm_diskselector_item_icon_get() 1598 * 1599 * @deprecated Use elm_object_item_part_content_set() instead 1600 * @ingroup Elm_Diskselector 1601 */ 1602 EINA_DEPRECATED EAPI void elm_diskselector_item_icon_set(Elm_Object_Item *it, Evas_Object *icon); 1603 1604 /** 1605 * Get the icon associated to the item. 1606 * 1607 * @param it The diskselector item 1608 * @return The icon associated to @p it 1609 * 1610 * The return value is a pointer to the icon associated to @p item when it was 1611 * created, with function elm_diskselector_item_append(), or later 1612 * with function elm_diskselector_item_icon_set. If no icon 1613 * was passed as argument, it will return @c NULL. 1614 * 1615 * @see elm_diskselector_item_append() 1616 * @see elm_diskselector_item_icon_set() 1617 * 1618 * @deprecated Use elm_object_item_part_content_set() instead 1619 * @ingroup Elm_Diskselector 1620 */ 1621 EAPI Evas_Object *elm_diskselector_item_icon_get(const Elm_Object_Item *it); 1622 1623 /** 1624 * Set the label of item. 1625 * 1626 * @param it The item of diskselector. 1627 * @param label The label of item. 1628 * 1629 * The label to be displayed by the item. 1630 * 1631 * If no icon is set, label will be centered on item position, otherwise 1632 * the icon will be placed at left of the label, that will be shifted 1633 * to the right. 1634 * 1635 * An item with label "January" would be displayed on side position as 1636 * "Jan" if max length is set to 3 with function 1637 * elm_diskselector_side_label_length_set(), or "Janu", if this property 1638 * is set to 4. 1639 * 1640 * When this @p item is selected, the entire label will be displayed, 1641 * except for width restrictions. 1642 * In this case label will be cropped and "..." will be concatenated, 1643 * but only for display purposes. It will keep the entire string, so 1644 * if diskselector is resized the remaining characters will be displayed. 1645 * 1646 * If a label was passed as argument on item creation, with function 1647 * elm_diskselector_item_append(), it will be already 1648 * displayed by the item. 1649 * 1650 * @see elm_diskselector_side_label_length_set() 1651 * @see elm_diskselector_item_label_get() 1652 * @see elm_diskselector_item_append() 1653 * 1654 * @deprecated Use elm_object_item_text_set() instead 1655 * @ingroup Elm_Diskselector 1656 */ 1657 EINA_DEPRECATED EAPI void elm_diskselector_item_label_set(Elm_Object_Item *it, const char *label); 1658 1659 /** 1660 * Get the label of item. 1661 * 1662 * @param it The item of diskselector. 1663 * @return The label of item. 1664 * 1665 * The return value is a pointer to the label associated to @p item when it was 1666 * created, with function elm_diskselector_item_append(), or later 1667 * with function elm_diskselector_item_label_set. If no label 1668 * was passed as argument, it will return @c NULL. 1669 * 1670 * @see elm_diskselector_item_label_set() for more details. 1671 * @see elm_diskselector_item_append() 1672 * @deprecated Use elm_object_item_text_get() instead 1673 * 1674 * @ingroup Elm_Diskselector 1675 */ 1676 EINA_DEPRECATED EAPI const char *elm_diskselector_item_label_get(const Elm_Object_Item *it); 1677 1678 /** 1679 * Set the function called when a diskselector item is freed. 1680 * 1681 * @param it The item to set the callback on 1682 * @param func The function called 1683 * 1684 * If there is a @p func, then it will be called prior item's memory release. 1685 * That will be called with the following arguments: 1686 * @li item's data; 1687 * @li item's Evas object; 1688 * @li item itself; 1689 * 1690 * This way, a data associated to a diskselector item could be properly 1691 * freed. 1692 * @deprecated Use elm_object_item_del_cb_set() instead 1693 * 1694 * @ingroup Elm_Diskselector 1695 */ 1696 EINA_DEPRECATED EAPI void elm_diskselector_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func); 1697 1698 /** 1699 * Delete them item from the diskselector. 1700 * 1701 * @param it The item of diskselector to be deleted. 1702 * 1703 * If deleting all diskselector items is required, elm_diskselector_clear() 1704 * should be used instead of getting items list and deleting each one. 1705 * 1706 * @deprecated Use elm_object_item_del() instead 1707 * @see elm_diskselector_clear() 1708 * @see elm_diskselector_item_append() 1709 * 1710 * @ingroup Elm_Diskselector 1711 */ 1712 EINA_DEPRECATED EAPI void elm_diskselector_item_del(Elm_Object_Item *it); 1713 1714 /** 1715 * Set the text to be shown in the diskselector item. 1716 * 1717 * @param it Target item 1718 * @param text The text to set in the content 1719 * 1720 * Setup the text as tooltip to object. The item can have only one tooltip, 1721 * so any previous tooltip data is removed. 1722 * 1723 * @deprecated Use elm_object_item_tooltip_text_set() instead 1724 * @see elm_object_tooltip_text_set() for more details. 1725 * 1726 * @ingroup Elm_Diskselector 1727 */ 1728 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_text_set(Elm_Object_Item *it, const char *text); 1729 1730 /** 1731 * Set the content to be shown in the tooltip item. 1732 * 1733 * Setup the tooltip to item. The item can have only one tooltip, 1734 * so any previous tooltip data is removed. @p func(with @p data) will 1735 * be called every time that need show the tooltip and it should 1736 * return a valid Evas_Object. This object is then managed fully by 1737 * tooltip system and is deleted when the tooltip is gone. 1738 * 1739 * @param it the diskselector item being attached a tooltip. 1740 * @param func the function used to create the tooltip contents. 1741 * @param data what to provide to @a func as callback data/context. 1742 * @param del_cb called when data is not needed anymore, either when 1743 * another callback replaces @p func, the tooltip is unset with 1744 * elm_diskselector_item_tooltip_unset() or the owner @a item 1745 * dies. This callback receives as the first parameter the 1746 * given @a data, and @p event_info is the item. 1747 * 1748 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead 1749 * @see elm_object_tooltip_content_cb_set() for more details. 1750 * 1751 * @ingroup Elm_Diskselector 1752 */ 1753 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_content_cb_set(Elm_Object_Item *it, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb); 1754 1755 /** 1756 * Unset tooltip from item. 1757 * 1758 * @param it diskselector item to remove previously set tooltip. 1759 * 1760 * Remove tooltip from item. The callback provided as del_cb to 1761 * elm_diskselector_item_tooltip_content_cb_set() will be called to notify 1762 * it is not used anymore. 1763 * 1764 * @deprecated Use elm_object_item_tooltip_unset() instead 1765 * @see elm_object_tooltip_unset() for more details. 1766 * @see elm_diskselector_item_tooltip_content_cb_set() 1767 * 1768 * @ingroup Elm_Diskselector 1769 */ 1770 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_unset(Elm_Object_Item *it); 1771 1772 /** 1773 * Sets a different style for this item tooltip. 1774 * 1775 * @note before you set a style you should define a tooltip with 1776 * elm_diskselector_item_tooltip_content_cb_set() or 1777 * elm_diskselector_item_tooltip_text_set() 1778 * 1779 * @param it diskselector item with tooltip already set. 1780 * @param style the theme style to use (default, transparent, ...) 1781 * 1782 * @deprecated Use elm_object_item_tooltip_style_set() instead 1783 * @see elm_object_tooltip_style_set() for more details. 1784 * 1785 * @ingroup Elm_Diskselector 1786 */ 1787 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_style_set(Elm_Object_Item *it, const char *style); 1788 1789 /** 1790 * Get the style for this item tooltip. 1791 * 1792 * @param it diskselector item with tooltip already set. 1793 * @return style the theme style in use, defaults to "default". If the 1794 * object does not have a tooltip set, then NULL is returned. 1795 * 1796 * @deprecated Use elm_object_item_tooltip_style_get() instead 1797 * @see elm_object_tooltip_style_get() for more details. 1798 * @see elm_diskselector_item_tooltip_style_set() 1799 * 1800 * @ingroup Elm_Diskselector 1801 */ 1802 EINA_DEPRECATED EAPI const char *elm_diskselector_item_tooltip_style_get(const Elm_Object_Item *it); 1803 1804 /** 1805 * Set the cursor to be shown when mouse is over the diskselector item 1806 * 1807 * @param it Target item 1808 * @param cursor the cursor name to be used. 1809 * 1810 * @see elm_object_cursor_set() for more details. 1811 * @deprecated Use elm_object_item_cursor_set() instead 1812 * 1813 * @ingroup Elm_Diskselector 1814 */ 1815 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_set(Elm_Object_Item *it, const char *cursor); 1816 1817 /** 1818 * Get the cursor to be shown when mouse is over the diskselector item 1819 * 1820 * @param it diskselector item with cursor already set. 1821 * @return the cursor name. 1822 * 1823 * @see elm_object_cursor_get() for more details. 1824 * @see elm_diskselector_item_cursor_set() 1825 * @deprecated Use elm_object_item_cursor_get() instead 1826 * 1827 * @ingroup Elm_Diskselector 1828 */ 1829 EINA_DEPRECATED EAPI const char *elm_diskselector_item_cursor_get(const Elm_Object_Item *it); 1830 1831 /** 1832 * Unset the cursor to be shown when mouse is over the diskselector item 1833 * 1834 * @param it Target item 1835 * 1836 * @see elm_object_cursor_unset() for more details. 1837 * @see elm_diskselector_item_cursor_set() 1838 * @deprecated use elm_object_item_cursor_unset() instead 1839 * 1840 * @ingroup Elm_Diskselector 1841 */ 1842 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_unset(Elm_Object_Item *it); 1843 1844 /** 1845 * Sets a different style for this item cursor. 1846 * 1847 * @note before you set a style you should define a cursor with 1848 * elm_diskselector_item_cursor_set() 1849 * 1850 * @param it diskselector item with cursor already set. 1851 * @param style the theme style to use (default, transparent, ...) 1852 * 1853 * @see elm_object_cursor_style_set() for more details. 1854 * @deprecated Use elm_object_item_cursor_style_set() instead 1855 * 1856 * @ingroup Elm_Diskselector 1857 */ 1858 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_style_set(Elm_Object_Item *it, const char *style); 1859 1860 /** 1861 * Get the style for this item cursor. 1862 * 1863 * @param it diskselector item with cursor already set. 1864 * @return style the theme style in use, defaults to "default". If the 1865 * object does not have a cursor set, then @c NULL is returned. 1866 * 1867 * @see elm_object_cursor_style_get() for more details. 1868 * @see elm_diskselector_item_cursor_style_set() 1869 * @deprecated Use elm_object_item_cursor_style_get() instead 1870 * 1871 * @ingroup Elm_Diskselector 1872 */ 1873 EINA_DEPRECATED EAPI const char *elm_diskselector_item_cursor_style_get(const Elm_Object_Item *it); 1874 1875 /** 1876 * Set if the cursor set should be searched on the theme or should use 1877 * the provided by the engine, only. 1878 * 1879 * @note before you set if should look on theme you should define a cursor 1880 * with elm_diskselector_item_cursor_set(). 1881 * By default it will only look for cursors provided by the engine. 1882 * 1883 * @param it widget item with cursor already set. 1884 * @param engine_only boolean to define if cursors set with 1885 * elm_diskselector_item_cursor_set() should be searched only 1886 * between cursors provided by the engine or searched on widget's 1887 * theme as well. 1888 * 1889 * @deprecated Use elm_object_item_cursor_engine_only_set() instead 1890 * 1891 * @ingroup Elm_Diskselector 1892 */ 1893 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only); 1894 1895 /** 1896 * Get the cursor engine only usage for this item cursor. 1897 * 1898 * @param it widget item with cursor already set. 1899 * @return engine_only boolean to define it cursors should be looked only 1900 * between the provided by the engine or searched on widget's theme as well. 1901 * If the item does not have a cursor set, then @c EINA_FALSE is returned. 1902 * 1903 * @see elm_diskselector_item_cursor_engine_only_set() 1904 * @deprecated Use elm_object_item_cursor_engine_only_get() instead 1905 * 1906 * @ingroup Elm_Diskselector 1907 */ 1908 EINA_DEPRECATED EAPI Eina_Bool elm_diskselector_item_cursor_engine_only_get(const Elm_Object_Item *it); 1909 1910 EINA_DEPRECATED EAPI void elm_factory_content_set(Evas_Object *obj, Evas_Object *content); 1911 EINA_DEPRECATED EAPI Evas_Object *elm_factory_content_get(const Evas_Object *obj); 1912 1913 /** 1914 * Get the label of a given flip selector widget's item. 1915 * 1916 * @param it The item to get label from 1917 * @return The text label of @p item or @c NULL, on errors 1918 * 1919 * @see elm_object_item_text_set() 1920 * 1921 * @deprecated see elm_object_item_text_get() instead 1922 * @ingroup Elm_Flipselector 1923 */ 1924 EINA_DEPRECATED EAPI const char *elm_flipselector_item_label_get(const Elm_Object_Item *it); 1925 1926 /** 1927 * Set the label of a given flip selector widget's item. 1928 * 1929 * @param it The item to set label on 1930 * @param label The text label string, in UTF-8 encoding 1931 * 1932 * @see elm_object_item_text_get() 1933 * 1934 * @deprecated see elm_object_item_text_set() instead 1935 * @ingroup Elm_Flipselector 1936 */ 1937 EINA_DEPRECATED EAPI void elm_flipselector_item_label_set(Elm_Object_Item *it, const char *label); 1938 1939 /** 1940 * Delete a given item from a flip selector widget. 1941 * 1942 * @param it The item to delete 1943 * 1944 * @deprecated Use elm_object_item_del() instead 1945 * @ingroup Elm_Flipselector 1946 */ 1947 EINA_DEPRECATED EAPI void elm_flipselector_item_del(Elm_Object_Item *it); 1948 1949 /** 1950 * Set the interval on time updates for a user mouse button hold 1951 * on a flip selector widget. 1952 * 1953 * @param obj The flip selector object 1954 * @param interval The (first) interval value in seconds 1955 * 1956 * This interval value is @b decreased while the user holds the 1957 * mouse pointer either flipping up or flipping down a given flip 1958 * selector. 1959 * 1960 * This helps the user to get to a given item distant from the 1961 * current one easier/faster, as it will start to flip quicker and 1962 * quicker on mouse button holds. 1963 * 1964 * The calculation for the next flip interval value, starting from 1965 * the one set with this call, is the previous interval divided by 1966 * 1.05, so it decreases a little bit. 1967 * 1968 * The default starting interval value for automatic flips is 1969 * @b 0.85 seconds. 1970 * 1971 * @see elm_flipselector_interval_get() 1972 * @deprecated Use elm_flipselector_first_interval_set() 1973 * 1974 * @ingroup Elm_Flipselector 1975 */ 1976 EINA_DEPRECATED EAPI void elm_flipselector_interval_set(Evas_Object *obj, double interval); 1977 1978 /** 1979 * Get the interval on time updates for a user mouse button hold 1980 * on a flip selector widget. 1981 * 1982 * @param obj The flip selector object 1983 * @return The (first) interval value, in seconds, set on it 1984 * 1985 * @see elm_flipselector_interval_set() for more details 1986 * @deprecated Use elm_flipselector_first_interval_get() 1987 * 1988 * @ingroup Elm_Flipselector 1989 */ 1990 EINA_DEPRECATED EAPI double elm_flipselector_interval_get(const Evas_Object *obj); 1991 1992 /** 1993 * Make a given Elementary object the focused one. 1994 * 1995 * @param obj The Elementary object to make focused. 1996 * 1997 * @note This object, if it can handle focus, will take the focus 1998 * away from the one who had it previously and will, for now on, be 1999 * the one receiving input events. 2000 * 2001 * @see elm_object_focus_get() 2002 * @deprecated use elm_object_focus_set() instead. 2003 * 2004 * @ingroup Elm_Focus 2005 */ 2006 EINA_DEPRECATED EAPI void elm_object_focus(Evas_Object *obj); 2007 2008 /** 2009 * Give focus to next object in object tree. 2010 * 2011 * Give focus to next object in focus chain of one object sub-tree. 2012 * If the last object of chain already have focus, the focus will go to the 2013 * first object of chain. 2014 * 2015 * @param obj The object root of sub-tree 2016 * @param dir Direction to cycle the focus 2017 * 2018 * @deprecated Use elm_object_focus_next() instead 2019 * 2020 * @ingroup Elm_Focus 2021 */ 2022 EINA_DEPRECATED EAPI void elm_object_focus_cycle(Evas_Object *obj, Elm_Focus_Direction dir); 2023 2024 /** 2025 * Remove the focus from an Elementary object 2026 * 2027 * @param obj The Elementary to take focus from 2028 * 2029 * This removes the focus from @p obj, passing it back to the 2030 * previous element in the focus chain list. 2031 * 2032 * @see elm_object_focus() and elm_object_focus_custom_chain_get() 2033 * @deprecated use elm_object_focus_set() instead. 2034 * 2035 * @ingroup Elm_Focus 2036 */ 2037 EINA_DEPRECATED EAPI void elm_object_unfocus(Evas_Object *obj); 2038 2039 /** 2040 * Give focus to near object in one direction. 2041 * 2042 * Give focus to near object in direction of one object. 2043 * If none focusable object in given direction, the focus will not change. 2044 * 2045 * @param obj The reference object 2046 * @param x Horizontal component of direction to focus 2047 * @param y Vertical component of direction to focus 2048 * 2049 * @deprecated Support it later. 2050 * @ingroup Elm_Focus 2051 */ 2052 EINA_DEPRECATED EAPI void elm_object_focus_direction_go(Evas_Object *obj, int x, int y); 2053 2054 /** 2055 * @brief Set the frame label 2056 * 2057 * @param obj The frame object 2058 * @param label The label of this frame object 2059 * 2060 * @deprecated use elm_object_text_set() instead. 2061 */ 2062 EINA_DEPRECATED EAPI void elm_frame_label_set(Evas_Object *obj, const char *label); 2063 2064 /** 2065 * @brief Get the frame label 2066 * 2067 * @param obj The frame object 2068 * 2069 * @return The label of this frame object or NULL if unable to get frame 2070 * 2071 * @deprecated use elm_object_text_get() instead. 2072 */ 2073 EINA_DEPRECATED EAPI const char *elm_frame_label_get(const Evas_Object *obj); 2074 2075 /** 2076 * @brief Set the content of the frame widget 2077 * 2078 * Once the content object is set, a previously set one will be deleted. 2079 * If you want to keep that old content object, use the 2080 * elm_frame_content_unset() function. 2081 * 2082 * @param obj The frame object 2083 * @param content The content will be filled in this frame object 2084 * 2085 * @deprecated use elm_object_content_set() instead. 2086 */ 2087 EINA_DEPRECATED EAPI void elm_frame_content_set(Evas_Object *obj, Evas_Object *content); 2088 2089 /** 2090 * @brief Get the content of the frame widget 2091 * 2092 * Return the content object which is set for this widget 2093 * 2094 * @param obj The frame object 2095 * @return The content that is being used 2096 * 2097 * @deprecated use elm_object_content_get() instead. 2098 */ 2099 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_get(const Evas_Object *obj); 2100 2101 /** 2102 * @brief Unset the content of the frame widget 2103 * 2104 * Unparent and return the content object which was set for this widget 2105 * 2106 * @param obj The frame object 2107 * @return The content that was being used 2108 * 2109 * @deprecated use elm_object_content_unset() instead. 2110 */ 2111 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_unset(Evas_Object *obj); 2112 2113 EINA_DEPRECATED EAPI void elm_genlist_horizontal_mode_set(Evas_Object *obj, Elm_List_Mode mode); 2114 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_mode_get(const Evas_Object *obj); 2115 EINA_DEPRECATED EAPI void elm_genlist_item_icons_orphan(Elm_Object_Item *it); 2116 /** 2117 * This sets the horizontal stretching mode. 2118 * 2119 * @param obj The genlist object 2120 * @param mode The mode to use (one of #ELM_LIST_SCROLL or #ELM_LIST_LIMIT). 2121 * 2122 * This sets the mode used for sizing items horizontally. Valid modes 2123 * are #ELM_LIST_LIMIT and #ELM_LIST_SCROLL. The default is 2124 * ELM_LIST_SCROLL. This mode means that if items are too wide to fit, 2125 * the scroller will scroll horizontally. Otherwise items are expanded 2126 * to fill the width of the viewport of the scroller. If it is 2127 * ELM_LIST_LIMIT, items will be expanded to the viewport width and 2128 * limited to that size. 2129 * 2130 * @see elm_genlist_horizontal_get() 2131 * 2132 * @deprecated use elm_genlist_mode_set() 2133 * @ingroup Elm_Genlist 2134 */ 2135 EINA_DEPRECATED EAPI void elm_genlist_horizontal_set(Evas_Object *obj, Elm_List_Mode mode); 2136 2137 /** 2138 * Get the horizontal stretching mode. 2139 * 2140 * @param obj The genlist object 2141 * @return The mode to use 2142 * (#ELM_LIST_LIMIT, #ELM_LIST_SCROLL) 2143 * 2144 * @see elm_genlist_horizontal_set() 2145 * 2146 * @deprecated use elm_genlist_mode_get() 2147 * @ingroup Elm_Genlist 2148 */ 2149 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_get(const Evas_Object *obj); 2150 2151 /** 2152 * Return the data associated to a given genlist item 2153 * 2154 * @param it The genlist item. 2155 * @return the data associated to this item. 2156 * 2157 * This returns the @c data value passed on the 2158 * elm_genlist_item_append() and related item addition calls. 2159 * 2160 * @see elm_genlist_item_append() 2161 * @see elm_genlist_item_data_set() 2162 * 2163 * @deprecated Use elm_object_item_data_get() instead 2164 * @ingroup Elm_Genlist 2165 */ 2166 EINA_DEPRECATED EAPI void *elm_genlist_item_data_get(const Elm_Object_Item *it); 2167 2168 /** 2169 * Set the data associated to a given genlist item 2170 * 2171 * @param it The genlist item 2172 * @param data The new data pointer to set on it 2173 * 2174 * This @b overrides the @c data value passed on the 2175 * elm_genlist_item_append() and related item addition calls. This 2176 * function @b won't call elm_genlist_item_update() automatically, 2177 * so you'd issue it afterwards if you want to hove the item 2178 * updated to reflect the that new data. 2179 * 2180 * @see elm_genlist_item_data_get() 2181 * 2182 * @deprecated Use elm_object_item_data_set() instead 2183 * @ingroup Elm_Genlist 2184 */ 2185 EINA_DEPRECATED EAPI void elm_genlist_item_data_set(Elm_Object_Item *it, const void *data); 2186 2187 /** 2188 * Set whether a given genlist item is disabled or not. 2189 * 2190 * @param it The item 2191 * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE 2192 * to enable it back. 2193 * 2194 * A disabled item cannot be selected or unselected. It will also 2195 * change its appearance, to signal the user it's disabled. 2196 * 2197 * @see elm_genlist_item_disabled_get() 2198 * @deprecated Use elm_object_item_disabled_set() instead 2199 * 2200 * @ingroup Elm_Genlist 2201 */ 2202 EINA_DEPRECATED EAPI void elm_genlist_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled); 2203 2204 /** 2205 * Get whether a given genlist item is disabled or not. 2206 * 2207 * @param it The item 2208 * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise 2209 * (and on errors). 2210 * 2211 * @see elm_genlist_item_disabled_set() for more details 2212 * @deprecated Use elm_object_item_disabled_get() instead 2213 * 2214 * @ingroup Elm_Genlist 2215 */ 2216 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_item_disabled_get(const Elm_Object_Item *it); 2217 2218 /** 2219 * Remove a genlist item from the its parent, deleting it. 2220 * 2221 * @param it The item to be removed. 2222 * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise. 2223 * 2224 * @see elm_genlist_clear(), to remove all items in a genlist at 2225 * once. 2226 * 2227 * @deprecated Use elm_object_item_del() instead 2228 * @ingroup Elm_Genlist 2229 */ 2230 EINA_DEPRECATED EAPI void elm_genlist_item_del(Elm_Object_Item *it); 2231 2232 /** 2233 * Get the genlist object's handle which contains a given genlist 2234 * item 2235 * 2236 * @param it The item to fetch the container from 2237 * @return The genlist (parent) object 2238 * 2239 * This returns the genlist object itself that an item belongs to. 2240 * @deprecated Use elm_object_item_widget_get() instead 2241 * 2242 * @ingroup Elm_Genlist 2243 */ 2244 EINA_DEPRECATED EAPI Evas_Object *elm_genlist_item_genlist_get(const Elm_Object_Item *it); 2245 2246 /** 2247 * Get the mode item style of items in the genlist 2248 * @param obj The genlist object 2249 * @return The mode item style string, or NULL if none is specified 2250 * 2251 * This is a constant string and simply defines the name of the 2252 * style that will be used for mode animations. It can be 2253 * @c NULL if you don't plan to use Genlist mode. See 2254 * elm_genlist_item_mode_set() for more info. 2255 * 2256 * @ingroup Elm_Genlist 2257 */ 2258 EINA_DEPRECATED EAPI const char *elm_genlist_mode_item_style_get(const Evas_Object *obj); 2259 2260 /** 2261 * Set the mode item style of items in the genlist 2262 * @param obj The genlist object 2263 * @param style The mode item style string, or NULL if none is desired 2264 * 2265 * This is a constant string and simply defines the name of the 2266 * style that will be used for mode animations. It can be 2267 * @c NULL if you don't plan to use Genlist mode. See 2268 * elm_genlist_item_mode_set() for more info. 2269 * 2270 * @ingroup Elm_Genlist 2271 */ 2272 EINA_DEPRECATED EAPI void elm_genlist_mode_item_style_set(Evas_Object *obj, const char *style); 2273 2274 /** 2275 * Get the Item's Flags 2276 * 2277 * @param it The genlist item 2278 * @return The item type. 2279 * 2280 * This function returns the item's type. Normally the item's type. 2281 * If it failed, return value is ELM_GENLIST_ITEM_MAX 2282 * 2283 * @deprecated Use elm_genlist_item_type_get() instead 2284 * @ingroup Elm_Genlist 2285 */ 2286 EINA_DEPRECATED EAPI Elm_Genlist_Item_Type elm_genlist_item_flags_get(const Elm_Object_Item *it); 2287 2288 /** 2289 * Tells genlist to "orphan" contents fetched by the item class 2290 * 2291 * @param it The item 2292 * 2293 * This instructs genlist to release references to contents in the item, 2294 * meaning that they will no longer be managed by genlist and are 2295 * floating "orphans" that can be re-used elsewhere if the user wants 2296 * to. 2297 * 2298 * @deprecated Use elm_genlist_item_all_contents_unset() instead 2299 */ 2300 EINA_DEPRECATED EAPI void elm_genlist_item_contents_orphan(Elm_Object_Item *it); 2301 2302 #define ELM_IMAGE_ROTATE_90_CW 1 2303 #define ELM_IMAGE_ROTATE_180_CW 2 2304 #define ELM_IMAGE_ROTATE_90_CCW 3 2305 2306 /** 2307 * Return the data associated with a given index widget item 2308 * 2309 * @param item The index widget item handle 2310 * @return The data associated with @p it 2311 * @deprecated Use elm_object_item_data_get() instead 2312 * 2313 * @see elm_index_item_data_set() 2314 * 2315 */ 2316 EINA_DEPRECATED EAPI void *elm_index_item_data_get(const Elm_Object_Item *item); 2317 2318 /** 2319 * Set the data associated with a given index widget item 2320 * 2321 * @param it The index widget item handle 2322 * @param data The new data pointer to set to @p it 2323 * 2324 * This sets new item data on @p it. 2325 * 2326 * @warning The old data pointer won't be touched by this function, so 2327 * the user had better to free that old data himself/herself. 2328 * 2329 * @deprecated Use elm_object_item_data_set() instead 2330 */ 2331 EINA_DEPRECATED EAPI void elm_index_item_data_set(Elm_Object_Item *it, const void *data); 2332 2333 /** 2334 * Set the function to be called when a given index widget item is freed. 2335 * 2336 * @param it The item to set the callback on 2337 * @param func The function to call on the item's deletion 2338 * 2339 * When called, @p func will have both @c data and @p event_info 2340 * arguments with the @p it item's data value and, naturally, the 2341 * @c obj argument with a handle to the parent index widget. 2342 * 2343 * @deprecated Use elm_object_item_del_cb_set() instead 2344 */ 2345 EINA_DEPRECATED EAPI void elm_index_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func); 2346 2347 /** 2348 * Remove an item from a given index widget, <b>to be referenced by 2349 * it's data value</b>. 2350 * 2351 * @param obj The index object 2352 * @param item The item to be removed from @p obj 2353 * 2354 * If a deletion callback is set, via elm_object_item_del_cb_set(), 2355 * that callback function will be called by this one. 2356 * 2357 * @deprecated Use elm_object_item_del() instead 2358 */ 2359 EINA_DEPRECATED EAPI void elm_index_item_del(Evas_Object *obj, Elm_Object_Item *item); 2360 2361 /** 2362 * @brief Set the label on the label object 2363 * 2364 * @param obj The label object 2365 * @param label The label will be used on the label object 2366 * @deprecated See elm_object_text_set() 2367 */ 2368 EINA_DEPRECATED EAPI void elm_label_label_set(Evas_Object *obj, const char *label); 2369 2370 /** 2371 * @brief Get the label used on the label object 2372 * 2373 * @param obj The label object 2374 * @return The string inside the label 2375 * @deprecated See elm_object_text_get() 2376 */ 2377 EINA_DEPRECATED EAPI const char *elm_label_label_get(const Evas_Object *obj); 2378 2379 /** 2380 * @def elm_layout_label_set 2381 * Convenience macro to set the label in a layout that follows the 2382 * Elementary naming convention for its parts. 2383 * 2384 * @deprecated use elm_object_text_set() instead. 2385 */ 2386 #define elm_layout_label_set(_ly, _txt) \ 2387 elm_layout_text_set((_ly), "elm.text", (_txt)) 2388 2389 /** 2390 * @def elm_layout_label_get 2391 * Convenience macro to get the label in a layout that follows the 2392 * Elementary naming convention for its parts. 2393 * 2394 * @deprecated use elm_object_text_set() instead. 2395 */ 2396 #define elm_layout_label_get(_ly) \ 2397 elm_layout_text_get((_ly), "elm.text") 2398 2399 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_base_get(const Elm_Object_Item *it); 2400 2401 2402 /** 2403 * Set the content of the mapbuf. 2404 * 2405 * @param obj The mapbuf object. 2406 * @param content The content that will be filled in this mapbuf object. 2407 * 2408 * Once the content object is set, a previously set one will be deleted. 2409 * If you want to keep that old content object, use the 2410 * elm_mapbuf_content_unset() function. 2411 * 2412 * To enable map, elm_mapbuf_enabled_set() should be used. 2413 * 2414 * @deprecated use elm_object_content_set() instead 2415 * 2416 */ 2417 EINA_DEPRECATED EAPI void elm_mapbuf_content_set(Evas_Object *obj, Evas_Object *content); 2418 2419 /** 2420 * Get the content of the mapbuf. 2421 * 2422 * @param obj The mapbuf object. 2423 * @return The content that is being used. 2424 * 2425 * Return the content object which is set for this widget. 2426 * 2427 * @see elm_mapbuf_content_set() for details. 2428 * 2429 * @deprecated use elm_object_content_get() instead 2430 * 2431 */ 2432 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_get(const Evas_Object *obj); 2433 2434 /** 2435 * Unset the content of the mapbuf. 2436 * 2437 * @param obj The mapbuf object. 2438 * @return The content that was being used. 2439 * 2440 * Unparent and return the content object which was set for this widget. 2441 * 2442 * @see elm_mapbuf_content_set() for details. 2443 * 2444 * @deprecated use elm_object_content_unset() instead 2445 * 2446 */ 2447 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_unset(Evas_Object *obj); 2448 2449 /** 2450 * @brief Set the label of a menu item 2451 * 2452 * @param it The menu item object. 2453 * @param label The label to set for @p item 2454 * 2455 * @warning Don't use this function on items created with 2456 * elm_menu_item_add_object() or elm_menu_item_separator_add(). 2457 * 2458 * @deprecated Use elm_object_item_text_set() instead 2459 */ 2460 EINA_DEPRECATED EAPI void elm_menu_item_label_set(Elm_Object_Item *it, const char *label); 2461 2462 /** 2463 * @brief Get the label of a menu item 2464 * 2465 * @param it The menu item object. 2466 * @return The label of @p item 2467 * @deprecated Use elm_object_item_text_get() instead 2468 */ 2469 EINA_DEPRECATED EAPI const char *elm_menu_item_label_get(const Elm_Object_Item *it); 2470 2471 /** 2472 * @brief Set the content object of a menu item 2473 * 2474 * @param it The menu item object 2475 * @param The content object or NULL 2476 * @return EINA_TRUE on success, else EINA_FALSE 2477 * 2478 * Use this function to change the object swallowed by a menu item, deleting 2479 * any previously swallowed object. 2480 * 2481 * @deprecated Use elm_object_item_content_set() instead 2482 */ 2483 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_object_content_set(Elm_Object_Item *it, Evas_Object *obj); 2484 2485 /** 2486 * @brief Get the content object of a menu item 2487 * 2488 * @param it The menu item object 2489 * @return The content object or NULL 2490 * @note If @p item was added with elm_menu_item_add_object, this 2491 * function will return the object passed, else it will return the 2492 * icon object. 2493 * 2494 * @see elm_menu_item_object_content_set() 2495 * 2496 * @deprecated Use elm_object_item_content_get() instead 2497 */ 2498 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_object_content_get(const Elm_Object_Item *it); 2499 2500 /** 2501 * @brief Set the disabled state of @p item. 2502 * 2503 * @param it The menu item object. 2504 * @param disabled The enabled/disabled state of the item 2505 * @deprecated Use elm_object_item_disabled_set() instead 2506 */ 2507 EINA_DEPRECATED EAPI void elm_menu_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled); 2508 2509 /** 2510 * @brief Get the disabled state of @p item. 2511 * 2512 * @param it The menu item object. 2513 * @return The enabled/disabled state of the item 2514 * 2515 * @see elm_menu_item_disabled_set() 2516 * @deprecated Use elm_object_item_disabled_get() instead 2517 */ 2518 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_disabled_get(const Elm_Object_Item *it); 2519 2520 /** 2521 * @brief Returns the data associated with menu item @p item. 2522 * 2523 * @param it The item 2524 * @return The data associated with @p item or NULL if none was set. 2525 * 2526 * This is the data set with elm_menu_add() or elm_menu_item_data_set(). 2527 * 2528 * @deprecated Use elm_object_item_data_get() instead 2529 */ 2530 EINA_DEPRECATED EAPI void *elm_menu_item_data_get(const Elm_Object_Item *it); 2531 2532 /** 2533 * @brief Set the function called when a menu item is deleted. 2534 * 2535 * @param it The item to set the callback on 2536 * @param func The function called 2537 * 2538 * @see elm_menu_item_add() 2539 * @see elm_menu_item_del() 2540 * @deprecated Use elm_object_item_del_cb_set() instead 2541 */ 2542 EINA_DEPRECATED EAPI void elm_menu_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func); 2543 2544 /** 2545 * @brief Sets the data to be associated with menu item @p item. 2546 * 2547 * @param it The item 2548 * @param data The data to be associated with @p item 2549 * 2550 * @deprecated Use elm_object_item_data_set() instead 2551 */ 2552 EINA_DEPRECATED EAPI void elm_menu_item_data_set(Elm_Object_Item *it, const void *data); 2553 2554 /** 2555 * @brief Deletes an item from the menu. 2556 * 2557 * @param it The item to delete. 2558 * 2559 * @deprecated Use elm_object_item_del() instead 2560 * @see elm_menu_item_add() 2561 */ 2562 EINA_DEPRECATED EAPI void elm_menu_item_del(Elm_Object_Item *it); 2563 2564 /** 2565 * @brief @brief Return a menu item's owner menu 2566 * 2567 * @param it The menu item 2568 * @return The menu object owning @p item, or NULL on failure 2569 * 2570 * Use this function to get the menu object owning an item. 2571 * @deprecated Use elm_object_item_widget_get() instead 2572 */ 2573 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_menu_get(const Elm_Object_Item *it); 2574 2575 /** 2576 * @brief Set the icon of a menu item to the standard icon with name @p icon 2577 * 2578 * @param it The menu item object. 2579 * @param icon The icon object to set for the content of @p item 2580 * 2581 * @deprecated elm_menu_item_icon_name_set() instead 2582 * Once this icon is set, any previously set icon will be deleted. 2583 */ 2584 EINA_DEPRECATED EAPI void elm_menu_item_object_icon_name_set(Elm_Object_Item *it, const char *icon); 2585 2586 /** 2587 * @brief Get the string representation from the icon of a menu item 2588 * 2589 * @param it The menu item object. 2590 * @return The string representation of @p item's icon or NULL 2591 * 2592 * @deprecated elm_menu_item_icon_name_get() instead 2593 * @see elm_menu_item_icon_name_set() 2594 */ 2595 EINA_DEPRECATED EAPI const char *elm_menu_item_object_icon_name_get(const Elm_Object_Item *it); 2596 2597 /** 2598 * @brief Set the content of the notify widget 2599 * 2600 * @param obj The notify object 2601 * @param content The content will be filled in this notify object 2602 * 2603 * Once the content object is set, a previously set one will be deleted. If 2604 * you want to keep that old content object, use the 2605 * elm_notify_content_unset() function. 2606 * 2607 * @deprecated use elm_object_content_set() instead 2608 * 2609 */ 2610 EINA_DEPRECATED EAPI void elm_notify_content_set(Evas_Object *obj, Evas_Object *content); 2611 2612 /** 2613 * @brief Unset the content of the notify widget 2614 * 2615 * @param obj The notify object 2616 * @return The content that was being used 2617 * 2618 * Unparent and return the content object which was set for this widget 2619 * 2620 * @see elm_notify_content_set() 2621 * @deprecated use elm_object_content_unset() instead 2622 * 2623 */ 2624 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_unset(Evas_Object *obj); 2625 2626 /** 2627 * @brief Return the content of the notify widget 2628 * 2629 * @param obj The notify object 2630 * @return The content that is being used 2631 * 2632 * @see elm_notify_content_set() 2633 * @deprecated use elm_object_content_get() instead 2634 * 2635 */ 2636 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_get(const Evas_Object *obj); 2637 2638 /** 2639 * Set a label of an object 2640 * 2641 * @param obj The Elementary object 2642 * @param part The text part name to set (NULL for the default label) 2643 * @param label The new text of the label 2644 * 2645 * @note Elementary objects may have many labels (e.g. Action Slider) 2646 * @deprecated Use elm_object_part_text_set() instead. 2647 */ 2648 EINA_DEPRECATED EAPI void elm_object_text_part_set(Evas_Object *obj, const char *part, const char *label); 2649 2650 /** 2651 * Get a label of an object 2652 * 2653 * @param obj The Elementary object 2654 * @param part The text part name to get (NULL for the default label) 2655 * @return text of the label or NULL for any error 2656 * 2657 * @note Elementary objects may have many labels (e.g. Action Slider) 2658 * @deprecated Use elm_object_part_text_get() instead. 2659 */ 2660 EINA_DEPRECATED EAPI const char *elm_object_text_part_get(const Evas_Object *obj, const char *part); 2661 2662 /** 2663 * Set a content of an object 2664 * 2665 * @param obj The Elementary object 2666 * @param part The content part name to set (NULL for the default content) 2667 * @param content The new content of the object 2668 * 2669 * @note Elementary objects may have many contents 2670 * @deprecated Use elm_object_part_content_set instead. 2671 */ 2672 EINA_DEPRECATED EAPI void elm_object_content_part_set(Evas_Object *obj, const char *part, Evas_Object *content); 2673 2674 /** 2675 * Get a content of an object 2676 * 2677 * @param obj The Elementary object 2678 * @param part The content part name to get (NULL for the default content) 2679 * @return content of the object or NULL for any error 2680 * 2681 * @note Elementary objects may have many contents 2682 * @deprecated Use elm_object_part_content_get instead. 2683 */ 2684 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_get(const Evas_Object *obj, const char *part); 2685 2686 /** 2687 * Unset a content of an object 2688 * 2689 * @param obj The Elementary object 2690 * @param part The content part name to unset (NULL for the default content) 2691 * 2692 * @note Elementary objects may have many contents 2693 * @deprecated Use elm_object_part_content_unset instead. 2694 */ 2695 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_unset(Evas_Object *obj, const char *part); 2696 2697 /** 2698 * Set a content of an object item 2699 * 2700 * @param it The Elementary object item 2701 * @param part The content part name to set (NULL for the default content) 2702 * @param content The new content of the object item 2703 * 2704 * @note Elementary object items may have many contents 2705 * @deprecated Use elm_object_item_part_content_set instead. 2706 */ 2707 EINA_DEPRECATED EAPI void elm_object_item_content_part_set(Elm_Object_Item *it, const char *part, Evas_Object *content); 2708 2709 /** 2710 * Get a content of an object item 2711 * 2712 * @param it The Elementary object item 2713 * @param part The content part name to unset (NULL for the default content) 2714 * @return content of the object item or NULL for any error 2715 * 2716 * @note Elementary object items may have many contents 2717 * @deprecated Use elm_object_item_part_content_get instead. 2718 */ 2719 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part); 2720 2721 /** 2722 * Unset a content of an object item 2723 * 2724 * @param it The Elementary object item 2725 * @param part The content part name to unset (NULL for the default content) 2726 * 2727 * @note Elementary object items may have many contents 2728 * @deprecated Use elm_object_item_part_content_unset instead. 2729 */ 2730 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_unset(Elm_Object_Item *it, const char *part); 2731 2732 /** 2733 * Get a label of an object item 2734 * 2735 * @param it The Elementary object item 2736 * @param part The text part name to get (NULL for the default label) 2737 * @return text of the label or NULL for any error 2738 * 2739 * @note Elementary object items may have many labels 2740 * @deprecated Use elm_object_item_part_text_get instead. 2741 */ 2742 EINA_DEPRECATED EAPI const char *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part); 2743 2744 /** 2745 * Set a label of an object item 2746 * 2747 * @param it The Elementary object item 2748 * @param part The text part name to set (NULL for the default label) 2749 * @param label The new text of the label 2750 * 2751 * @note Elementary object items may have many labels 2752 * @deprecated Use elm_object_item_part_text_set instead. 2753 */ 2754 EINA_DEPRECATED EAPI void elm_object_item_text_part_set(Elm_Object_Item *it, const char *part, const char *label); 2755 2756 /** 2757 * @brief Set the content of the panel. 2758 * 2759 * @param obj The panel object 2760 * @param content The panel content 2761 * 2762 * Once the content object is set, a previously set one will be deleted. 2763 * If you want to keep that old content object, use the 2764 * elm_panel_content_unset() function. 2765 * 2766 * @deprecated use elm_object_content_set() instead 2767 * 2768 */ 2769 EINA_DEPRECATED EAPI void elm_panel_content_set(Evas_Object *obj, Evas_Object *content); 2770 2771 /** 2772 * @brief Get the content of the panel. 2773 * 2774 * @param obj The panel object 2775 * @return The content that is being used 2776 * 2777 * Return the content object which is set for this widget. 2778 * 2779 * @see elm_panel_content_set() 2780 * 2781 * @deprecated use elm_object_content_get() instead 2782 * 2783 */ 2784 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_get(const Evas_Object *obj); 2785 2786 /** 2787 * @brief Unset the content of the panel. 2788 * 2789 * @param obj The panel object 2790 * @return The content that was being used 2791 * 2792 * Unparent and return the content object which was set for this widget. 2793 * 2794 * @see elm_panel_content_set() 2795 * 2796 * @deprecated use elm_object_content_unset() instead 2797 * 2798 */ 2799 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_unset(Evas_Object *obj); 2800 2801 /** 2802 * Set the left content of the panes widget. 2803 * 2804 * @param obj The panes object. 2805 * @param content The new left content object. 2806 * 2807 * Once the content object is set, a previously set one will be deleted. 2808 * If you want to keep that old content object, use the 2809 * elm_panes_content_left_unset() function. 2810 * 2811 * If panes is displayed vertically, left content will be displayed at 2812 * top. 2813 * 2814 * @see elm_panes_content_left_get() 2815 * @see elm_panes_content_right_set() to set content on the other side. 2816 * 2817 * @deprecated use elm_object_part_content_set() instead 2818 * 2819 */ 2820 EINA_DEPRECATED EAPI void elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content); 2821 2822 /** 2823 * Set the right content of the panes widget. 2824 * 2825 * @param obj The panes object. 2826 * @param content The new right content object. 2827 * 2828 * Once the content object is set, a previously set one will be deleted. 2829 * If you want to keep that old content object, use the 2830 * elm_panes_content_right_unset() function. 2831 * 2832 * If panes is displayed vertically, left content will be displayed at 2833 * bottom. 2834 * 2835 * @see elm_panes_content_right_get() 2836 * @see elm_panes_content_left_set() to set content on the other side. 2837 * 2838 * @deprecated use elm_object_part_content_set() instead 2839 * 2840 */ 2841 EINA_DEPRECATED EAPI void elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content); 2842 2843 /** 2844 * Get the left content of the panes. 2845 * 2846 * @param obj The panes object. 2847 * @return The left content object that is being used. 2848 * 2849 * Return the left content object which is set for this widget. 2850 * 2851 * @see elm_panes_content_left_set() for details. 2852 * 2853 * @deprecated use elm_object_part_content_get() instead 2854 * 2855 */ 2856 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_get(const Evas_Object *obj); 2857 2858 /** 2859 * Get the right content of the panes. 2860 * 2861 * @param obj The panes object 2862 * @return The right content object that is being used 2863 * 2864 * Return the right content object which is set for this widget. 2865 * 2866 * @see elm_panes_content_right_set() for details. 2867 * 2868 * @deprecated use elm_object_part_content_get() instead 2869 * 2870 */ 2871 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_get(const Evas_Object *obj); 2872 2873 /** 2874 * Unset the left content used for the panes. 2875 * 2876 * @param obj The panes object. 2877 * @return The left content object that was being used. 2878 * 2879 * Unparent and return the left content object which was set for this widget. 2880 * 2881 * @see elm_panes_content_left_set() for details. 2882 * @see elm_panes_content_left_get(). 2883 * 2884 * @deprecated use elm_object_part_content_unset() instead 2885 * 2886 */ 2887 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_unset(Evas_Object *obj); 2888 2889 /** 2890 * Unset the right content used for the panes. 2891 * 2892 * @param obj The panes object. 2893 * @return The right content object that was being used. 2894 * 2895 * Unparent and return the right content object which was set for this 2896 * widget. 2897 * 2898 * @see elm_panes_content_right_set() for details. 2899 * @see elm_panes_content_right_get(). 2900 * 2901 * @deprecated use elm_object_part_content_unset() instead 2902 * 2903 */ 2904 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_unset(Evas_Object *obj); 2905 /** 2906 * Set the label of a given progress bar widget 2907 * 2908 * @param obj The progress bar object 2909 * @param label The text label string, in UTF-8 2910 * 2911 * @deprecated use elm_object_text_set() instead. 2912 */ 2913 EINA_DEPRECATED EAPI void elm_progressbar_label_set(Evas_Object *obj, const char *label); 2914 2915 /** 2916 * Get the label of a given progress bar widget 2917 * 2918 * @param obj The progressbar object 2919 * @return The text label string, in UTF-8 2920 * 2921 * @deprecated use elm_object_text_set() instead. 2922 */ 2923 EINA_DEPRECATED EAPI const char *elm_progressbar_label_get(const Evas_Object *obj); 2924 2925 /** 2926 * Set the icon object of a given progress bar widget 2927 * 2928 * @param obj The progress bar object 2929 * @param icon The icon object 2930 * 2931 * Use this call to decorate @p obj with an icon next to it. 2932 * 2933 * @note Once the icon object is set, a previously set one will be 2934 * deleted. If you want to keep that old content object, use the 2935 * elm_progressbar_icon_unset() function. 2936 * 2937 * @see elm_progressbar_icon_get() 2938 * @deprecated use elm_object_part_content_set() instead. 2939 * 2940 */ 2941 EINA_DEPRECATED EAPI void elm_progressbar_icon_set(Evas_Object *obj, Evas_Object *icon); 2942 2943 /** 2944 * Get the icon object set for a given progress bar widget 2945 * 2946 * @param obj The progress bar object 2947 * @return The icon object's handle, if @p obj had one set, or @c NULL, 2948 * otherwise (and on errors) 2949 * 2950 * @see elm_progressbar_icon_set() for more details 2951 * @deprecated use elm_object_part_content_get() instead. 2952 * 2953 */ 2954 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_get(const Evas_Object *obj); 2955 2956 /** 2957 * Unset an icon set on a given progress bar widget 2958 * 2959 * @param obj The progress bar object 2960 * @return The icon object that was being used, if any was set, or 2961 * @c NULL, otherwise (and on errors) 2962 * 2963 * This call will unparent and return the icon object which was set 2964 * for this widget, previously, on success. 2965 * 2966 * @see elm_progressbar_icon_set() for more details 2967 * @deprecated use elm_object_part_content_unset() instead. 2968 * 2969 */ 2970 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_unset(Evas_Object *obj); 2971 2972 /** 2973 * @brief Set the text label of the radio object 2974 * 2975 * @param obj The radio object 2976 * @param label The text label string in UTF-8 2977 * 2978 * @deprecated use elm_object_text_set() instead. 2979 */ 2980 EINA_DEPRECATED EAPI void elm_radio_label_set(Evas_Object *obj, const char *label); 2981 2982 /** 2983 * @brief Get the text label of the radio object 2984 * 2985 * @param obj The radio object 2986 * @return The text label string in UTF-8 2987 * 2988 * @deprecated use elm_object_text_set() instead. 2989 */ 2990 EINA_DEPRECATED EAPI const char *elm_radio_label_get(const Evas_Object *obj); 2991 2992 /** 2993 * @brief Set the icon object of the radio object 2994 * 2995 * @param obj The radio object 2996 * @param icon The icon object 2997 * 2998 * Once the icon object is set, a previously set one will be deleted. If you 2999 * want to keep that old content object, use the elm_radio_icon_unset() 3000 * function. 3001 * 3002 * @deprecated use elm_object_part_content_set() instead. 3003 * 3004 */ 3005 EINA_DEPRECATED EAPI void elm_radio_icon_set(Evas_Object *obj, Evas_Object *icon); 3006 3007 /** 3008 * @brief Get the icon object of the radio object 3009 * 3010 * @param obj The radio object 3011 * @return The icon object 3012 * 3013 * @see elm_radio_icon_set() 3014 * 3015 * @deprecated use elm_object_part_content_get() instead. 3016 * 3017 */ 3018 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_get(const Evas_Object *obj); 3019 3020 /** 3021 * @brief Unset the icon used for the radio object 3022 * 3023 * @param obj The radio object 3024 * @return The icon object that was being used 3025 * 3026 * Unparent and return the icon object which was set for this widget. 3027 * 3028 * @see elm_radio_icon_set() 3029 * @deprecated use elm_object_part_content_unset() instead. 3030 * 3031 */ 3032 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_unset(Evas_Object *obj); 3033 3034 /** 3035 * Set the label of a given slider widget 3036 * 3037 * @param obj The progress bar object 3038 * @param label The text label string, in UTF-8 3039 * 3040 * @deprecated use elm_object_text_set() instead. 3041 */ 3042 EINA_DEPRECATED EAPI void elm_slider_label_set(Evas_Object *obj, const char *label); 3043 3044 /** 3045 * Get the label of a given slider widget 3046 * 3047 * @param obj The progressbar object 3048 * @return The text label string, in UTF-8 3049 * 3050 * @deprecated use elm_object_text_get() instead. 3051 */ 3052 EINA_DEPRECATED EAPI const char *elm_slider_label_get(const Evas_Object *obj); 3053 3054 /** 3055 * Set the icon object of the slider object. 3056 * 3057 * @param obj The slider object. 3058 * @param icon The icon object. 3059 * 3060 * On horizontal mode, icon is placed at left, and on vertical mode, 3061 * placed at top. 3062 * 3063 * @note Once the icon object is set, a previously set one will be deleted. 3064 * If you want to keep that old content object, use the 3065 * elm_slider_icon_unset() function. 3066 * 3067 * @warning If the object being set does not have minimum size hints set, 3068 * it won't get properly displayed. 3069 * 3070 * @deprecated use elm_object_part_content_set() instead. 3071 */ 3072 EINA_DEPRECATED EAPI void elm_slider_icon_set(Evas_Object *obj, Evas_Object *icon); 3073 3074 /** 3075 * Unset an icon set on a given slider widget. 3076 * 3077 * @param obj The slider object. 3078 * @return The icon object that was being used, if any was set, or 3079 * @c NULL, otherwise (and on errors). 3080 * 3081 * On horizontal mode, icon is placed at left, and on vertical mode, 3082 * placed at top. 3083 * 3084 * This call will unparent and return the icon object which was set 3085 * for this widget, previously, on success. 3086 * 3087 * @see elm_slider_icon_set() for more details 3088 * @see elm_slider_icon_get() 3089 * @deprecated use elm_object_part_content_unset() instead. 3090 * 3091 */ 3092 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_unset(Evas_Object *obj); 3093 3094 /** 3095 * Get the icon object set for a given slider widget. 3096 * 3097 * @param obj The slider object. 3098 * @return The icon object's handle, if @p obj had one set, or @c NULL, 3099 * otherwise (and on errors). 3100 * 3101 * On horizontal mode, icon is placed at left, and on vertical mode, 3102 * placed at top. 3103 * 3104 * @see elm_slider_icon_set() for more details 3105 * @see elm_slider_icon_unset() 3106 * 3107 * @deprecated use elm_object_part_content_get() instead. 3108 * 3109 */ 3110 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_get(const Evas_Object *obj); 3111 3112 /** 3113 * Set the end object of the slider object. 3114 * 3115 * @param obj The slider object. 3116 * @param end The end object. 3117 * 3118 * On horizontal mode, end is placed at left, and on vertical mode, 3119 * placed at bottom. 3120 * 3121 * @note Once the icon object is set, a previously set one will be deleted. 3122 * If you want to keep that old content object, use the 3123 * elm_slider_end_unset() function. 3124 * 3125 * @warning If the object being set does not have minimum size hints set, 3126 * it won't get properly displayed. 3127 * 3128 * @deprecated use elm_object_part_content_set() instead. 3129 * 3130 */ 3131 EINA_DEPRECATED EAPI void elm_slider_end_set(Evas_Object *obj, Evas_Object *end); 3132 3133 /** 3134 * Unset an end object set on a given slider widget. 3135 * 3136 * @param obj The slider object. 3137 * @return The end object that was being used, if any was set, or 3138 * @c NULL, otherwise (and on errors). 3139 * 3140 * On horizontal mode, end is placed at left, and on vertical mode, 3141 * placed at bottom. 3142 * 3143 * This call will unparent and return the icon object which was set 3144 * for this widget, previously, on success. 3145 * 3146 * @see elm_slider_end_set() for more details. 3147 * @see elm_slider_end_get() 3148 * 3149 * @deprecated use elm_object_part_content_unset() instead 3150 * instead. 3151 * 3152 */ 3153 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_unset(Evas_Object *obj); 3154 3155 /** 3156 * Get the end object set for a given slider widget. 3157 * 3158 * @param obj The slider object. 3159 * @return The end object's handle, if @p obj had one set, or @c NULL, 3160 * otherwise (and on errors). 3161 * 3162 * On horizontal mode, icon is placed at right, and on vertical mode, 3163 * placed at bottom. 3164 * 3165 * @see elm_slider_end_set() for more details. 3166 * @see elm_slider_end_unset() 3167 * 3168 * 3169 * @deprecated use elm_object_part_content_get() instead 3170 * instead. 3171 * 3172 */ 3173 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_get(const Evas_Object *obj); 3174 3175 /** 3176 * Return the data associated with a given slideshow item 3177 * 3178 * @param it The slideshow item 3179 * @return Returns the data associated to this item 3180 * 3181 * @deprecated use elm_object_item_data_get() instead 3182 */ 3183 EINA_DEPRECATED EAPI void *elm_slideshow_item_data_get(const Elm_Object_Item *it); 3184 3185 /** 3186 * Delete a given item from a slideshow widget. 3187 * 3188 * @param it The slideshow item 3189 * 3190 * @deprecated Use elm_object_item_de() instead 3191 */ 3192 EINA_DEPRECATED EAPI void elm_slideshow_item_del(Elm_Object_Item *it); 3193 3194 /** 3195 * Display a given slideshow widget's item, programmatically. 3196 * 3197 * @param it The item to display on @p obj's viewport 3198 * 3199 * The change between the current item and @p item will use the 3200 * transition @p obj is set to use (@see 3201 * elm_slideshow_transition_set()). 3202 * 3203 * @deprecated use elm_slideshow_item_show() instead 3204 */ 3205 EINA_DEPRECATED EAPI void elm_slideshow_show(Elm_Object_Item *it); 3206 3207 /** 3208 * Get the toolbar object from an item. 3209 * 3210 * @param it The item. 3211 * @return The toolbar object. 3212 * 3213 * This returns the toolbar object itself that an item belongs to. 3214 * 3215 * @deprecated use elm_object_item_widget_get() instead. 3216 */ 3217 EINA_DEPRECATED EAPI Evas_Object *elm_toolbar_item_toolbar_get(const Elm_Object_Item *it); 3218 3219 /** 3220 * Get the label of item. 3221 * 3222 * @param it The item of toolbar. 3223 * @return The label of item. 3224 * 3225 * The return value is a pointer to the label associated to @p item when 3226 * it was created, with function elm_toolbar_item_append() or similar, 3227 * or later, 3228 * with function elm_toolbar_item_label_set. If no label 3229 * was passed as argument, it will return @c NULL. 3230 * 3231 * @see elm_toolbar_item_label_set() for more details. 3232 * @see elm_toolbar_item_append() 3233 * 3234 * @deprecated use elm_object_item_text_get() instead. 3235 */ 3236 EINA_DEPRECATED EAPI const char *elm_toolbar_item_label_get(const Elm_Object_Item *it); 3237 3238 /** 3239 * Set the label of item. 3240 * 3241 * @param it The item of toolbar. 3242 * @param label The label of item. 3243 * 3244 * The label to be displayed by the item. 3245 * Label will be placed at icons bottom (if set). 3246 * 3247 * If a label was passed as argument on item creation, with function 3248 * elm_toolbar_item_append() or similar, it will be already 3249 * displayed by the item. 3250 * 3251 * @see elm_toolbar_item_label_get() 3252 * @see elm_toolbar_item_append() 3253 * 3254 * @deprecated use elm_object_item_text_set() instead 3255 */ 3256 EINA_DEPRECATED EAPI void elm_toolbar_item_label_set(Elm_Object_Item *it, const char *label); 3257 3258 /** 3259 * Return the data associated with a given toolbar widget item. 3260 * 3261 * @param it The toolbar widget item handle. 3262 * @return The data associated with @p item. 3263 * 3264 * @see elm_toolbar_item_data_set() 3265 * 3266 * @deprecated use elm_object_item_data_get() instead. 3267 */ 3268 EINA_DEPRECATED EAPI void *elm_toolbar_item_data_get(const Elm_Object_Item *it); 3269 3270 /** 3271 * Set the data associated with a given toolbar widget item. 3272 * 3273 * @param it The toolbar widget item handle 3274 * @param data The new data pointer to set to @p item. 3275 * 3276 * This sets new item data on @p item. 3277 * 3278 * @warning The old data pointer won't be touched by this function, so 3279 * the user had better to free that old data himself/herself. 3280 * 3281 * @deprecated use elm_object_item_data_set() instead. 3282 */ 3283 EINA_DEPRECATED EAPI void elm_toolbar_item_data_set(Elm_Object_Item *it, const void *data); 3284 3285 /** 3286 * Get a value whether toolbar item is disabled or not. 3287 * 3288 * @param it The item. 3289 * @return The disabled state. 3290 * 3291 * @see elm_toolbar_item_disabled_set() for more details. 3292 * 3293 * @deprecated use elm_object_item_disabled_get() instead. 3294 */ 3295 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_disabled_get(const Elm_Object_Item *it); 3296 3297 /** 3298 * Sets the disabled/enabled state of a toolbar item. 3299 * 3300 * @param it The item. 3301 * @param disabled The disabled state. 3302 * 3303 * A disabled item cannot be selected or unselected. It will also 3304 * change its appearance (generally greyed out). This sets the 3305 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for 3306 * enabled). 3307 * 3308 * @deprecated use elm_object_item_disabled_set() instead. 3309 */ 3310 EINA_DEPRECATED EAPI void elm_toolbar_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled); 3311 3312 /** 3313 * Change a toolbar's orientation 3314 * @param obj The toolbar object 3315 * @param vertical If @c EINA_TRUE, the toolbar is vertical 3316 * By default, a toolbar will be horizontal. Use this function to create a vertical toolbar. 3317 * @deprecated use elm_toolbar_horizontal_set() instead. 3318 */ 3319 EINA_DEPRECATED EAPI void elm_toolbar_orientation_set(Evas_Object *obj, Eina_Bool vertical); 3320 3321 /** 3322 * Get a toolbar's orientation 3323 * @param obj The toolbar object 3324 * @return If @c EINA_TRUE, the toolbar is vertical 3325 * By default, a toolbar will be horizontal. Use this function to determine whether a toolbar is vertical. 3326 * @deprecated use elm_toolbar_horizontal_get() instead. 3327 */ 3328 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_orientation_get(const Evas_Object *obj); 3329 3330 /** 3331 * Set the function called when a toolbar item is freed. 3332 * 3333 * @param it The item to set the callback on. 3334 * @param func The function called. 3335 * 3336 * If there is a @p func, then it will be called prior item's memory release. 3337 * That will be called with the following arguments: 3338 * @li item's data; 3339 * @li item's Evas object; 3340 * @li item itself; 3341 * 3342 * This way, a data associated to a toolbar item could be properly freed. 3343 * 3344 * @deprecated Use elm_object_item_del_cb_set() instead 3345 */ 3346 EINA_DEPRECATED EAPI void elm_toolbar_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func); 3347 3348 /** 3349 * Delete them item from the toolbar. 3350 * 3351 * @param it The item of toolbar to be deleted. 3352 * 3353 * @deprecated Use elm_object_item_del() instead 3354 * @see elm_toolbar_item_append() 3355 * 3356 */ 3357 EINA_DEPRECATED EAPI void elm_toolbar_item_del(Elm_Object_Item *it); 3358 3359 /** 3360 * Set the content to be shown in the tooltip item. 3361 * 3362 * Setup the tooltip to item. The item can have only one tooltip, 3363 * so any previous tooltip data is removed. @p func(with @p data) will 3364 * be called every time that need show the tooltip and it should 3365 * return a valid Evas_Object. This object is then managed fully by 3366 * tooltip system and is deleted when the tooltip is gone. 3367 * 3368 * @param it the toolbar item being attached a tooltip. 3369 * @param func the function used to create the tooltip contents. 3370 * @param data what to provide to @a func as callback data/context. 3371 * @param del_cb called when data is not needed anymore, either when 3372 * another callback replaces @a func, the tooltip is unset with 3373 * elm_toolbar_item_tooltip_unset() or the owner @a item 3374 * dies. This callback receives as the first parameter the 3375 * given @a data, and @p event_info is the item. 3376 * 3377 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead 3378 * @see elm_object_tooltip_content_cb_set() for more details. 3379 * 3380 */ 3381 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_content_cb_set(Elm_Object_Item *it, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb); 3382 3383 /** 3384 * Unset tooltip from item. 3385 * 3386 * @param it toolbar item to remove previously set tooltip. 3387 * 3388 * Remove tooltip from item. The callback provided as del_cb to 3389 * elm_toolbar_item_tooltip_content_cb_set() will be called to notify 3390 * it is not used anymore. 3391 * 3392 * @deprecated Use elm_object_item_tooltip_unset() instead 3393 * @see elm_object_tooltip_unset() for more details. 3394 * @see elm_toolbar_item_tooltip_content_cb_set() 3395 * 3396 */ 3397 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_unset(Elm_Object_Item *it); 3398 3399 /** 3400 * Sets a different style for this item tooltip. 3401 * 3402 * @note before you set a style you should define a tooltip with 3403 * elm_toolbar_item_tooltip_content_cb_set() or 3404 * elm_toolbar_item_tooltip_text_set() 3405 * 3406 * @param it toolbar item with tooltip already set. 3407 * @param style the theme style to use (default, transparent, ...) 3408 * 3409 * @deprecated Use elm_object_item_tooltip_style_set() instead 3410 * @see elm_object_tooltip_style_set() for more details. 3411 * 3412 */ 3413 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_style_set(Elm_Object_Item *it, const char *style); 3414 3415 /** 3416 * Get the style for this item tooltip. 3417 * 3418 * @param it toolbar item with tooltip already set. 3419 * @return style the theme style in use, defaults to "default". If the 3420 * object does not have a tooltip set, then NULL is returned. 3421 * 3422 * @deprecated Use elm_object_item_style_get() instead 3423 * @see elm_object_tooltip_style_get() for more details. 3424 * @see elm_toolbar_item_tooltip_style_set() 3425 * 3426 */ 3427 EINA_DEPRECATED EAPI const char *elm_toolbar_item_tooltip_style_get(const Elm_Object_Item *it); 3428 3429 /** 3430 * Set the type of mouse pointer/cursor decoration to be shown, 3431 * when the mouse pointer is over the given toolbar widget item 3432 * 3433 * @param it toolbar item to customize cursor on 3434 * @param cursor the cursor type's name 3435 * 3436 * This function works analogously as elm_object_cursor_set(), but 3437 * here the cursor's changing area is restricted to the item's 3438 * area, and not the whole widget's. Note that that item cursors 3439 * have precedence over widget cursors, so that a mouse over an 3440 * item with custom cursor set will always show @b that cursor. 3441 * 3442 * If this function is called twice for an object, a previously set 3443 * cursor will be unset on the second call. 3444 * 3445 * @see elm_object_cursor_set() 3446 * @see elm_toolbar_item_cursor_get() 3447 * @see elm_toolbar_item_cursor_unset() 3448 * 3449 * @deprecated use elm_object_item_cursor_set() instead 3450 * 3451 */ 3452 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_set(Elm_Object_Item *it, const char *cursor); 3453 3454 /* 3455 * Get the type of mouse pointer/cursor decoration set to be shown, 3456 * when the mouse pointer is over the given toolbar widget item 3457 * 3458 * @param it toolbar item with custom cursor set 3459 * @return the cursor type's name or @c NULL, if no custom cursors 3460 * were set to @p item (and on errors) 3461 * 3462 * @see elm_object_cursor_get() 3463 * @see elm_toolbar_item_cursor_set() 3464 * @see elm_toolbar_item_cursor_unset() 3465 * 3466 * @deprecated Use elm_object_item_cursor_get() instead 3467 * 3468 */ 3469 EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_get(const Elm_Object_Item *it); 3470 3471 /** 3472 * Unset any custom mouse pointer/cursor decoration set to be 3473 * shown, when the mouse pointer is over the given toolbar widget 3474 * item, thus making it show the @b default cursor again. 3475 * 3476 * @param it a toolbar item 3477 * 3478 * Use this call to undo any custom settings on this item's cursor 3479 * decoration, bringing it back to defaults (no custom style set). 3480 * 3481 * @see elm_object_cursor_unset() 3482 * @see elm_toolbar_item_cursor_set() 3483 * 3484 * @deprecated Use elm_object_item_cursor_unset() instead 3485 * 3486 */ 3487 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_unset(Elm_Object_Item *it); 3488 3489 /** 3490 * Set a different @b style for a given custom cursor set for a 3491 * toolbar item. 3492 * 3493 * @param it toolbar item with custom cursor set 3494 * @param style the <b>theme style</b> to use (e.g. @c "default", 3495 * @c "transparent", etc) 3496 * 3497 * This function only makes sense when one is using custom mouse 3498 * cursor decorations <b>defined in a theme file</b>, which can have, 3499 * given a cursor name/type, <b>alternate styles</b> on it. It 3500 * works analogously as elm_object_cursor_style_set(), but here 3501 * applies only to toolbar item objects. 3502 * 3503 * @warning Before you set a cursor style you should have defined a 3504 * custom cursor previously on the item, with 3505 * elm_toolbar_item_cursor_set() 3506 * 3507 * @see elm_toolbar_item_cursor_engine_only_set() 3508 * @see elm_toolbar_item_cursor_style_get() 3509 * 3510 * @deprecated Use elm_object_item_cursor_style_set() instead 3511 * 3512 */ 3513 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_style_set(Elm_Object_Item *it, const char *style); 3514 3515 /** 3516 * Get the current @b style set for a given toolbar item's custom 3517 * cursor 3518 * 3519 * @param it toolbar item with custom cursor set. 3520 * @return style the cursor style in use. If the object does not 3521 * have a cursor set, then @c NULL is returned. 3522 * 3523 * @see elm_toolbar_item_cursor_style_set() for more details 3524 * 3525 * @deprecated Use elm_object_item_cursor_style_get() instead 3526 * 3527 */ 3528 EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_style_get(const Elm_Object_Item *it); 3529 3530 /** 3531 * Set if the (custom)cursor for a given toolbar item should be 3532 * searched in its theme, also, or should only rely on the 3533 * rendering engine. 3534 * 3535 * @param it item with custom (custom) cursor already set on 3536 * @param engine_only Use @c EINA_TRUE to have cursors looked for 3537 * only on those provided by the rendering engine, @c EINA_FALSE to 3538 * have them searched on the widget's theme, as well. 3539 * 3540 * @note This call is of use only if you've set a custom cursor 3541 * for toolbar items, with elm_toolbar_item_cursor_set(). 3542 * 3543 * @note By default, cursors will only be looked for between those 3544 * provided by the rendering engine. 3545 * 3546 * @deprecated Use elm_object_item_cursor_engine_only_set() instead 3547 * 3548 */ 3549 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only); 3550 3551 /** 3552 * Get if the (custom) cursor for a given toolbar item is being 3553 * searched in its theme, also, or is only relying on the rendering 3554 * engine. 3555 * 3556 * @param it a toolbar item 3557 * @return @c EINA_TRUE, if cursors are being looked for only on 3558 * those provided by the rendering engine, @c EINA_FALSE if they 3559 * are being searched on the widget's theme, as well. 3560 * 3561 * @see elm_toolbar_item_cursor_engine_only_set(), for more details 3562 * 3563 * @deprecated Use elm_object_item_cursor_engine_only_get() instead 3564 * 3565 */ 3566 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_cursor_engine_only_get(const Elm_Object_Item *it); 3567 3568 /** 3569 * @brief Link a Elm_Payer with an Elm_Video object. 3570 * 3571 * @param player the Elm_Player object. 3572 * @param video The Elm_Video object. 3573 * 3574 * This mean that action on the player widget will affect the 3575 * video object and the state of the video will be reflected in 3576 * the player itself. 3577 * 3578 * @see elm_player_add() 3579 * @see elm_video_add() 3580 * @deprecated use elm_object_part_content_set() instead 3581 * 3582 */ 3583 EINA_DEPRECATED EAPI void elm_player_video_set(Evas_Object *player, Evas_Object *video); 3584 3585 /** 3586 * Set the label of item. 3587 * 3588 * @param it The item of segment control. 3589 * @param label The label of item. 3590 * 3591 * The label to be displayed by the item. 3592 * Label will be at right of the icon (if set). 3593 * 3594 * If a label was passed as argument on item creation, with function 3595 * elm_control_segment_item_add(), it will be already 3596 * displayed by the item. 3597 * 3598 * @see elm_segment_control_item_label_get() 3599 * @see elm_segment_control_item_add() 3600 * @deprecated Use elm_object_item_text_set() instead 3601 * 3602 */ 3603 EINA_DEPRECATED EAPI void elm_segment_control_item_label_set(Elm_Object_Item *it, const char *label); 3604 3605 3606 /** 3607 * Set the icon associated to the item. 3608 * 3609 * @param it The segment control item. 3610 * @param icon The icon object to associate with @p it. 3611 * 3612 * The icon object to use at left side of the item. An 3613 * icon can be any Evas object, but usually it is an icon created 3614 * with elm_icon_add(). 3615 * 3616 * Once the icon object is set, a previously set one will be deleted. 3617 * @warning Setting the same icon for two items will cause the icon to 3618 * disappear from the first item. 3619 * 3620 * If an icon was passed as argument on item creation, with function 3621 * elm_segment_control_item_add(), it will be already 3622 * associated to the item. 3623 * 3624 * @see elm_segment_control_item_add() 3625 * @see elm_segment_control_item_icon_get() 3626 * @deprecated Use elm_object_item_part_content_set() instead 3627 * 3628 */ 3629 EINA_DEPRECATED EAPI void elm_segment_control_item_icon_set(Elm_Object_Item *it, Evas_Object *icon); 3630 3631 /** 3632 * Remove a segment control item from its parent, deleting it. 3633 * 3634 * @param it The item to be removed. 3635 * 3636 * Items can be added with elm_segment_control_item_add() or 3637 * elm_segment_control_item_insert_at(). 3638 * 3639 * @deprecated Use elm_object_item_del() instead 3640 */ 3641 EINA_DEPRECATED EAPI void elm_segment_control_item_del(Elm_Object_Item *it); 3642 3643 /** 3644 * Get the label 3645 * 3646 * @param obj The multibuttonentry object 3647 * @return The label, or NULL if none 3648 * 3649 * @deprecated Use elm_object_text_get() instead 3650 * 3651 */ 3652 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_label_get(const Evas_Object *obj); 3653 3654 /** 3655 * Set the label 3656 * 3657 * @param obj The multibuttonentry object 3658 * @param label The text label string 3659 * 3660 * @deprecated Use elm_object_text_set() instead 3661 * 3662 */ 3663 EINA_DEPRECATED EAPI void elm_multibuttonentry_label_set(Evas_Object *obj, const char *label); 3664 3665 /** 3666 * Get the label of a given item 3667 * 3668 * @param it The item 3669 * @return The label of a given item, or NULL if none 3670 * 3671 * @deprecated Use elm_object_item_text_get() instead 3672 * 3673 */ 3674 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_item_label_get(const Elm_Object_Item *it); 3675 3676 /** 3677 * Set the label of a given item 3678 * 3679 * @param it The item 3680 * @param str The text label string 3681 * 3682 * @deprecated Use elm_object_item_text_set() instead 3683 */ 3684 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_label_set(Elm_Object_Item *it, const char *str); 3685 3686 /** 3687 * Delete a given item 3688 * 3689 * @param it The item 3690 * 3691 * @deprecated Use elm_object_item_del() instead 3692 * 3693 */ 3694 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_del(Elm_Object_Item *it); 3695 3696 /** 3697 * @brief Delete the given item instantly. 3698 * 3699 * @param it The naviframe item 3700 * 3701 * This just deletes the given item from the naviframe item list instantly. 3702 * So this would not emit any signals for view transitions but just change 3703 * the current view if the given item is a top one. 3704 * 3705 * @deprecated Use elm_object_item_del() instead 3706 */ 3707 EINA_DEPRECATED EAPI void elm_naviframe_item_del(Elm_Object_Item *it); 3708 3709 3710 3711 /** 3712 * Sets the disabled/enabled state of a list item. 3713 * 3714 * @param it The item. 3715 * @param disabled The disabled state. 3716 * 3717 * A disabled item cannot be selected or unselected. It will also 3718 * change its appearance (generally greyed out). This sets the 3719 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for 3720 * enabled). 3721 * 3722 * @deprecated Use elm_object_item_disabled_set() instead 3723 * 3724 */ 3725 EINA_DEPRECATED EAPI void elm_list_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled); 3726 3727 /** 3728 * Get a value whether list item is disabled or not. 3729 * 3730 * @param it The item. 3731 * @return The disabled state. 3732 * 3733 * @see elm_list_item_disabled_set() for more details. 3734 * 3735 * @deprecated Use elm_object_item_disabled_get() instead 3736 * 3737 */ 3738 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_disabled_get(const Elm_Object_Item *it); 3739 3740 /** 3741 * @brief Disable size restrictions on an object's tooltip 3742 * @param it The tooltip's anchor object 3743 * @param disable If EINA_TRUE, size restrictions are disabled 3744 * @return EINA_FALSE on failure, EINA_TRUE on success 3745 * 3746 * This function allows a tooltip to expand beyond its parent window's canvas. 3747 * It will instead be limited only by the size of the display. 3748 * 3749 * @deprecated Use elm_object_item_tooltip_window_mode_set() instead 3750 * 3751 */ 3752 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_set(Elm_Object_Item *it, Eina_Bool disable); 3753 3754 /** 3755 * @brief Get size restriction state of an object's tooltip 3756 * @param obj The tooltip's anchor object 3757 * @return If EINA_TRUE, size restrictions are disabled 3758 * 3759 * This function returns whether a tooltip is allowed to expand beyond 3760 * its parent window's canvas. 3761 * It will instead be limited only by the size of the display. 3762 * 3763 * @deprecated Use elm_object_item_tooltip_window_mode_get() instead 3764 * 3765 */ 3766 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_get(const Elm_Object_Item *it); 3767 3768 /** 3769 * Set the function called when a list item is freed. 3770 * 3771 * @param it The item to set the callback on 3772 * @param func The function called 3773 * 3774 * If there is a @p func, then it will be called prior item's memory release. 3775 * That will be called with the following arguments: 3776 * @li item's data; 3777 * @li item's Evas object; 3778 * @li item itself; 3779 * 3780 * This way, a data associated to a list item could be properly freed. 3781 * 3782 * @deprecated Please use elm_object_item_del_cb_set() instead. 3783 * 3784 */ 3785 EINA_DEPRECATED EAPI void elm_list_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func); 3786 3787 /** 3788 * Get the data associated to the item. 3789 * 3790 * @param it The list item 3791 * @return The data associated to @p item 3792 * 3793 * The return value is a pointer to data associated to @p item when it was 3794 * created, with function elm_list_item_append() or similar. If no data 3795 * was passed as argument, it will return @c NULL. 3796 * 3797 * @see elm_list_item_append() 3798 * 3799 * @deprecated Please use elm_object_item_data_get() instead. 3800 * 3801 */ 3802 EINA_DEPRECATED EAPI void *elm_list_item_data_get(const Elm_Object_Item *it); 3803 3804 /** 3805 * Get the left side icon associated to the item. 3806 * 3807 * @param it The list item 3808 * @return The left side icon associated to @p item 3809 * 3810 * The return value is a pointer to the icon associated to @p item when 3811 * it was 3812 * created, with function elm_list_item_append() or similar, or later 3813 * with function elm_list_item_icon_set(). If no icon 3814 * was passed as argument, it will return @c NULL. 3815 * 3816 * @see elm_list_item_append() 3817 * @see elm_list_item_icon_set() 3818 * 3819 * @deprecated Please use elm_object_item_part_content_get(item, NULL); 3820 */ 3821 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_icon_get(const Elm_Object_Item *it); 3822 3823 /** 3824 * Set the left side icon associated to the item. 3825 * 3826 * @param it The list item 3827 * @param icon The left side icon object to associate with @p item 3828 * 3829 * The icon object to use at left side of the item. An 3830 * icon can be any Evas object, but usually it is an icon created 3831 * with elm_icon_add(). 3832 * 3833 * Once the icon object is set, a previously set one will be deleted. 3834 * @warning Setting the same icon for two items will cause the icon to 3835 * disappear from the first item. 3836 * 3837 * If an icon was passed as argument on item creation, with function 3838 * elm_list_item_append() or similar, it will be already 3839 * associated to the item. 3840 * 3841 * @see elm_list_item_append() 3842 * @see elm_list_item_icon_get() 3843 * 3844 * @deprecated Please use elm_object_item_part_content_set(item, NULL, icon); 3845 */ 3846 EINA_DEPRECATED EAPI void elm_list_item_icon_set(Elm_Object_Item *it, Evas_Object *icon); 3847 3848 /** 3849 * Get the right side icon associated to the item. 3850 * 3851 * @param it The list item 3852 * @return The right side icon associated to @p item 3853 * 3854 * The return value is a pointer to the icon associated to @p item when 3855 * it was 3856 * created, with function elm_list_item_append() or similar, or later 3857 * with function elm_list_item_icon_set(). If no icon 3858 * was passed as argument, it will return @c NULL. 3859 * 3860 * @see elm_list_item_append() 3861 * @see elm_list_item_icon_set() 3862 * 3863 * @deprecated Please use elm_object_item_part_content_get(item, "end"); 3864 */ 3865 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_end_get(const Elm_Object_Item *it); 3866 3867 /** 3868 * Set the right side icon associated to the item. 3869 * 3870 * @param it The list item 3871 * @param end The right side icon object to associate with @p item 3872 * 3873 * The icon object to use at right side of the item. An 3874 * icon can be any Evas object, but usually it is an icon created 3875 * with elm_icon_add(). 3876 * 3877 * Once the icon object is set, a previously set one will be deleted. 3878 * @warning Setting the same icon for two items will cause the icon to 3879 * disappear from the first item. 3880 * 3881 * If an icon was passed as argument on item creation, with function 3882 * elm_list_item_append() or similar, it will be already 3883 * associated to the item. 3884 * 3885 * @see elm_list_item_append() 3886 * @see elm_list_item_end_get() 3887 * 3888 * @deprecated Please use elm_object_item_part_content_set(item, "end", end); 3889 */ 3890 EINA_DEPRECATED EAPI void elm_list_item_end_set(Elm_Object_Item *it, Evas_Object *end); 3891 3892 /** 3893 * Get the label of item. 3894 * 3895 * @param it The item of list. 3896 * @return The label of item. 3897 * 3898 * The return value is a pointer to the label associated to @p item when 3899 * it was created, with function elm_list_item_append(), or later 3900 * with function elm_list_item_label_set. If no label 3901 * was passed as argument, it will return @c NULL. 3902 * 3903 * @see elm_list_item_label_set() for more details. 3904 * @see elm_list_item_append() 3905 * 3906 * @deprecated Please use elm_object_item_text_get(item); 3907 */ 3908 EINA_DEPRECATED EAPI const char *elm_list_item_label_get(const Elm_Object_Item *it); 3909 3910 /** 3911 * Set the label of item. 3912 * 3913 * @param it The item of list. 3914 * @param text The label of item. 3915 * 3916 * The label to be displayed by the item. 3917 * Label will be placed between left and right side icons (if set). 3918 * 3919 * If a label was passed as argument on item creation, with function 3920 * elm_list_item_append() or similar, it will be already 3921 * displayed by the item. 3922 * 3923 * @see elm_list_item_label_get() 3924 * @see elm_list_item_append() 3925 * 3926 * @deprecated Please use elm_object_item_text_set(item, text); 3927 */ 3928 EINA_DEPRECATED EAPI void elm_list_item_label_set(Elm_Object_Item *it, const char *text); 3929 3930 /** 3931 * Set the text to be shown in a given list item's tooltips. 3932 * 3933 * @param it Target item. 3934 * @param text The text to set in the content. 3935 * 3936 * Setup the text as tooltip to object. The item can have only one tooltip, 3937 * so any previous tooltip data - set with this function or 3938 * elm_list_item_tooltip_content_cb_set() - is removed. 3939 * 3940 * @deprecated Use elm_object_item_tooltip_text_set() instead 3941 * @see elm_object_tooltip_text_set() for more details. 3942 * 3943 */ 3944 EINA_DEPRECATED EAPI void elm_list_item_tooltip_text_set(Elm_Object_Item *it, const char *text); 3945 3946 /** 3947 * Set the content to be shown in the tooltip item. 3948 * 3949 * Setup the tooltip to item. The item can have only one tooltip, 3950 * so any previous tooltip data is removed. @p func(with @p data) will 3951 * be called every time that need show the tooltip and it should 3952 * return a valid Evas_Object. This object is then managed fully by 3953 * tooltip system and is deleted when the tooltip is gone. 3954 * 3955 * @param it the list item being attached a tooltip. 3956 * @param func the function used to create the tooltip contents. 3957 * @param data what to provide to @a func as callback data/context. 3958 * @param del_cb called when data is not needed anymore, either when 3959 * another callback replaces @a func, the tooltip is unset with 3960 * elm_list_item_tooltip_unset() or the owner @a item 3961 * dies. This callback receives as the first parameter the 3962 * given @a data, and @p event_info is the item. 3963 * 3964 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead 3965 * 3966 * @see elm_object_tooltip_content_cb_set() for more details. 3967 * 3968 */ 3969 EINA_DEPRECATED EAPI void elm_list_item_tooltip_content_cb_set(Elm_Object_Item *it, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb); 3970 3971 /** 3972 * Unset tooltip from item. 3973 * 3974 * @param it list item to remove previously set tooltip. 3975 * 3976 * Remove tooltip from item. The callback provided as del_cb to 3977 * elm_list_item_tooltip_content_cb_set() will be called to notify 3978 * it is not used anymore. 3979 * 3980 * @deprecated Use elm_object_item_tooltip_unset() instead 3981 * @see elm_object_tooltip_unset() for more details. 3982 * @see elm_list_item_tooltip_content_cb_set() 3983 * 3984 */ 3985 EINA_DEPRECATED EAPI void elm_list_item_tooltip_unset(Elm_Object_Item *it); 3986 3987 /** 3988 * Sets a different style for this item tooltip. 3989 * 3990 * @note before you set a style you should define a tooltip with 3991 * elm_list_item_tooltip_content_cb_set() or 3992 * elm_list_item_tooltip_text_set() 3993 * 3994 * @param it list item with tooltip already set. 3995 * @param style the theme style to use (default, transparent, ...) 3996 * 3997 * 3998 * @deprecated Use elm_object_item_tooltip_style_set() instead 3999 * @see elm_object_tooltip_style_set() for more details. 4000 * 4001 */ 4002 EINA_DEPRECATED EAPI void elm_list_item_tooltip_style_set(Elm_Object_Item *it, const char *style); 4003 4004 /** 4005 * Get the style for this item tooltip. 4006 * 4007 * @param it list item with tooltip already set. 4008 * @return style the theme style in use, defaults to "default". If the 4009 * object does not have a tooltip set, then NULL is returned. 4010 * 4011 * @deprecated Use elm_object_item_tooltip_style_get() instead 4012 * 4013 * @see elm_object_tooltip_style_get() for more details. 4014 * @see elm_list_item_tooltip_style_set() 4015 * 4016 */ 4017 EINA_DEPRECATED EAPI const char *elm_list_item_tooltip_style_get(const Elm_Object_Item *it); 4018 4019 /** 4020 * Set the type of mouse pointer/cursor decoration to be shown, 4021 * when the mouse pointer is over the given list widget item 4022 * 4023 * @param it list item to customize cursor on 4024 * @param cursor the cursor type's name 4025 * 4026 * This function works analogously as elm_object_cursor_set(), but 4027 * here the cursor's changing area is restricted to the item's 4028 * area, and not the whole widget's. Note that that item cursors 4029 * have precedence over widget cursors, so that a mouse over an 4030 * item with custom cursor set will always show @b that cursor. 4031 * 4032 * If this function is called twice for an object, a previously set 4033 * cursor will be unset on the second call. 4034 * 4035 * @see elm_object_cursor_set() 4036 * @see elm_list_item_cursor_get() 4037 * @see elm_list_item_cursor_unset() 4038 * 4039 * @deprecated Please use elm_object_item_cursor_set() instead 4040 */ 4041 EINA_DEPRECATED EAPI void elm_list_item_cursor_set(Elm_Object_Item *it, const char *cursor); 4042 4043 /* 4044 * Get the type of mouse pointer/cursor decoration set to be shown, 4045 * when the mouse pointer is over the given list widget item 4046 * 4047 * @param it list item with custom cursor set 4048 * @return the cursor type's name or @c NULL, if no custom cursors 4049 * were set to @p item (and on errors) 4050 * 4051 * @see elm_object_cursor_get() 4052 * @see elm_list_item_cursor_set() 4053 * @see elm_list_item_cursor_unset() 4054 * 4055 * @deprecated Please use elm_object_item_cursor_get() instead 4056 */ 4057 EINA_DEPRECATED EAPI const char *elm_list_item_cursor_get(const Elm_Object_Item *it); 4058 4059 /** 4060 * Unset any custom mouse pointer/cursor decoration set to be 4061 * shown, when the mouse pointer is over the given list widget 4062 * item, thus making it show the @b default cursor again. 4063 * 4064 * @param it a list item 4065 * 4066 * Use this call to undo any custom settings on this item's cursor 4067 * decoration, bringing it back to defaults (no custom style set). 4068 * 4069 * @see elm_object_cursor_unset() 4070 * @see elm_list_item_cursor_set() 4071 * 4072 * @deprecated Please use elm_list_item_cursor_unset() instead 4073 */ 4074 EINA_DEPRECATED EAPI void elm_list_item_cursor_unset(Elm_Object_Item *it); 4075 4076 /** 4077 * Set a different @b style for a given custom cursor set for a 4078 * list item. 4079 * 4080 * @param it list item with custom cursor set 4081 * @param style the <b>theme style</b> to use (e.g. @c "default", 4082 * @c "transparent", etc) 4083 * 4084 * This function only makes sense when one is using custom mouse 4085 * cursor decorations <b>defined in a theme file</b>, which can have, 4086 * given a cursor name/type, <b>alternate styles</b> on it. It 4087 * works analogously as elm_object_cursor_style_set(), but here 4088 * applies only to list item objects. 4089 * 4090 * @warning Before you set a cursor style you should have defined a 4091 * custom cursor previously on the item, with 4092 * elm_list_item_cursor_set() 4093 * 4094 * @see elm_list_item_cursor_engine_only_set() 4095 * @see elm_list_item_cursor_style_get() 4096 * 4097 * @deprecated Please use elm_list_item_cursor_style_set() instead 4098 */ 4099 EINA_DEPRECATED EAPI void elm_list_item_cursor_style_set(Elm_Object_Item *it, const char *style); 4100 4101 /** 4102 * Get the current @b style set for a given list item's custom 4103 * cursor 4104 * 4105 * @param it list item with custom cursor set. 4106 * @return style the cursor style in use. If the object does not 4107 * have a cursor set, then @c NULL is returned. 4108 * 4109 * @see elm_list_item_cursor_style_set() for more details 4110 * 4111 * @deprecated Please use elm_list_item_cursor_style_get() instead 4112 */ 4113 EINA_DEPRECATED EAPI const char *elm_list_item_cursor_style_get(const Elm_Object_Item *it); 4114 4115 /** 4116 * Get if the (custom) cursor for a given list item is being 4117 * searched in its theme, also, or is only relying on the rendering 4118 * engine. 4119 * 4120 * @param it a list item 4121 * @return @c EINA_TRUE, if cursors are being looked for only on 4122 * those provided by the rendering engine, @c EINA_FALSE if they 4123 * are being searched on the widget's theme, as well. 4124 * 4125 * @see elm_list_item_cursor_engine_only_set(), for more details 4126 * 4127 * @deprecated Please use elm_list_item_cursor_engine_only_get() instead 4128 */ 4129 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_cursor_engine_only_get(const Elm_Object_Item *it); 4130 4131 /** 4132 * Delete the item from the list. 4133 * 4134 * @param it The item of list to be deleted. 4135 * 4136 * If deleting all list items is required, elm_list_clear() 4137 * should be used instead of getting items list and deleting each one. 4138 * 4139 * @see elm_list_clear() 4140 * @see elm_list_item_append() 4141 * @see elm_widget_item_del_cb_set() 4142 * @deprecated Use elm_object_item_del() instead 4143 * 4144 */ 4145 EINA_DEPRECATED EAPI void elm_list_item_del(Elm_Object_Item *it); 4146 4147 4148 /** 4149 * This sets a widget to be displayed to the left of a scrolled entry. 4150 * 4151 * @param obj The scrolled entry object 4152 * @param icon The widget to display on the left side of the scrolled 4153 * entry. 4154 * 4155 * @note A previously set widget will be destroyed. 4156 * @note If the object being set does not have minimum size hints set, 4157 * it won't get properly displayed. 4158 * 4159 * @deprecated Use elm_object_part_content_set(entry, "icon", content) instead 4160 * @see elm_entry_end_set() 4161 */ 4162 EINA_DEPRECATED EAPI void elm_entry_icon_set(Evas_Object *obj, Evas_Object *icon); 4163 4164 /** 4165 * Get the leftmost widget of the scrolled entry. This object is 4166 * owned by the scrolled entry and should not be modified. 4167 * 4168 * @param obj The scrolled entry object 4169 * @return the left widget inside the scroller 4170 * 4171 * @deprecated Use elm_object_part_content_get(entry, "icon") instead 4172 */ 4173 EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_get(const Evas_Object *obj); 4174 4175 /** 4176 * Unset the leftmost widget of the scrolled entry, unparenting and 4177 * returning it. 4178 * 4179 * @param obj The scrolled entry object 4180 * @return the previously set icon sub-object of this entry, on 4181 * success. 4182 * 4183 * @deprecated Use elm_object_part_content_unset(entry, "icon") instead 4184 * @see elm_entry_icon_set() 4185 */ 4186 EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_unset(Evas_Object *obj); 4187 4188 /** 4189 * This sets a widget to be displayed to the end of a scrolled entry. 4190 * 4191 * @param obj The scrolled entry object 4192 * @param end The widget to display on the right side of the scrolled 4193 * entry. 4194 * 4195 * @note A previously set widget will be destroyed. 4196 * @note If the object being set does not have minimum size hints set, 4197 * it won't get properly displayed. 4198 * 4199 * @deprecated Use elm_object_part_content_set(entry, "end", content) instead 4200 * @see elm_entry_icon_set 4201 */ 4202 EINA_DEPRECATED EAPI void elm_entry_end_set(Evas_Object *obj, Evas_Object *end); 4203 4204 /** 4205 * Get the endmost widget of the scrolled entry. This object is owned 4206 * by the scrolled entry and should not be modified. 4207 * 4208 * @param obj The scrolled entry object 4209 * @return the right widget inside the scroller 4210 * 4211 * @deprecated Use elm_object_part_content_get(entry, "end") instead 4212 */ 4213 EINA_DEPRECATED EAPI Evas_Object *elm_entry_end_get(const Evas_Object *obj); 4214 4215 /** 4216 * Unset the endmost widget of the scrolled entry, unparenting and 4217 * returning it. 4218 * 4219 * @param obj The scrolled entry object 4220 * @return the previously set icon sub-object of this entry, on 4221 * success. 4222 * 4223 * @deprecated Use elm_object_part_content_unset(entry, "end") instead 4224 * @see elm_entry_icon_set() 4225 */ 4226 EINA_DEPRECATED EAPI Evas_Object *elm_entry_end_unset(Evas_Object *obj); 4227 4228 /** 4229 * Set route service to be used. By default used source is 4230 * #ELM_MAP_ROUTE_SOURCE_YOURS. 4231 * 4232 * @see elm_map_route_source_set() 4233 * @see elm_map_route_source_get() 4234 * 4235 */ 4236 typedef enum 4237 { 4238 ELM_MAP_ROUTE_SOURCE_YOURS, /**< Routing service http://www.yournavigation.org/ . Set by default.*/ 4239 ELM_MAP_ROUTE_SOURCE_MONAV, /**< MoNav offers exact routing without heuristic assumptions. Its routing core is based on Contraction Hierarchies. It's not working with Map yet. */ 4240 ELM_MAP_ROUTE_SOURCE_ORS, /**< Open Route Service: http://www.openrouteservice.org/ . It's not working with Map yet. */ 4241 ELM_MAP_ROUTE_SOURCE_LAST 4242 } Elm_Map_Route_Sources; 4243 4244 /** 4245 * Convert a pixel coordinate into a rotated pixel coordinate. 4246 * 4247 * @param obj The map object. 4248 * @param x horizontal coordinate of the point to rotate. 4249 * @param y vertical coordinate of the point to rotate. 4250 * @param cx rotation's center horizontal position. 4251 * @param cy rotation's center vertical position. 4252 * @param degree amount of degrees from 0.0 to 360.0 to rotate around Z axis. 4253 * @param xx Pointer where to store rotated x. 4254 * @param yy Pointer where to store rotated y. 4255 * 4256 * @deprecated Use elm_map_canvas_to_geo_convert() instead 4257 */ 4258 EINA_DEPRECATED EAPI void elm_map_utils_rotate_coord(const Evas_Object *obj, const Evas_Coord x, const Evas_Coord y, const Evas_Coord cx, const Evas_Coord cy, const double degree, Evas_Coord *xx, Evas_Coord *yy); 4259 4260 /** 4261 * Convert canvas coordinates into a geographic coordinate 4262 * (longitude, latitude). 4263 * 4264 * @param obj The map object. 4265 * @param x horizontal coordinate of the point to convert. 4266 * @param y vertical coordinate of the point to convert. 4267 * @param lon A pointer to the longitude. 4268 * @param lat A pointer to the latitude. 4269 * 4270 * This gets longitude and latitude from canvas x, y coordinates. The canvas 4271 * coordinates mean x, y coordinate from current viewport. 4272 * 4273 * see elm_map_rotate_get() 4274 * @deprecatedUse Use elm_map_canvas_to_region_convert() instead 4275 * 4276 */ 4277 EINA_DEPRECATED EAPI void elm_map_canvas_to_geo_convert(const Evas_Object *obj, const Evas_Coord x, const Evas_Coord y, double *lon, double *lat); 4278 4279 /** 4280 * Get the current geographic coordinates of the map. 4281 * 4282 * @param obj The map object. 4283 * @param lon Pointer to store longitude. 4284 * @param lat Pointer to store latitude. 4285 * 4286 * This gets the current center coordinates of the map object. It can be 4287 * set by elm_map_region_bring_in() and elm_map_region_show(). 4288 * 4289 * @see elm_map_region_bring_in() 4290 * @see elm_map_region_show() 4291 * 4292 * @deprecated Use elm_map_region_get() instead 4293 */ 4294 EINA_DEPRECATED EAPI void elm_map_geo_region_get(const Evas_Object *obj, double *lon, double *lat); 4295 4296 /** 4297 * Animatedly bring in given coordinates to the center of the map. 4298 * 4299 * @param obj The map object. 4300 * @param lon Longitude to center at. 4301 * @param lat Latitude to center at. 4302 * 4303 * This causes map to jump to the given @p lat and @p lon coordinates 4304 * and show it (by scrolling) in the center of the viewport, if it is not 4305 * already centered. This will use animation to do so and take a period 4306 * of time to complete. 4307 * 4308 * @see elm_map_region_show() for a function to avoid animation. 4309 * @see elm_map_region_get() 4310 * 4311 * @deprecated Use elm_map_region_bring_in() instead 4312 */ 4313 EINA_DEPRECATED EAPI void elm_map_geo_region_bring_in(Evas_Object *obj, double lon, double lat); 4314 4315 /** 4316 * Show the given coordinates at the center of the map, @b immediately. 4317 * 4318 * @param obj The map object. 4319 * @param lon Longitude to center at. 4320 * @param lat Latitude to center at. 4321 * 4322 * This causes map to @b redraw its viewport's contents to the 4323 * region containing the given @p lat and @p lon, that will be moved to the 4324 * center of the map. 4325 * 4326 * @see elm_map_region_bring_in() for a function to move with animation. 4327 * @see elm_map_region_get() 4328 * 4329 * @deprecated Use elm_map_region_show() instead 4330 */ 4331 EINA_DEPRECATED EAPI void elm_map_geo_region_show(Evas_Object *obj, double lon, double lat); 4332 4333 /** 4334 * Set the minimum zoom of the source. 4335 * 4336 * @param obj The map object. 4337 * @param zoom New minimum zoom value to be used. 4338 * 4339 * By default, it's 0. 4340 * 4341 * @deprecated Use elm_map_zoom_min_set() instead 4342 */ 4343 EINA_DEPRECATED EAPI void elm_map_source_zoom_min_set(Evas_Object *obj, int zoom); 4344 4345 /** 4346 * Get the minimum zoom of the source. 4347 * 4348 * @param obj The map object. 4349 * @return Returns the minimum zoom of the source. 4350 * 4351 * @see elm_map_zoom_min_set() for details. 4352 * 4353 * @deprecated Use elm_map_zoom_min_get() instead 4354 */ 4355 EINA_DEPRECATED EAPI int elm_map_source_zoom_min_get(const Evas_Object *obj); 4356 4357 /** 4358 * Set the maximum zoom of the source. 4359 * 4360 * @param obj The map object. 4361 * @param zoom New maximum zoom value to be used. 4362 * 4363 * By default, it's 18. 4364 * 4365 * @deprecated Use elm_map_zoom_max_set() instead 4366 */ 4367 EINA_DEPRECATED EAPI void elm_map_source_zoom_max_set(Evas_Object *obj, int zoom); 4368 4369 /** 4370 * Get the maximum zoom of the source. 4371 * 4372 * @param obj The map object. 4373 * @return Returns the maximum zoom of the source. 4374 * 4375 * @see elm_map_zoom_min_set() for details. 4376 * 4377 * @deprecated Use elm_map_zoom_max_get() instead 4378 */ 4379 EINA_DEPRECATED EAPI int elm_map_source_zoom_max_get(const Evas_Object *obj); 4380 4381 4382 /** 4383 * Get the list of available sources. 4384 * 4385 * @param obj The map object. 4386 * @return The source names list. 4387 * 4388 * It will provide a list with all available sources, that can be set as 4389 * current source with elm_map_source_name_set(), or get with 4390 * elm_map_source_name_get(). 4391 * 4392 * Available sources: 4393 * @li "Mapnik" 4394 * @li "Osmarender" 4395 * @li "CycleMap" 4396 * @li "Maplint" 4397 * 4398 * @see elm_map_source_name_set() for more details. 4399 * @see elm_map_source_name_get() 4400 * @deprecated Use elm_map_sources_get() instead 4401 * 4402 */ 4403 EINA_DEPRECATED EAPI const char **elm_map_source_names_get(const Evas_Object *obj); 4404 4405 /** 4406 * Set the source of the map. 4407 * 4408 * @param obj The map object. 4409 * @param source_name The source to be used. 4410 * 4411 * Map widget retrieves images that composes the map from a web service. 4412 * This web service can be set with this method. 4413 * 4414 * A different service can return a different maps with different 4415 * information and it can use different zoom values. 4416 * 4417 * The @p source_name need to match one of the names provided by 4418 * elm_map_source_names_get(). 4419 * 4420 * The current source can be get using elm_map_source_name_get(). 4421 * 4422 * @see elm_map_source_names_get() 4423 * @see elm_map_source_name_get() 4424 * @deprecated Use elm_map_source_set() instead 4425 * 4426 */ 4427 EINA_DEPRECATED EAPI void elm_map_source_name_set(Evas_Object *obj, const char *source_name); 4428 4429 /** 4430 * Get the name of currently used source. 4431 * 4432 * @param obj The map object. 4433 * @return Returns the name of the source in use. 4434 * 4435 * @see elm_map_source_name_set() for more details. 4436 * @deprecated Use elm_map_source_get() instead 4437 * 4438 */ 4439 EINA_DEPRECATED EAPI const char *elm_map_source_name_get(const Evas_Object *obj); 4440 4441 /** 4442 * Set the source of the route service to be used by the map. 4443 * 4444 * @param obj The map object. 4445 * @param source The route service to be used, being it one of 4446 * #ELM_MAP_ROUTE_SOURCE_YOURS (default), #ELM_MAP_ROUTE_SOURCE_MONAV, 4447 * and #ELM_MAP_ROUTE_SOURCE_ORS. 4448 * 4449 * Each one has its own algorithm, so the route retrieved may 4450 * differ depending on the source route. Now, only the default is working. 4451 * 4452 * #ELM_MAP_ROUTE_SOURCE_YOURS is the routing service provided at 4453 * http://www.yournavigation.org/. 4454 * 4455 * #ELM_MAP_ROUTE_SOURCE_MONAV, offers exact routing without heuristic 4456 * assumptions. Its routing core is based on Contraction Hierarchies. 4457 * 4458 * #ELM_MAP_ROUTE_SOURCE_ORS, is provided at http://www.openrouteservice.org/ 4459 * 4460 * @see elm_map_route_source_get(). 4461 * @deprecated Use elm_map_source_set() instead 4462 * 4463 */ 4464 EINA_DEPRECATED EAPI void elm_map_route_source_set(Evas_Object *obj, Elm_Map_Route_Sources source); 4465 4466 /** 4467 * Get the current route source. 4468 * 4469 * @param obj The map object. 4470 * @return The source of the route service used by the map. 4471 * 4472 * @see elm_map_route_source_set() for details. 4473 * @deprecated Use elm_map_source_get() instead 4474 * 4475 */ 4476 EINA_DEPRECATED EAPI Elm_Map_Route_Sources elm_map_route_source_get(const Evas_Object *obj); 4477 4478 /** 4479 * Set the maximum numbers of markers' content to be displayed in a group. 4480 * 4481 * @param obj The map object. 4482 * @param max The maximum numbers of items displayed in a bubble. 4483 * 4484 * A bubble will be displayed when the user clicks over the group, 4485 * and will place the content of markers that belong to this group 4486 * inside it. 4487 * 4488 * A group can have a long list of markers, consequently the creation 4489 * of the content of the bubble can be very slow. 4490 * 4491 * In order to avoid this, a maximum number of items is displayed 4492 * in a bubble. 4493 * 4494 * By default this number is 30. 4495 * 4496 * Marker with the same group class are grouped if they are close. 4497 * 4498 * @see elm_map_marker_add() 4499 * 4500 * @deprecated Use Elm_Map_Overlay instead 4501 */ 4502 EINA_DEPRECATED EAPI void elm_map_max_marker_per_group_set(Evas_Object *obj, int max); 4503 4504 /** 4505 * Set to show markers during zoom level changes or not. 4506 * 4507 * @param obj The map object. 4508 * @param paused Use @c EINA_TRUE to @b not show markers or @c EINA_FALSE 4509 * to show them. 4510 * 4511 * This sets the paused state to on (@c EINA_TRUE) or off (@c EINA_FALSE) 4512 * for map. 4513 * 4514 * The default is off. 4515 * 4516 * This will stop zooming using animation, changing zoom levels will 4517 * change instantly. This will stop any existing animations that are running. 4518 * 4519 * This sets the paused state to on (@c EINA_TRUE) or off (@c EINA_FALSE) 4520 * for the markers. 4521 * 4522 * The default is off. 4523 * 4524 * Enabling it will force the map to stop displaying the markers during 4525 * zoom level changes. Set to on if you have a large number of markers. 4526 * 4527 * @see elm_map_paused_markers_get() 4528 * 4529 * @deprecated Use Elm_Map_Overlay instead 4530 */ 4531 EINA_DEPRECATED EAPI void elm_map_paused_markers_set(Evas_Object *obj, Eina_Bool paused); 4532 4533 /** 4534 * Get a value whether markers will be displayed on zoom level changes or not 4535 * 4536 * @param obj The map object. 4537 * @return @c EINA_TRUE means map @b won't display markers or @c EINA_FALSE 4538 * indicates it will. 4539 * 4540 * This gets the current markers paused state for the map object. 4541 * 4542 * @see elm_map_paused_markers_set() for details. 4543 * 4544 * @deprecated Use Elm_Map_Overlay instead 4545 */ 4546 EINA_DEPRECATED EAPI Eina_Bool elm_map_paused_markers_get(const Evas_Object *obj); 4547 4548 /** 4549 * Close all the bubbles opened by the user. 4550 * 4551 * @param obj The map object. 4552 * 4553 * A bubble is displayed with a content fetched with #Elm_Map_Marker_Get_Func 4554 * when the user clicks on a marker. 4555 * 4556 * This functions is set for the marker class with 4557 * elm_map_marker_class_get_cb_set(). 4558 * 4559 * @deprecated Use Elm_Map_Overlay instead 4560 */ 4561 EINA_DEPRECATED EAPI void elm_map_bubbles_close(Evas_Object *obj); 4562 4563 /** 4564 * Set the marker's style of a group class. 4565 * 4566 * @param clas The group class. 4567 * @param style The style to be used by markers. 4568 * 4569 * Each marker must be associated to a group class, and will use the style 4570 * defined by such class when grouped to other markers. 4571 * 4572 * The following styles are provided by default theme: 4573 * @li @c radio - blue circle 4574 * @li @c radio2 - green circle 4575 * @li @c empty 4576 * 4577 * @see elm_map_group_class_new() for more details. 4578 * @see elm_map_marker_add() 4579 * 4580 * @deprecated Use Elm_Map_Overlay instead 4581 */ 4582 EINA_DEPRECATED EAPI void elm_map_group_class_style_set(Elm_Map_Group_Class *clas, const char *style); 4583 4584 /** 4585 * Set the icon callback function of a group class. 4586 * 4587 * @param clas The group class. 4588 * @param icon_get The callback function that will return the icon. 4589 * 4590 * Each marker must be associated to a group class, and it can display a 4591 * custom icon. The function @p icon_get must return this icon. 4592 * 4593 * @see elm_map_group_class_new() for more details. 4594 * @see elm_map_marker_add() 4595 * 4596 * @deprecated Use Elm_Map_Overlay instead 4597 */ 4598 EINA_DEPRECATED EAPI void elm_map_group_class_icon_cb_set(Elm_Map_Group_Class *clas, Elm_Map_Group_Icon_Get_Func icon_get); 4599 4600 /** 4601 * Set the data associated to the group class. 4602 * 4603 * @param clas The group class. 4604 * @param data The new user data. 4605 * 4606 * This data will be passed for callback functions, like icon get callback, 4607 * that can be set with elm_map_group_class_icon_cb_set(). 4608 * 4609 * If a data was previously set, the object will lose the pointer for it, 4610 * so if needs to be freed, you must do it yourself. 4611 * 4612 * @see elm_map_group_class_new() for more details. 4613 * @see elm_map_group_class_icon_cb_set() 4614 * @see elm_map_marker_add() 4615 * 4616 * @deprecated Use Elm_Map_Overlay instead 4617 */ 4618 EINA_DEPRECATED EAPI void elm_map_group_class_data_set(Elm_Map_Group_Class *clas, void *data); 4619 4620 /** 4621 * Set the minimum zoom from where the markers are displayed. 4622 * 4623 * @param clas The group class. 4624 * @param zoom The minimum zoom. 4625 * 4626 * Markers only will be displayed when the map is displayed at @p zoom 4627 * or bigger. 4628 * 4629 * @see elm_map_group_class_new() for more details. 4630 * @see elm_map_marker_add() 4631 * 4632 * @deprecated Use Elm_Map_Overlay instead 4633 */ 4634 EINA_DEPRECATED EAPI void elm_map_group_class_zoom_displayed_set(Elm_Map_Group_Class *clas, int zoom); 4635 4636 /** 4637 * Set the zoom from where the markers are no more grouped. 4638 * 4639 * @param clas The group class. 4640 * @param zoom The maximum zoom. 4641 * 4642 * Markers only will be grouped when the map is displayed at 4643 * less than @p zoom. 4644 * 4645 * @see elm_map_group_class_new() for more details. 4646 * @see elm_map_marker_add() 4647 * 4648 * @deprecated Use Elm_Map_Overlay instead 4649 */ 4650 EINA_DEPRECATED EAPI void elm_map_group_class_zoom_grouped_set(Elm_Map_Group_Class *clas, int zoom); 4651 4652 /** 4653 * Set if the markers associated to the group class @p clas are hidden or not. 4654 * 4655 * @param clas The group class. 4656 * @param hide Use @c EINA_TRUE to hide markers or @c EINA_FALSE 4657 * to show them. 4658 * 4659 * @param obj The map object. 4660 * If @p hide is @c EINA_TRUE the markers will be hidden, but default 4661 * is to show them. 4662 * 4663 * @deprecated Use Elm_Map_Overlay instead 4664 */ 4665 EINA_DEPRECATED EAPI void elm_map_group_class_hide_set(Evas_Object *obj, Elm_Map_Group_Class *clas, Eina_Bool hide); 4666 4667 /** 4668 * Set the marker's style of a marker class. 4669 * 4670 * @param clas The marker class. 4671 * @param style The style to be used by markers. 4672 * 4673 * Each marker must be associated to a marker class, and will use the style 4674 * defined by such class when alone, i.e., @b not grouped to other markers. 4675 * 4676 * The following styles are provided by default theme: 4677 * @li @c radio 4678 * @li @c radio2 4679 * @li @c empty 4680 * 4681 * @see elm_map_marker_class_new() for more details. 4682 * @see elm_map_marker_add() 4683 * 4684 * @deprecated Use Elm_Map_Overlay instead 4685 */ 4686 EINA_DEPRECATED EAPI void elm_map_marker_class_style_set(Elm_Map_Marker_Class *clas, const char *style); 4687 4688 /** 4689 * Set the icon callback function of a marker class. 4690 * 4691 * @param clas The marker class. 4692 * @param icon_get The callback function that will return the icon. 4693 * 4694 * Each marker must be associated to a marker class, and it can display a 4695 * custom icon. The function @p icon_get must return this icon. 4696 * 4697 * @see elm_map_marker_class_new() for more details. 4698 * @see elm_map_marker_add() 4699 * 4700 * @deprecated Use Elm_Map_Overlay instead 4701 */ 4702 EINA_DEPRECATED EAPI void elm_map_marker_class_icon_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Icon_Get_Func icon_get); 4703 4704 /** 4705 * Set the bubble content callback function of a marker class. 4706 * 4707 * @param clas The marker class. 4708 * @param get The callback function that will return the content. 4709 * 4710 * Each marker must be associated to a marker class, and it can display a 4711 * a content on a bubble that opens when the user click over the marker. 4712 * The function @p get must return this content object. 4713 * 4714 * If this content will need to be deleted, elm_map_marker_class_del_cb_set() 4715 * can be used. 4716 * 4717 * @see elm_map_marker_class_new() for more details. 4718 * @see elm_map_marker_class_del_cb_set() 4719 * @see elm_map_marker_add() 4720 * 4721 * @deprecated Use Elm_Map_Overlay instead 4722 */ 4723 EINA_DEPRECATED EAPI void elm_map_marker_class_get_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Get_Func get); 4724 4725 /** 4726 * Set the callback function used to delete bubble content of a marker class. 4727 * 4728 * @param clas The marker class. 4729 * @param del The callback function that will delete the content. 4730 * 4731 * Each marker must be associated to a marker class, and it can display a 4732 * a content on a bubble that opens when the user click over the marker. 4733 * The function to return such content can be set with 4734 * elm_map_marker_class_get_cb_set(). 4735 * 4736 * If this content must be freed, a callback function need to be 4737 * set for that task with this function. 4738 * 4739 * If this callback is defined it will have to delete (or not) the 4740 * object inside, but if the callback is not defined the object will be 4741 * destroyed with evas_object_del(). 4742 * 4743 * @see elm_map_marker_class_new() for more details. 4744 * @see elm_map_marker_class_get_cb_set() 4745 * @see elm_map_marker_add() 4746 * 4747 * @deprecated Use Elm_Map_Overlay instead 4748 */ 4749 EINA_DEPRECATED EAPI void elm_map_marker_class_del_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Del_Func del); 4750 4751 /** 4752 * Set the route color. 4753 * 4754 * @param route The route object. 4755 * @param r Red channel value, from 0 to 255. 4756 * @param g Green channel value, from 0 to 255. 4757 * @param b Blue channel value, from 0 to 255. 4758 * @param a Alpha channel value, from 0 to 255. 4759 * 4760 * It uses an additive color model, so each color channel represents 4761 * how much of each primary colors must to be used. 0 represents 4762 * absence of this color, so if all of the three are set to 0, 4763 * the color will be black. 4764 * 4765 * These component values should be integers in the range 0 to 255, 4766 * (single 8-bit byte). 4767 * 4768 * This sets the color used for the route. By default, it is set to 4769 * solid red (r = 255, g = 0, b = 0, a = 255). 4770 * 4771 * For alpha channel, 0 represents completely transparent, and 255, opaque. 4772 * 4773 * @see elm_map_route_color_get() 4774 * @deprecated Use elm_map_overlay_color_set() instead 4775 * 4776 */ 4777 EINA_DEPRECATED EAPI void elm_map_route_color_set(Elm_Map_Route *route, int r, int g, int b, int a); 4778 4779 /** 4780 * Get the route color. 4781 * 4782 * @param route The route object. 4783 * @param r Pointer to store the red channel value. 4784 * @param g Pointer to store the green channel value. 4785 * @param b Pointer to store the blue channel value. 4786 * @param a Pointer to store the alpha channel value. 4787 * 4788 * @see elm_map_route_color_set() for details. 4789 * @deprecated Use elm_map_overlay_color_get() instead 4790 * 4791 */ 4792 EINA_DEPRECATED EAPI void elm_map_route_color_get(const Elm_Map_Route *route, int *r, int *g, int *b, int *a); 4793 4794 /** 4795 * Remove a name from the map. 4796 * 4797 * @param name The name to remove. 4798 * 4799 * Basically the struct handled by @p name will be freed, so conversions 4800 * between address and coordinates will be lost. 4801 * 4802 * @see elm_map_utils_convert_name_into_coord() 4803 * @see elm_map_utils_convert_coord_into_name() 4804 * @deprecated Use elm_map_name_del() instead 4805 * 4806 */ 4807 EINA_DEPRECATED EAPI void elm_map_name_remove(Elm_Map_Name *name); 4808 4809 /** 4810 * Get the gengrid object's handle which contains a given gengrid item 4811 * 4812 * @param it The item to fetch the container from 4813 * @return The gengrid (parent) object 4814 * 4815 * This returns the gengrid object itself that an item belongs to. 4816 * 4817 * @deprecated Use elm_object_item_widget_get() instead 4818 */ 4819 EINA_DEPRECATED EAPI Evas_Object *elm_gengrid_item_gengrid_get(const Elm_Object_Item *it); 4820 4821 /** 4822 * Return the data associated to a given gengrid item 4823 * 4824 * @param it The gengrid item. 4825 * @return the data associated with this item. 4826 * 4827 * This returns the @c data value passed on the 4828 * elm_gengrid_item_append() and related item addition calls. 4829 * 4830 * @see elm_gengrid_item_append() 4831 * @see elm_gengrid_item_data_set() 4832 * @deprecated Use elm_object_item_data_get() instead 4833 */ 4834 EINA_DEPRECATED EAPI void *elm_gengrid_item_data_get(const Elm_Object_Item *it); 4835 4836 /** 4837 * Set the data associated with a given gengrid item 4838 * 4839 * @param it The gengrid item 4840 * @param data The data pointer to set on it 4841 * 4842 * This @b overrides the @c data value passed on the 4843 * elm_gengrid_item_append() and related item addition calls. This 4844 * function @b won't call elm_gengrid_item_update() automatically, 4845 * so you'd issue it afterwards if you want to have the item 4846 * updated to reflect the new data. 4847 * 4848 * @see elm_gengrid_item_data_get() 4849 * @see elm_gengrid_item_update() 4850 * @deprecated Use elm_object_item_data_set() instead 4851 * 4852 */ 4853 EINA_DEPRECATED EAPI void elm_gengrid_item_data_set(Elm_Object_Item *it, const void *data); 4854 4855 /** 4856 * Set whether a given gengrid item is disabled or not. 4857 * 4858 * @param it The gengrid item 4859 * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE 4860 * to enable it back. 4861 * 4862 * A disabled item cannot be selected or unselected. It will also 4863 * change its appearance, to signal the user it's disabled. 4864 * 4865 * @see elm_gengrid_item_disabled_get() 4866 * @deprecated Use elm_object_item_disabled_set() instead 4867 * 4868 */ 4869 EINA_DEPRECATED EAPI void elm_gengrid_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled); 4870 4871 /** 4872 * Get whether a given gengrid item is disabled or not. 4873 * 4874 * @param it The gengrid item 4875 * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise 4876 * (and on errors). 4877 * 4878 * @see elm_gengrid_item_disabled_set() for more details 4879 * @deprecated Use elm_object_item_disabled_get() instead 4880 * 4881 */ 4882 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_item_disabled_get(const Elm_Object_Item *it); 4883 4884 /** 4885 * Remove a gengrid item from its parent, deleting it. 4886 * 4887 * @param it The item to be removed. 4888 * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise. 4889 * 4890 * @see elm_gengrid_clear(), to remove all items in a gengrid at 4891 * once. 4892 * @deprecated use elm_object_item_de() instead 4893 * 4894 */ 4895 EINA_DEPRECATED EAPI void elm_gengrid_item_del(Elm_Object_Item *it); 4896 4897 /** 4898 * Update the item class of a gengrid item. 4899 * 4900 * This sets another class of the item, changing the way that it is 4901 * displayed. After changing the item class, elm_gengrid_item_update() is 4902 * called on the item @p it. 4903 * 4904 * @param it The gengrid item 4905 * @param gic The gengrid item class describing the function pointers and the item style. 4906 * 4907 * @deprecated Use elm_gengrid_item_item_class_update instead 4908 */ 4909 EINA_DEPRECATED EAPI void elm_gengrid_item_item_class_set(Elm_Object_Item *it, const Elm_Gengrid_Item_Class *gic); 4910 4911 /** 4912 * Insert an item in a gengrid widget using a user-defined sort function. 4913 * 4914 * @param obj The gengrid object. 4915 * @param gic The item class for the item. 4916 * @param data The item data. 4917 * @param comp User defined comparison function that defines the sort order 4918 * based on Elm_Gen_Item. 4919 * @param func Convenience function called when the item is selected. 4920 * @param func_data Data to be passed to @p func. 4921 * @return A handle to the item added or @c NULL, on errors. 4922 * 4923 * This inserts an item in the gengrid based on user defined comparison function. 4924 * 4925 * @see elm_gengrid_item_append() 4926 * @see elm_gengrid_item_prepend() 4927 * @see elm_gengrid_item_insert_after() 4928 * @see elm_object_item_del() 4929 * @see elm_gengrid_item_sorted_insert() 4930 * 4931 * @deprecated Use elm_gengrid_item_sorted_insert() instead 4932 */ 4933 EINA_DEPRECATED EAPI Elm_Object_Item *elm_gengrid_item_direct_sorted_insert(Evas_Object *obj, const Elm_Gengrid_Item_Class *gic, const void *data, Eina_Compare_Cb comp, Evas_Smart_Cb func, const void *func_data); 4934 4935 /** 4936 * Append a filter function for text inserted in the entry 4937 * 4938 * Append the given callback to the list. This functions will be called 4939 * whenever any text is inserted into the entry, with the text to be inserted 4940 * as a parameter. The callback function is free to alter the text in any way 4941 * it wants, but it must remember to free the given pointer and update it. 4942 * If the new text is to be discarded, the function can free it and set its 4943 * text parameter to NULL. This will also prevent any following filters from 4944 * being called. 4945 * 4946 * @param obj The entry object 4947 * @param func The function to use as text filter 4948 * @param data User data to pass to @p func 4949 * @deprecated use elm_entry_markup_filter_append() instead 4950 */ 4951 EINA_DEPRECATED EAPI void elm_entry_text_filter_append(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data); 4952 4953 /** 4954 * Prepend a filter function for text inserted in the entry 4955 * 4956 * Prepend the given callback to the list. See elm_entry_text_filter_append() 4957 * for more information 4958 * 4959 * @param obj The entry object 4960 * @param func The function to use as text filter 4961 * @param data User data to pass to @p func 4962 * @deprecated use elm_entry_markup_filter_prepend() instead 4963 */ 4964 EINA_DEPRECATED EAPI void elm_entry_text_filter_prepend(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data); 4965 4966 /** 4967 * Remove a filter from the list 4968 * 4969 * Removes the given callback from the filter list. See 4970 * elm_entry_text_filter_append() for more information. 4971 * 4972 * @param obj The entry object 4973 * @param func The filter function to remove 4974 * @param data The user data passed when adding the function 4975 * @deprecated use elm_entry_markup_filter_remove() instead 4976 */ 4977 EINA_DEPRECATED EAPI void elm_entry_text_filter_remove(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data); 4978 4979 /** 4980 * @brief Set the front content of the flip widget. 4981 * 4982 * @param obj The flip object 4983 * @param content The new front content object 4984 * 4985 * Once the content object is set, a previously set one will be deleted. 4986 * If you want to keep that old content object, use the 4987 * elm_flip_content_front_unset() function. 4988 * 4989 * @deprecated Use elm_object_part_content_set(flip, "front") instead 4990 */ 4991 EINA_DEPRECATED EAPI void elm_flip_content_front_set(Evas_Object *obj, Evas_Object *content); 4992 4993 /** 4994 * @brief Set the back content of the flip widget. 4995 * 4996 * @param obj The flip object 4997 * @param content The new back content object 4998 * 4999 * Once the content object is set, a previously set one will be deleted. 5000 * If you want to keep that old content object, use the 5001 * elm_flip_content_back_unset() function. 5002 * 5003 * @deprecated Use elm_object_part_content_set(flip, "back") instead 5004 */ 5005 EINA_DEPRECATED EAPI void elm_flip_content_back_set(Evas_Object *obj, Evas_Object *content); 5006 5007 /** 5008 * @brief Get the front content used for the flip 5009 * 5010 * @param obj The flip object 5011 * @return The front content object that is being used 5012 * 5013 * Return the front content object which is set for this widget. 5014 * 5015 * @deprecated Use elm_object_part_content_get(flip, "front") instead 5016 */ 5017 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_front_get(const Evas_Object *obj); 5018 5019 /** 5020 * @brief Get the back content used for the flip 5021 * 5022 * @param obj The flip object 5023 * @return The back content object that is being used 5024 * 5025 * Return the back content object which is set for this widget. 5026 * 5027 * @deprecated Use elm_object_part_content_get(flip, "back") instead 5028 */ 5029 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_back_get(const Evas_Object *obj); 5030 5031 /** 5032 * @brief Unset the front content used for the flip 5033 * 5034 * @param obj The flip object 5035 * @return The front content object that was being used 5036 * 5037 * Unparent and return the front content object which was set for this widget. 5038 * 5039 * @deprecated Use elm_object_part_content_unset(flip, "front") instead 5040 */ 5041 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_front_unset(Evas_Object *obj); 5042 5043 /** 5044 * @brief Unset the back content used for the flip 5045 * 5046 * @param obj The flip object 5047 * @return The back content object that was being used 5048 * 5049 * Unparent and return the back content object which was set for this widget. 5050 * 5051 * @deprecated Use elm_object_part_content_unset(flip, "back") instead 5052 */ 5053 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_back_unset(Evas_Object *obj); 5054 5055 /** 5056 * @brief Get flip front visibility state 5057 * 5058 * @param obj The flip object 5059 * @return EINA_TRUE if front front is showing, EINA_FALSE if the back is 5060 * showing. 5061 * 5062 * @deprecated Use elm_flip_front_visible_get() instead 5063 */ 5064 EINA_DEPRECATED EAPI Eina_Bool elm_flip_front_get(const Evas_Object *obj); 5065 5066 /** 5067 * @brief Set the font size on the label object. 5068 * 5069 * @param obj The label object 5070 * @param size font size 5071 * 5072 * @warning NEVER use this. It is for hyper-special cases only. use styles 5073 * instead. e.g. "default", "marker", "slide_long" etc. 5074 * @deprecated Use <font_size> tag instead. eg) <font_size=40>abc</font_size> 5075 */ 5076 EINA_DEPRECATED EAPI void elm_label_fontsize_set(Evas_Object *obj, int fontsize); 5077 5078 /** 5079 * @brief Set the text color on the label object 5080 * 5081 * @param obj The label object 5082 * @param r Red property background color of The label object 5083 * @param g Green property background color of The label object 5084 * @param b Blue property background color of The label object 5085 * @param a Alpha property background color of The label object 5086 * 5087 * @warning NEVER use this. It is for hyper-special cases only. use styles 5088 * instead. e.g. "default", "marker", "slide_long" etc. 5089 * @deprecated Use <color> tag instead. about <color> tag - Text color in one of the following formats: "#RRGGBB", "#RRGGBBAA", "#RGB", and "#RGBA" 5090 */ 5091 EINA_DEPRECATED EAPI void elm_label_text_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a); 5092 5093 /** 5094 * @brief Set the text align on the label object 5095 * 5096 * @param obj The label object 5097 * @param align align mode ("left", "center", "right") 5098 * 5099 * @warning NEVER use this. It is for hyper-special cases only. use styles 5100 * instead. e.g. "default", "marker", "slide_long" etc. 5101 * @deprecated Use <align> tag instead. about <align> tag - Either "auto" (meaning according to text direction), "left", "right", "center", "middle", a value between 0.0 and 1.0, or a value between 0% to 100%. 5102 */ 5103 EINA_DEPRECATED EAPI void elm_label_text_align_set(Evas_Object *obj, const char *alignmode); 5104 5105 /** 5106 * @brief Set background color of the label 5107 * 5108 * @param obj The label object 5109 * @param r Red property background color of The label object 5110 * @param g Green property background color of The label object 5111 * @param b Blue property background color of The label object 5112 * @param a Alpha property background alpha of The label object 5113 * 5114 * @warning NEVER use this. It is for hyper-special cases only. use styles 5115 * instead. e.g. "default", "marker", "slide_long" etc. 5116 * @deprecated Just make colored background by yourself. 5117 */ 5118 EINA_DEPRECATED EAPI void elm_label_background_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a); 5119 5120 /** 5121 * @brief Set wrap height of the label 5122 * 5123 * @param obj The label object 5124 * @param h The wrap height in pixels at a minimum where words need to wrap 5125 * 5126 * This function sets the maximum height size hint of the label. 5127 * 5128 * @warning This is only relevant if the label is inside a container. 5129 * @deprecated This function should not be used because of wrong concept. 5130 */ 5131 EINA_DEPRECATED EAPI void elm_label_wrap_height_set(Evas_Object *obj, Evas_Coord h); 5132 5133 /** 5134 * @brief get wrap width of the label 5135 * 5136 * @param obj The label object 5137 * @return The wrap height in pixels at a minimum where words need to wrap 5138 * @deprecated This function should not be used because of wrong concept. 5139 */ 5140 EINA_DEPRECATED EAPI Evas_Coord elm_label_wrap_height_get(const Evas_Object *obj); 5141 5142 /** 5143 * @brief Flush all caches. 5144 * 5145 * Frees all data that was in cache and is not currently being used to reduce 5146 * memory usage. This frees Edje's, Evas' and Eet's cache. This is equivalent 5147 * to calling all of the following functions: 5148 * @li edje_file_cache_flush() 5149 * @li edje_collection_cache_flush() 5150 * @li eet_clearcache() 5151 * @li evas_image_cache_flush() 5152 * @li evas_font_cache_flush() 5153 * @li evas_render_dump() 5154 * @note Evas caches are flushed for every canvas associated with a window. 5155 * @deprecated Use elm_cache_all_flush() instead. 5156 */ 5157 EINA_DEPRECATED EAPI void elm_all_flush(void); 5158 5159 5160 /** 5161 * @brief Define the uri that will be the video source. 5162 * 5163 * @param video The video object to define the file for. 5164 * @param uri The uri to target. 5165 * 5166 * This function will define an uri as a source for the video of the 5167 * Elm_Video object. URI could be remote source of video, like http:// or local 5168 * like for example WebCam who are most of the time v4l2:// (but that depend an 5169 * you should use Emotion API to request and list the available Webcam on your 5170 * 5171 * @deprecated Use elm_video_file_set() instead. 5172 * 5173 */ 5174 EINA_DEPRECATED EAPI void elm_video_uri_set(Evas_Object *video, const char *uri); 5175 5176 /** 5177 * @brief Get the region of the image that is currently shown 5178 * 5179 * @param obj 5180 * @param x A pointer to the X-coordinate of region 5181 * @param y A pointer to the Y-coordinate of region 5182 * @param w A pointer to the width 5183 * @param h A pointer to the height 5184 * 5185 * @deprecated Use elm_photocam_image_region_get() instead. 5186 */ 5187 EINA_DEPRECATED EAPI void elm_photocam_region_get(const Evas_Object *obj, int *x, int *y, int *w, int *h); 5188 5189 /** 5190 * @brief Set the gesture state for photocam. 5191 * 5192 * @param obj The photocam object 5193 * @param gesture The gesture state to set 5194 * 5195 * This sets the gesture state to on(EINA_TRUE) or off (EINA_FALSE) for 5196 * photocam. The default is off. This will start multi touch zooming. 5197 * 5198 * @deprecated Use elm_photocam_gesture_enabled_set() instead. 5199 */ 5200 EINA_DEPRECATED EAPI void elm_photocam_gesture_set(Evas_Object *obj, Eina_Bool gesture); 5201 5202 /** 5203 * @brief Get the gesture state for photocam. 5204 * 5205 * @param obj The photocam object 5206 * @return The current gesture state 5207 * 5208 * This gets the current gesture state for the photocam object. 5209 * 5210 * @deprecated Use elm_photocam_gesture_enabled_get() instead. 5211 */ 5212 EINA_DEPRECATED EAPI Eina_Bool elm_photocam_gesture_get(const Evas_Object *obj); 5213 /* No documentation for these API before. 5214 * 5215 * @deprecated Use elm_route_latitude_min_max_get() 5216 * elm_route_longitude_min_max_get() 5217 * instead. 5218 */ 5219 EINA_DEPRECATED EAPI double elm_route_lon_min_get(Evas_Object *obj); 5220 EINA_DEPRECATED EAPI double elm_route_lat_min_get(Evas_Object *obj); 5221 EINA_DEPRECATED EAPI double elm_route_lon_max_get(Evas_Object *obj); 5222 EINA_DEPRECATED EAPI double elm_route_lat_max_get(Evas_Object *obj); 5223 5224 5225 /** 5226 * Get the duration after which tooltip will be shown. 5227 * 5228 * @return Duration after which tooltip will be shown. 5229 * @deprecated Use elm_config_tooltip_delay_get(void); 5230 */ 5231 EINA_DEPRECATED EAPI double elm_tooltip_delay_get(void); 5232 5233 /** 5234 * Set the duration after which tooltip will be shown. 5235 * 5236 * @return EINA_TRUE if value is set. 5237 * @deprecated Use elm_config_tooltip_delay_set(double delay); 5238 */ 5239 EINA_DEPRECATED EAPI Eina_Bool elm_tooltip_delay_set(double delay); 5240 5241 /** 5242 * Set the corner of the bubble 5243 * 5244 * @param obj The bubble object. 5245 * @param corner The given corner for the bubble. 5246 * 5247 * @deprecated Use elm_bubble_pos_set() 5248 * 5249 */ 5250 EINA_DEPRECATED EAPI void elm_bubble_corner_set(Evas_Object *obj, const char *corner); 5251 5252 /** 5253 * Get the corner of the bubble 5254 * 5255 * @param obj The bubble object. 5256 * @return The given corner for the bubble. 5257 * 5258 * @deprecated Use elm_bubble_pos_get() 5259 */ 5260 EINA_DEPRECATED EAPI const char *elm_bubble_corner_get(const Evas_Object *obj); 5261 5262 /** 5263 * Enable or disable day selection 5264 * 5265 * @param obj The calendar object. 5266 * @param enabled @c EINA_TRUE to enable selection or @c EINA_FALSE to 5267 * disable it. 5268 * 5269 * @deprecated Use elm_calendar_day_selection_disabled_set() 5270 */ 5271 EINA_DEPRECATED EAPI void elm_calendar_day_selection_enabled_set(Evas_Object *obj, Eina_Bool enabled); 5272 5273 /** 5274 * Get a value whether day selection is enabled or not. 5275 * 5276 * @param obj The calendar object. 5277 * @return EINA_TRUE means day selection is enabled. EINA_FALSE indicates 5278 * it's disabled. If @p obj is NULL, EINA_FALSE is returned. 5279 * 5280 * @deprecated elm_calendar_day_selection_disabled_get() 5281 */ 5282 EINA_DEPRECATED EAPI Eina_Bool elm_calendar_day_selection_enabled_get(const Evas_Object *obj); 5283 5284 /** 5285 * @deprecated Use Elm_Calendar_Mark_Repeat_Type instead. 5286 */ 5287 typedef _Elm_Calendar_Mark_Repeat_Type Elm_Calendar_Mark_Repeat EINA_DEPRECATED; 5288 5289 /** 5290 * Get the configured font cache size 5291 * 5292 * This gets the globally configured font cache size, in bytes. 5293 * 5294 * @return The font cache size 5295 * @deprecated elm_cache_font_cache_size_get(void); 5296 */ 5297 EINA_DEPRECATED EAPI int elm_font_cache_get(void); 5298 5299 /** 5300 * Set the configured font cache size 5301 * 5302 * This sets the globally configured font cache size, in bytes 5303 * 5304 * @param size The font cache size 5305 * @deprecated elm_cache_font_cache_size_set(int size); 5306 */ 5307 EINA_DEPRECATED EAPI void elm_font_cache_set(int size); 5308 5309 /** 5310 * Get the configured image cache size 5311 * 5312 * This gets the globally configured image cache size, in bytes 5313 * 5314 * @return The image cache size 5315 */ 5316 EINA_DEPRECATED EAPI int elm_image_cache_get(void); 5317 EINA_DEPRECATED EAPI int elm_cache_image_cache_size_get(void); 5318 5319 /** 5320 * Set the configured image cache size 5321 * 5322 * This sets the globally configured image cache size, in bytes 5323 * 5324 * @param size The image cache size 5325 * @deprecated Use elm_cache_image_cache_size_set(int size); 5326 */ 5327 EINA_DEPRECATED EAPI void elm_image_cache_set(int size); 5328 5329 5330 /** 5331 * Get the configured edje file cache size. 5332 * 5333 * This gets the globally configured edje file cache size, in number 5334 * of files. 5335 * 5336 * @return The edje file cache size 5337 * @deprecated Use elm_cache_edje_file_cache_size_get(void); 5338 */ 5339 EINA_DEPRECATED EAPI int elm_edje_file_cache_get(void); 5340 5341 /** 5342 * Set the configured edje file cache size 5343 * 5344 * This sets the globally configured edje file cache size, in number 5345 * of files. 5346 * 5347 * @param size The edje file cache size 5348 * @deprecated Use elm_cache_edje_file_cache_size_get(int size); 5349 */ 5350 EINA_DEPRECATED EAPI void elm_edje_file_cache_set(int size); 5351 5352 /** 5353 * Get the configured edje collections (groups) cache size. 5354 * 5355 * This gets the globally configured edje collections cache size, in 5356 * number of collections. 5357 * 5358 * @return The edje collections cache size 5359 * @deprecated Use elm_cache_edje_collection_cache_size_get(void); 5360 */ 5361 EINA_DEPRECATED EAPI int elm_edje_collection_cache_get(void); 5362 5363 /** 5364 * Set the configured edje collections (groups) cache size 5365 * 5366 * This sets the globally configured edje collections cache size, in 5367 * number of collections. 5368 * 5369 * @param size The edje collections cache size 5370 * @deprecated elm_cache_edje_collection_cache_size_set(int size); 5371 */ 5372 EINA_DEPRECATED EAPI void elm_edje_collection_cache_set(int size); 5373 5374 /** 5375 * Get whether browsing history is enabled for the given object 5376 * 5377 * @param obj The web object 5378 * 5379 * @return EINA_TRUE if history is enabled, EINA_FALSE otherwise 5380 * 5381 * @deprecated Use elm_web_history_enabled_get() 5382 */ 5383 EINA_DEPRECATED EAPI Eina_Bool elm_web_history_enable_get(const Evas_Object *obj); 5384 5385 /** 5386 * Enables or disables the browsing history 5387 * 5388 * @param obj The web object 5389 * @param enable Whether to enable or disable the browsing history 5390 * 5391 * @deprecated Use elm_web_history_enabled_set() 5392 * 5393 */ 5394 EINA_DEPRECATED EAPI void elm_web_history_enable_set(Evas_Object *obj, Eina_Bool enable); 5395 5396 /** 5397 * @brief Add an object swallowed in an item at the end of the given menu 5398 * widget 5399 * 5400 * @param obj The menu object. 5401 * @param parent The parent menu item (optional) 5402 * @param subobj The object to swallow 5403 * @param func Function called when the user select the item. 5404 * @param data Data sent by the callback. 5405 * @return Returns the new item. 5406 * 5407 * Add an evas object as an item to the menu. 5408 * @deprecated please use "elm_menu_item_add" + "elm_object_item_content_set" instead. 5409 */ 5410 EINA_DEPRECATED EAPI Elm_Object_Item *elm_menu_item_add_object(Evas_Object *obj, Elm_Object_Item *parent, Evas_Object *subobj, Evas_Smart_Cb func, const void *data); 5411 5412 /** 5413 * @brief Sets whether events should be passed to by a click outside 5414 * its area. 5415 * 5416 * @param obj The notify object 5417 * @param repeat EINA_TRUE Events are repeats, else no 5418 * 5419 * When true if the user clicks outside the window the events will be caught 5420 * by the others widgets, else the events are blocked. 5421 * 5422 * @note The default value is EINA_TRUE. 5423 * @deprecated Please use elm_notify_allow_events_set() instead 5424 */ 5425 EINA_DEPRECATED EAPI void elm_notify_repeat_events_set(Evas_Object *obj, Eina_Bool repeat); 5426 5427 /** 5428 * @brief Return true if events are repeat below the notify object 5429 * @param obj the notify object 5430 * 5431 * @see elm_notify_repeat_events_set() 5432 * @deprecated Please use elm_notify_allow_events_get() instead 5433 */ 5434 EINA_DEPRECATED EAPI Eina_Bool elm_notify_repeat_events_get(const Evas_Object *obj); 5435 5436 /** 5437 * Set if the cursor set should be searched on the theme or should use 5438 * the provided by the engine, only. 5439 * 5440 * @param obj an object with cursor already set. 5441 * @param engine_only boolean to define if cursors should be looked only 5442 * between the provided by the engine or searched on widget's theme as well. 5443 * 5444 * @deprecated Use elm_object_cursor_theme_search_enabled_set() 5445 */ 5446 EINA_DEPRECATED EAPI void elm_object_cursor_engine_only_set(Evas_Object *obj, Eina_Bool engine_only); 5447 5448 /** 5449 * Get the cursor engine only usage for this object cursor. 5450 * 5451 * @param obj an object with cursor already set. 5452 * @return engine_only boolean to define it cursors should be 5453 * looked only between the provided by the engine or searched on 5454 * widget's theme as well. If the object does not have a cursor 5455 * set, then EINA_FALSE is returned. 5456 * 5457 * @deprecated Use elm_object_cursor_theme_search_enabled_get(); 5458 */ 5459 EINA_DEPRECATED EAPI Eina_Bool elm_object_cursor_engine_only_get(const Evas_Object *obj); 5460 5461 /** 5462 * Go to a given items level on a index widget 5463 * 5464 * @param obj The index object 5465 * @param level The index level (one of @c 0 or @c 1) 5466 * 5467 * @deprecated please use "elm_index_level_go" instead. 5468 */ 5469 EINA_DEPRECATED EAPI void elm_index_item_go(Evas_Object *obj, int level); 5470 5471 /** 5472 * Enable or disable auto hiding feature for a given index widget. 5473 * 5474 * @param obj The index object 5475 * @param active @c EINA_TRUE to enable auto hiding, @c EINA_FALSE to disable 5476 * 5477 * @see elm_index_active_get() 5478 * 5479 * @deprecated please use "elm_index_autohide_disabled_set" instead. 5480 */ 5481 EINA_DEPRECATED EAPI void elm_index_active_set(Evas_Object *obj, Eina_Bool active); 5482 5483 /** 5484 * Get whether auto hiding feature is enabled or not for a given index widget. 5485 * 5486 * @param obj The index object 5487 * @return @c EINA_TRUE, if auto hiding is enabled, @c EINA_FALSE otherwise 5488 * 5489 * @see elm_index_active_set() for more details 5490 * 5491 * @deprecated please use "elm_index_autohide_disabled_get" instead. 5492 */ 5493 EINA_DEPRECATED EAPI Eina_Bool elm_index_active_get(const Evas_Object *obj); 5494 5495 /** 5496 * Append a new item, on a given index widget, <b>after the item 5497 * having @p relative as data</b>. 5498 * 5499 * @param obj The index object. 5500 * @param letter Letter under which the item should be indexed 5501 * @param item The item data to set for the index's item 5502 * @param relative The index item to be the predecessor of this new one 5503 * @return A handle to the item added or @c NULL, on errors 5504 * 5505 * Despite the most common usage of the @p letter argument is for 5506 * single char strings, one could use arbitrary strings as index 5507 * entries. 5508 * 5509 * @c item will be the pointer returned back on @c "changed", @c 5510 * "delay,changed" and @c "selected" smart events. 5511 * 5512 * @note If @p relative is @c NULL this function will behave as 5513 * elm_index_item_append(). 5514 * 5515 * @deprecated please use "elm_index_item_insert_after" instead. 5516 */ 5517 EINA_DEPRECATED EAPI Elm_Object_Item *elm_index_item_append_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative); 5518 5519 /** 5520 * Prepend a new item, on a given index widget, <b>after the item 5521 * having @p relative as data</b>. 5522 * 5523 * @param obj The index object. 5524 * @param letter Letter under which the item should be indexed 5525 * @param item The item data to set for the index's item 5526 * @param relative The index item to be the successor of this new one 5527 * @return A handle to the item added or @c NULL, on errors 5528 * 5529 * Despite the most common usage of the @p letter argument is for 5530 * single char strings, one could use arbitrary strings as index 5531 * entries. 5532 * 5533 * @c item will be the pointer returned back on @c "changed", @c 5534 * "delay,changed" and @c "selected" smart events. 5535 * 5536 * @note If @p relative is @c NULL this function will behave as 5537 * elm_index_item_prepend(). 5538 * 5539 * @deprecated please use "elm_index_item_insert_before" instead. 5540 */ 5541 EINA_DEPRECATED EAPI Elm_Object_Item *elm_index_item_prepend_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative); 5542 5543 /** 5544 * Set the transparency state of a window. 5545 * 5546 * Use elm_win_alpha_set() instead. 5547 * 5548 * @param obj The window object 5549 * @param transparent If true, the window is transparent 5550 * 5551 * @see elm_win_alpha_set() 5552 * @deprecated Please use elm_win_alpha_set() 5553 */ 5554 EINA_DEPRECATED EAPI void elm_win_transparent_set(Evas_Object *obj, Eina_Bool transparent); 5555 5556 /** 5557 * Get the transparency state of a window. 5558 * 5559 * @param obj The window object 5560 * @return If true, the window is transparent 5561 * 5562 * @see elm_win_transparent_set() 5563 * @deprecated Please use elm_win_alpha_get() 5564 */ 5565 EINA_DEPRECATED EAPI Eina_Bool elm_win_transparent_get(const Evas_Object *obj); 5566 5567 /** 5568 * Set the theme for all elementary using applications on the current display 5569 * 5570 * @param theme The name of the theme to use. Format same as the ELM_THEME 5571 * environment variable. 5572 * @deprecated Use elm_theme_set(NULL, theme); elm_config_all_flush(); instead. 5573 */ 5574 EINA_DEPRECATED EAPI void elm_theme_all_set(const char *theme); 5575 5576 /** 5577 * Returns the Evas_Object that represents the content area. 5578 * 5579 * @param obj The conformant object. 5580 * @return The content area of the widget. 5581 * 5582 */ 5583 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_area_get(const Evas_Object *obj); 5584 5585 /** 5586 * Set if the object is (up/down) resizable. 5587 * 5588 * @param obj The image object 5589 * @param scale_up A bool to set if the object is resizable up. Default is 5590 * @c EINA_TRUE. 5591 * @param scale_down A bool to set if the object is resizable down. Default 5592 * is @c EINA_TRUE. 5593 * 5594 * This function limits the image resize ability. If @p scale_up is set to 5595 * @c EINA_FALSE, the object can't have its height or width resized to a value 5596 * higher than the original image size. Same is valid for @p scale_down. 5597 * 5598 * @see elm_image_scale_get() 5599 * @deprecated Please use elm_image_resizable_set() 5600 * 5601 */ 5602 EINA_DEPRECATED EAPI void elm_image_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down); 5603 5604 /** 5605 * Get if the object is (up/down) resizable. 5606 * 5607 * @param obj The image object 5608 * @param scale_up A bool to set if the object is resizable up 5609 * @param scale_down A bool to set if the object is resizable down 5610 * 5611 * @see elm_image_scale_set() 5612 * @deprecated Please use elm_image_resizable_get() 5613 * 5614 */ 5615 EINA_DEPRECATED EAPI void elm_image_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down); 5616 5617 /** 5618 * Set if the object is (up/down) resizable. 5619 * 5620 * @param obj The icon object 5621 * @param scale_up A bool to set if the object is resizable up. Default is 5622 * @c EINA_TRUE. 5623 * @param scale_down A bool to set if the object is resizable down. Default 5624 * is @c EINA_TRUE. 5625 * 5626 * This function limits the icon object resize ability. If @p scale_up is set to 5627 * @c EINA_FALSE, the object can't have its height or width resized to a value 5628 * higher than the original icon size. Same is valid for @p scale_down. 5629 * 5630 * @see elm_icon_scale_get() 5631 * @deprecated Please use elm_icon_resizable_set() 5632 * 5633 */ 5634 EINA_DEPRECATED EAPI void elm_icon_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down); 5635 5636 /** 5637 * Get if the object is (up/down) resizable. 5638 * 5639 * @param obj The icon object 5640 * @param scale_up A bool to set if the object is resizable up 5641 * @param scale_down A bool to set if the object is resizable down 5642 * 5643 * @see elm_icon_scale_set() 5644 * @deprecated Please use elm_icon_resizable_get() 5645 * 5646 */ 5647 EINA_DEPRECATED EAPI void elm_icon_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down); 5648 5649 /** 5650 * Enable or disable preloading of the icon 5651 * 5652 * @param obj The icon object 5653 * @param disable If EINA_TRUE, preloading will be disabled 5654 * @deprecated Use elm_icon_preload_disabled_set() instead 5655 */ 5656 EINA_DEPRECATED EAPI void elm_icon_preload_set(Evas_Object *obj, Eina_Bool disable); 5657 5658 /** 5659 * Returns the last selected item, for a given index widget. 5660 * 5661 * @param obj The index object. 5662 * @return The last item @b selected on @p obj (or @c NULL, on errors). 5663 * @deprecated Please use elm_index_selected_item_get() instead. 5664 * 5665 * 5666 */ 5667 EINA_DEPRECATED EAPI Elm_Object_Item *elm_index_item_selected_get(const Evas_Object *obj, int level); 5668 5669 /** 5670 * Get the value of shrink_mode state. 5671 * 5672 * @deprecated elm_multibuttonentry_expanded_get() 5673 */ 5674 EINA_DEPRECATED EAPI int elm_multibuttonentry_shrink_mode_get(const Evas_Object *obj); 5675 5676 /** 5677 * Set/Unset the multibuttonentry to shrink mode state of single line 5678 * 5679 * @deprecated elm_multibuttonentry_expanded_set() 5680 */ 5681 EINA_DEPRECATED EAPI void elm_multibuttonentry_shrink_mode_set(Evas_Object *obj, int shrink_mode); 5682 5683 /** 5684 * Get the guide text 5685 * 5686 * @param obj The multibuttonentry object 5687 * @return The guide text, or NULL if none 5688 * 5689 * @deprecated Please use elm_object_part_text_get(obj, "guide"); 5690 */ 5691 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_guide_text_get(const Evas_Object *obj); 5692 5693 /** 5694 * Set the guide text 5695 * 5696 * @param obj The multibuttonentry object 5697 * @param guidetext The guide text string 5698 * 5699 * @deprecated Please use elm_object_part_text_set(obj, "guide", guidetext); 5700 */ 5701 EINA_DEPRECATED EAPI void elm_multibuttonentry_guide_text_set(Evas_Object *obj, const char *guidetext); 5702 5703 /** 5704 * Make the elementary object and its children to be unfocusable 5705 * (or focusable). 5706 * 5707 * @param obj The Elementary object to operate on 5708 * @param tree_unfocusable @c EINA_TRUE for unfocusable, 5709 * @c EINA_FALSE for focusable. 5710 * 5711 * This sets whether the object @p obj and its children objects 5712 * are able to take focus or not. If the tree is set as unfocusable, 5713 * newest focused object which is not in this tree will get focus. 5714 * This API can be helpful for an object to be deleted. 5715 * When an object will be deleted soon, it and its children may not 5716 * want to get focus (by focus reverting or by other focus controls). 5717 * Then, just use this API before deleting. 5718 * 5719 * @see elm_object_tree_unfocusable_get() 5720 * 5721 * @deprecated Please use elm_object_tree_unfocusable_set() 5722 */ 5723 EINA_DEPRECATED EAPI void elm_object_tree_unfocusable_set(Evas_Object *obj, Eina_Bool tree_unfocusable); 5724 5725 /** 5726 * Get whether an Elementary object and its children are unfocusable or not. 5727 * 5728 * @param obj The Elementary object to get the information from 5729 * @return @c EINA_TRUE, if the tree is unfocussable, 5730 * @c EINA_FALSE if not (and on errors). 5731 * 5732 * @see elm_object_tree_unfocusable_set() 5733 * 5734 * @deprecated Please use elm_object_tree_unfocusable_get() 5735 */ 5736 EINA_DEPRECATED EAPI Eina_Bool elm_object_tree_unfocusable_get(const Evas_Object *obj); 5737 5738 /** 5739 * Animatedly bring in, to the visible are of a genlist, a given 5740 * item on it. 5741 * 5742 * @deprecated elm_genlist_item_bring_in() 5743 */ 5744 EINA_DEPRECATED EAPI void elm_genlist_item_top_bring_in(Elm_Object_Item *it); 5745 5746 /** 5747 * Animatedly bring in, to the visible are of a genlist, a given 5748 * item on it. 5749 * 5750 * @deprecated elm_genlist_item_bring_in() 5751 */ 5752 EINA_DEPRECATED EAPI void elm_genlist_item_middle_bring_in(Elm_Object_Item *it); 5753 5754 /** 5755 * Show the portion of a genlist's internal list containing a given 5756 * item, immediately. 5757 * 5758 * @param it The item to display 5759 * 5760 * @deprecated elm_genlist_item_show() 5761 * 5762 */ 5763 EINA_DEPRECATED EAPI void elm_genlist_item_top_show(Elm_Object_Item *it); 5764 5765 /** 5766 * Show the portion of a genlist's internal list containing a given 5767 * item, immediately. 5768 * 5769 * @param it The item to display 5770 * 5771 * @deprecated elm_genlist_item_show() 5772 * 5773 */ 5774 EINA_DEPRECATED EAPI void elm_genlist_item_middle_show(Elm_Object_Item *it); 5775 5776 /** 5777 * Enable or disable round mode. 5778 * 5779 * @param obj The diskselector object. 5780 * @param round @c EINA_TRUE to enable round mode or @c EINA_FALSE to 5781 * disable it. 5782 * 5783 * Disabled by default. If round mode is enabled the items list will 5784 * work like a circle list, so when the user reaches the last item, 5785 * the first one will popup. 5786 * 5787 * @see elm_diskselector_round_enabled_get() 5788 * 5789 * @deprecated elm_diskselector_round_enabled_set() 5790 */ 5791 EINA_DEPRECATED EAPI void elm_diskselector_round_set(Evas_Object *obj, Eina_Bool round); 5792 5793 /** 5794 * Set whether items on a given gengrid widget are to get their 5795 * selection callbacks issued for @b every subsequent selection 5796 * click on them or just for the first click. 5797 * 5798 * @param obj The gengrid object 5799 * @param always_select @c EINA_TRUE to make items "always 5800 * selected", @c EINA_FALSE, otherwise 5801 * 5802 * By default, grid items will only call their selection callback 5803 * function when firstly getting selected, any subsequent further 5804 * clicks will do nothing. With this call, you make those 5805 * subsequent clicks also to issue the selection callbacks. 5806 * 5807 * @note <b>Double clicks</b> will @b always be reported on items. 5808 * 5809 * @see elm_gengrid_always_select_mode_get() 5810 * 5811 */ 5812 EINA_DEPRECATED EAPI void elm_gengrid_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select); 5813 5814 /** 5815 * Get whether items on a given gengrid widget have their selection 5816 * callbacks issued for @b every subsequent selection click on them 5817 * or just for the first click. 5818 * 5819 * @param obj The gengrid object. 5820 * @return @c EINA_TRUE if the gengrid items are "always selected", 5821 * @c EINA_FALSE, otherwise 5822 * 5823 * @see elm_gengrid_always_select_mode_set() for more details 5824 * 5825 */ 5826 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_always_select_mode_get(const Evas_Object *obj); 5827 5828 /** 5829 * Set whether items on a given gengrid widget can be selected or not. 5830 * 5831 * @param obj The gengrid object 5832 * @param no_select @c EINA_TRUE to make items selectable, 5833 * @c EINA_FALSE otherwise 5834 * 5835 * This will make items in @p obj selectable or not. In the latter 5836 * case, any user interaction on the gengrid items will neither make 5837 * them appear selected nor them call their selection callback 5838 * functions. 5839 * 5840 * @see elm_gengrid_no_select_mode_get() 5841 * 5842 */ 5843 EINA_DEPRECATED EAPI void elm_gengrid_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select); 5844 5845 /** 5846 * Get whether items on a given gengrid widget can be selected or 5847 * not. 5848 * 5849 * @param obj The gengrid object 5850 * @return @c EINA_TRUE, if items are selectable, @c EINA_FALSE 5851 * otherwise 5852 * 5853 * @see elm_gengrid_no_select_mode_set() for more details 5854 * 5855 */ 5856 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_no_select_mode_get(const Evas_Object *obj); 5857 5858 /** 5859 * Get the side labels max length. 5860 * 5861 * @see elm_diskselector_side_text_max_length_set() for details. 5862 * 5863 * @param obj The diskselector object. 5864 * @return The max length defined for side labels, or 0 if not a valid 5865 * diskselector. 5866 * 5867 * @deprecated elm_diskselector_side_text_max_length_get() 5868 */ 5869 EINA_DEPRECATED EAPI int elm_diskselector_side_label_length_get(const Evas_Object *obj); 5870 5871 /** 5872 * Set the side labels max length. 5873 * 5874 * @param obj The diskselector object. 5875 * @param len The max length defined for side labels. 5876 * 5877 * Length is the number of characters of items' label that will be 5878 * visible when it's set on side positions. It will just crop 5879 * the string after defined size. E.g.: 5880 * 5881 * An item with label "January" would be displayed on side position as 5882 * "Jan" if max length is set to 3, or "Janu", if this property 5883 * is set to 4. 5884 * 5885 * When it's selected, the entire label will be displayed, except for 5886 * width restrictions. In this case label will be cropped and "..." 5887 * will be concatenated. 5888 * 5889 * Default side label max length is 3. 5890 * 5891 * This property will be applied over all items, included before or 5892 * later this function call. 5893 * 5894 * @deprecated elm_diskselector_side_text_max_length_set() 5895 */ 5896 EINA_DEPRECATED EAPI void elm_diskselector_side_label_length_set(Evas_Object *obj, int len); 5897 5898 /** 5899 * Set whether the toolbar should always have an item selected. 5900 * 5901 * @param obj The toolbar object. 5902 * @param always_select @c EINA_TRUE to enable always-select mode or @c EINA_FALSE to 5903 * disable it. 5904 * 5905 * This will cause the toolbar to always have an item selected, and clicking 5906 * the selected item will not cause a selected event to be emitted. Enabling this mode 5907 * will immediately select the first toolbar item. 5908 * 5909 * Always-selected is disabled by default. 5910 * 5911 * @see elm_toolbar_always_select_mode_get(). 5912 * 5913 * @ingroup Elm_Toolbar 5914 */ 5915 EINA_DEPRECATED EAPI void elm_toolbar_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select); 5916 5917 /** 5918 * Get whether the toolbar should always have an item selected. 5919 * 5920 * @param obj The toolbar object. 5921 * @return @c EINA_TRUE means an item will always be selected, @c EINA_FALSE indicates 5922 * that it is possible to have no items selected. If @p obj is @c NULL, @c EINA_FALSE is returned. 5923 * 5924 * @see elm_toolbar_always_select_mode_set() for details. 5925 * 5926 * @ingroup Elm_Toolbar 5927 */ 5928 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_always_select_mode_get(const Evas_Object *obj); 5929 5930 /** 5931 * Set whether the toolbar items' should be selected by the user or not. 5932 * 5933 * @param obj The toolbar object. 5934 * @param no_select @c EINA_TRUE to disable selection or @c EINA_FALSE to 5935 * enable it. 5936 * 5937 * This will turn off the ability to select items entirely and they will 5938 * neither appear selected nor emit selected signals. The clicked 5939 * callback function will still be called. 5940 * 5941 * Selection is enabled by default. 5942 * 5943 * @see elm_toolbar_no_select_mode_get(). 5944 * 5945 * @ingroup Elm_Toolbar 5946 */ 5947 EINA_DEPRECATED EAPI void elm_toolbar_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select); 5948 5949 /** 5950 * Set whether the toolbar items' should be selected by the user or not. 5951 * 5952 * @param obj The toolbar object. 5953 * @return @c EINA_TRUE means items can be selected. @c EINA_FALSE indicates 5954 * they can't. If @p obj is @c NULL, @c EINA_FALSE is returned. 5955 * 5956 * @see elm_toolbar_no_select_mode_set() for details. 5957 * 5958 * @ingroup Elm_Toolbar 5959 */ 5960 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_no_select_mode_get(const Evas_Object *obj); 5961 5962 /* 5963 * Set the interval on time updates for a user mouse button hold 5964 * on clock widgets' time edition. 5965 * 5966 * @param obj The clock object 5967 * @param interval The (first) interval value in seconds 5968 * 5969 * This interval value is @b decreased while the user holds the 5970 * mouse pointer either incrementing or decrementing a given the 5971 * clock digit's value. 5972 * 5973 * This helps the user to get to a given time distant from the 5974 * current one easier/faster, as it will start to flip quicker and 5975 * quicker on mouse button holds. 5976 * 5977 * The calculation for the next flip interval value, starting from 5978 * the one set with this call, is the previous interval divided by 5979 * 1.05, so it decreases a little bit. 5980 * 5981 * The default starting interval value for automatic flips is 5982 * @b 0.85 seconds. 5983 * 5984 * @deprecated elm_clock_first_interval_set() 5985 * 5986 */ 5987 EINA_DEPRECATED EAPI void elm_clock_interval_set(Evas_Object *obj, double interval); 5988 5989 /** 5990 * Get the interval on time updates for a user mouse button hold 5991 * on clock widgets' time edition. 5992 * 5993 * @param obj The clock object 5994 * @return The (first) interval value, in seconds, set on it 5995 * 5996 * @elm_clock_first_interval_get() 5997 */ 5998 EINA_DEPRECATED EAPI double elm_clock_interval_get(const Evas_Object *obj); 5999 6000 /** 6001 * Set what digits of the given clock widget should be editable 6002 * when in edition mode. 6003 * 6004 * @param obj The clock object 6005 * @param digedit Bit mask indicating the digits to be editable 6006 * (values in #Elm_Clock_Edit_Mode). 6007 * 6008 * If the @p digedit param is #ELM_CLOCK_NONE, editing will be 6009 * disabled on @p obj (same effect as elm_clock_edit_set(), with @c 6010 * EINA_FALSE). 6011 * 6012 * @deprecated elm_clock_edit_mode_set() 6013 */ 6014 EINA_DEPRECATED EAPI void elm_clock_digit_edit_set(Evas_Object *obj, Elm_Clock_Edit_Mode digedit); 6015 6016 /** 6017 * Get what digits of the given clock widget should be 6018 * editable when in edition mode. 6019 * 6020 * @param obj The clock object 6021 * @return Bit mask indicating the digits to be editable 6022 * (values in #Elm_Clock_Edit_Mode). 6023 * 6024 * @deprecated elm_clock_edit_mode_get() 6025 */ 6026 EINA_DEPRECATED EAPI Elm_Clock_Edit_Mode elm_clock_digit_edit_get(const Evas_Object *obj); 6027 6028 /* 6029 * Queries whether it's possible to go back in history 6030 * 6031 * @param obj The web object 6032 * 6033 * @return EINA_TRUE if it's possible to back in history, EINA_FALSE 6034 * otherwise 6035 * @deprecated elm_web_back_possible_get(); 6036 */ 6037 EINA_DEPRECATED EAPI Eina_Bool elm_web_backward_possible(Evas_Object *obj); 6038 6039 /** 6040 * Queries whether it's possible to go forward in history 6041 * 6042 * @param obj The web object 6043 * 6044 * @return EINA_TRUE if it's possible to forward in history, EINA_FALSE 6045 * otherwise 6046 * 6047 * @deprecated elm_web_forward_possible_get(); 6048 */ 6049 EINA_DEPRECATED EAPI Eina_Bool elm_web_forward_possible(Evas_Object *obj); 6050 6051 /** 6052 * Queries whether it's possible to jump the given number of steps 6053 * 6054 * @deprecated elm_web_navigate_possible_get(); 6055 * 6056 */ 6057 EINA_DEPRECATED EAPI Eina_Bool elm_web_navigate_possible(Evas_Object *obj, int steps); 6058 6059 /** 6060 * @brief Set the content of the scroller widget (the object to be scrolled around). 6061 * 6062 * @param obj The scroller object 6063 * @param content The new content object 6064 * 6065 * Once the content object is set, a previously set one will be deleted. 6066 * If you want to keep that old content object, use the 6067 * elm_scroller_content_unset() function. 6068 * @deprecated use elm_object_content_set() instead 6069 */ 6070 EINA_DEPRECATED EAPI void elm_scroller_content_set(Evas_Object *obj, Evas_Object *child); 6071 6072 /** 6073 * @brief Get the content of the scroller widget 6074 * 6075 * @param obj The slider object 6076 * @return The content that is being used 6077 * 6078 * Return the content object which is set for this widget 6079 * 6080 * @see elm_scroller_content_set() 6081 * @deprecated use elm_object_content_get() instead. 6082 */ 6083 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_get(const Evas_Object *obj); 6084 6085 /** 6086 * @brief Unset the content of the scroller widget 6087 * 6088 * @param obj The slider object 6089 * @return The content that was being used 6090 * 6091 * Unparent and return the content object which was set for this widget 6092 * 6093 * @see elm_scroller_content_set() 6094 * @deprecated use elm_object_content_unset() instead. 6095 */ 6096 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_unset(Evas_Object *obj); 6097 6098 /** 6099 * Set the shrink state of toolbar @p obj. 6100 * 6101 * @param obj The toolbar object. 6102 * @param shrink_mode Toolbar's items display behavior. 6103 * 6104 * The toolbar won't scroll if #ELM_TOOLBAR_SHRINK_NONE, 6105 * but will enforce a minimum size so all the items will fit, won't scroll 6106 * and won't show the items that don't fit if #ELM_TOOLBAR_SHRINK_HIDE, 6107 * will scroll if #ELM_TOOLBAR_SHRINK_SCROLL, and will create a button to 6108 * pop up excess elements with #ELM_TOOLBAR_SHRINK_MENU. 6109 * 6110 * @deprecated Please use elm_toolbar_shrink_mode_set(obj, shrink_mode); 6111 */ 6112 EINA_DEPRECATED EAPI void elm_toolbar_mode_shrink_set(Evas_Object *obj, Elm_Toolbar_Shrink_Mode shrink_mode); 6113 6114 /** 6115 * Get the shrink mode of toolbar @p obj. 6116 * 6117 * @param obj The toolbar object. 6118 * @return Toolbar's items display behavior. 6119 * 6120 * @see elm_toolbar_shrink_mode_set() for details. 6121 * 6122 * @deprecated Please use elm_toolbar_shrink_mode_get(obj); 6123 */ 6124 EINA_DEPRECATED EAPI Elm_Toolbar_Shrink_Mode elm_toolbar_mode_shrink_get(const Evas_Object *obj); 6125 6126 /** 6127 * Set the text to be shown in a given toolbar item's tooltips. 6128 * 6129 * @param it toolbar item. 6130 * @param text The text to set in the content. 6131 * 6132 * Setup the text as tooltip to object. The item can have only one tooltip, 6133 * so any previous tooltip data - set with this function or 6134 * elm_toolbar_item_tooltip_content_cb_set() - is removed. 6135 * 6136 * @deprecated Use elm_object_item_tooltip_text_set() instead 6137 * @see elm_object_tooltip_text_set() for more details. 6138 * 6139 */ 6140 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_text_set(Elm_Object_Item *it, const char *text); 6141 6142 /** 6143 * Enable or disable always select mode on the list object. 6144 * 6145 * @param obj The list object 6146 * @param always_select @c EINA_TRUE to enable always select mode or 6147 * @c EINA_FALSE to disable it. 6148 * 6149 * @note Always select mode is disabled by default. 6150 * 6151 * Default behavior of list items is to only call its callback function 6152 * the first time it's pressed, i.e., when it is selected. If a selected 6153 * item is pressed again, and multi-select is disabled, it won't call 6154 * this function (if multi-select is enabled it will unselect the item). 6155 * 6156 * If always select is enabled, it will call the callback function 6157 * every time a item is pressed, so it will call when the item is selected, 6158 * and again when a selected item is pressed. 6159 * 6160 * @deprecated elm_list_always_select_mode_set() 6161 */ 6162 EINA_DEPRECATED EAPI void elm_list_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select); 6163 6164 /** 6165 * Get a value whether always select mode is enabled or not, meaning that 6166 * an item will always call its callback function, even if already selected. 6167 * 6168 * @param obj The list object 6169 * @return @c EINA_TRUE means horizontal mode selection is enabled. 6170 * @c EINA_FALSE indicates it's disabled. If @p obj is @c NULL, 6171 * @c EINA_FALSE is returned. 6172 * 6173 * @see elm_list_always_select_mode_set() for details. 6174 * 6175 * @deprecated elm_list_always_select_mode_get() 6176 */ 6177 EINA_DEPRECATED EAPI Eina_Bool elm_list_always_select_mode_get(const Evas_Object *obj); 6178 6179 /** 6180 * Get the real Evas object created to implement the view of a 6181 * given genlist item 6182 * 6183 * @param it The genlist item. 6184 * @return the Evas object implementing this item's view. 6185 * 6186 * This returns the actual Evas object used to implement the 6187 * specified genlist item's view. This may be @c NULL, as it may 6188 * not have been created or may have been deleted, at any time, by 6189 * the genlist. <b>Do not modify this object</b> (move, resize, 6190 * show, hide, etc.), as the genlist is controlling it. This 6191 * function is for querying, emitting custom signals or hooking 6192 * lower level callbacks for events on that object. Do not delete 6193 * this object under any circumstances. 6194 * 6195 * @see elm_object_item_data_get() 6196 * @deprecated No more support. If you need to emit signal to item's edje object, use elm_object_item_signal_emit(). 6197 * 6198 */ 6199 EINA_DEPRECATED EAPI const Evas_Object *elm_genlist_item_object_get(const Elm_Object_Item *it); 6200 6201 /** 6202 * Set the always select mode. 6203 * 6204 * @param obj The genlist object 6205 * @param always_select The always select mode (@c EINA_TRUE = on, @c 6206 * EINA_FALSE = off). Default is @c EINA_FALSE. 6207 * 6208 * Items will only call their selection func and callback when first 6209 * becoming selected. Any further clicks will do nothing, unless you 6210 * enable always select with elm_genlist_always_select_mode_set(). 6211 * This means that, even if selected, every click will make the selected 6212 * callbacks be called. 6213 * 6214 * @deprecated use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_ALWAYS); instead. use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_DEFAULT); for normal mode. 6215 * 6216 */ 6217 EINA_DEPRECATED EAPI void elm_genlist_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select); 6218 6219 6220 /** 6221 * Get the always select mode. 6222 * 6223 * @param obj The genlist object 6224 * @return The always select mode 6225 * (@c EINA_TRUE = on, @c EINA_FALSE = off) 6226 * 6227 * @deprecated use elm_genlist_select_mode_get instead. 6228 * 6229 */ 6230 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_always_select_mode_get(const Evas_Object *obj); 6231 6232 /** 6233 * Enable/disable the no select mode. 6234 * 6235 * @param obj The genlist object 6236 * @param no_select The no select mode 6237 * (EINA_TRUE = on, EINA_FALSE = off) 6238 * 6239 * This will turn off the ability to select items entirely and they 6240 * will neither appear selected nor call selected callback functions. 6241 * 6242 * @deprecated use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_NONE); instead. use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_DEFAULT); for normal mode. 6243 * 6244 */ 6245 EINA_DEPRECATED EAPI void elm_genlist_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select); 6246 6247 /** 6248 * Get whether the no select mode is enabled. 6249 * 6250 * @param obj The genlist object 6251 * @return The no select mode 6252 * (@c EINA_TRUE = on, @c EINA_FALSE = off) 6253 * 6254 * @deprecated use elm_genlist_select_mode_get instead. 6255 * 6256 */ 6257 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_no_select_mode_get(const Evas_Object *obj); 6258 6259 /* 6260 * Enable/disable compress mode. 6261 * 6262 * @param obj The genlist object 6263 * @param compress The compress mode 6264 * (@c EINA_TRUE = on, @c EINA_FALSE = off). Default is @c EINA_FALSE. 6265 * 6266 * This will enable the compress mode where items are "compressed" 6267 * horizontally to fit the genlist scrollable viewport width. This is 6268 * special for genlist. Do not rely on 6269 * elm_genlist_mode_set() being set to @c ELM_LIST_COMPRESS to 6270 * work as genlist needs to handle it specially. 6271 * 6272 * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS) 6273 */ 6274 EINA_DEPRECATED EAPI void elm_genlist_compress_mode_set(Evas_Object *obj, Eina_Bool compress); 6275 6276 /** 6277 * Sets the display only state of an item. 6278 * 6279 * @param it The item 6280 * @param display_only @c EINA_TRUE if the item is display only, @c 6281 * EINA_FALSE otherwise. 6282 * 6283 * A display only item cannot be selected or unselected. It is for 6284 * display only and not selecting or otherwise clicking, dragging 6285 * etc. by the user, thus finger size rules will not be applied to 6286 * this item. 6287 * 6288 * It's good to set group index items to display only state. 6289 * 6290 * @see elm_genlist_item_display_only_get() 6291 * 6292 * @deprecated elm_genlist_item_display_only_set() 6293 */ 6294 EINA_DEPRECATED EAPI void elm_genlist_item_display_only_set(Elm_Object_Item *it, Eina_Bool display_only); 6295 6296 /** 6297 * Get the display only state of an item 6298 * 6299 * @param it The item 6300 * @return @c EINA_TRUE if the item is display only, @c 6301 * EINA_FALSE otherwise. 6302 * 6303 * @see elm_genlist_item_display_only_set() 6304 * 6305 * @deprecated elm_genlist_item_display_only_get() 6306 */ 6307 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_item_display_only_get(const Elm_Object_Item *it); 6308 6309 /** 6310 * Get whether the compress mode is enabled. 6311 * 6312 * @param obj The genlist object 6313 * @return The compress mode 6314 * (@c EINA_TRUE = on, @c EINA_FALSE = off) 6315 * 6316 * @deprecated elm_genlsit_mode_get() 6317 */ 6318 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_compress_mode_get(const Evas_Object *obj); 6319 6320 /** 6321 * Enable/disable height-for-width mode. 6322 * 6323 * @param obj The genlist object 6324 * @param height_for_width The height-for-width mode (@c EINA_TRUE = on, 6325 * @c EINA_FALSE = off). Default is @c EINA_FALSE. 6326 * 6327 * With height-for-width mode the item width will be fixed (restricted 6328 * to a minimum of) to the list width when calculating its size in 6329 * order to allow the height to be calculated based on it. This allows, 6330 * for instance, text block to wrap lines if the Edje part is 6331 * configured with "text.min: 0 1". 6332 * 6333 * @note This mode will make list resize slower as it will have to 6334 * recalculate every item height again whenever the list width 6335 * changes! 6336 * 6337 * @note When height-for-width mode is enabled, it also enables 6338 * compress mode (see elm_genlist_compress_mode_set()) and 6339 * disables homogeneous (see elm_genlist_homogeneous_set()). 6340 * 6341 * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS) 6342 */ 6343 EINA_DEPRECATED EAPI void elm_genlist_height_for_width_mode_set(Evas_Object *obj, Eina_Bool height_for_width); 6344 6345 /** 6346 * Get whether the height-for-width mode is enabled. 6347 * 6348 * @param obj The genlist object 6349 * @return The height-for-width mode (@c EINA_TRUE = on, @c EINA_FALSE = 6350 * off) 6351 * 6352 * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS) 6353 */ 6354 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_height_for_width_mode_get(const Evas_Object *obj); 6355 6356 /** 6357 * Activate a genlist mode on an item 6358 * 6359 * @param it The genlist item 6360 * @param mode_type Mode name 6361 * @param mode_set Boolean to define set or unset mode. 6362 * 6363 * A genlist mode is a different way of selecting an item. Once a mode is 6364 * activated on an item, any other selected item is immediately unselected. 6365 * This feature provides an easy way of implementing a new kind of animation 6366 * for selecting an item, without having to entirely rewrite the item style 6367 * theme. However, the elm_genlist_selected_* API can't be used to get what 6368 * item is activate for a mode. 6369 * 6370 * The current item style will still be used, but applying a genlist mode to 6371 * an item will select it using a different kind of animation. 6372 * 6373 * The current active item for a mode can be found by 6374 * elm_genlist_decorated_item_get(). 6375 * 6376 * The characteristics of genlist mode are: 6377 * - Only one mode can be active at any time, and for only one item. 6378 * - Genlist handles deactivating other items when one item is activated. 6379 * - A mode is defined in the genlist theme (edc), and more modes can easily 6380 * be added. 6381 * - A mode style and the genlist item style are different things. They 6382 * can be combined to provide a default style to the item, with some kind 6383 * of animation for that item when the mode is activated. 6384 * 6385 * When a mode is activated on an item, a new view for that item is created. 6386 * The theme of this mode defines the animation that will be used to transit 6387 * the item from the old view to the new view. This second (new) view will be 6388 * active for that item while the mode is active on the item, and will be 6389 * destroyed after the mode is totally deactivated from that item. 6390 * 6391 * @deprecated elm_genlist_item_decorate_mode_set() 6392 */ 6393 EINA_DEPRECATED EAPI void elm_genlist_item_mode_set(Elm_Object_Item *it, const char *mode_type, Eina_Bool mode_set); 6394 6395 /** 6396 * Get the last (or current) genlist mode used. 6397 * 6398 * @param obj The genlist object 6399 * 6400 * This function just returns the name of the last used genlist mode. It will 6401 * be the current mode if it's still active. 6402 * 6403 * @deprecated elm_genlist_item_decorate_mode_get() 6404 */ 6405 EINA_DEPRECATED EAPI const char *elm_genlist_mode_type_get(const Evas_Object *obj); 6406 6407 /** 6408 * Get active genlist mode item 6409 * 6410 * @param obj The genlist object 6411 * @return The active item for that current mode. Or @c NULL if no item is 6412 * activated with any mode. 6413 * 6414 * This function returns the item that was activated with a mode, by the 6415 * function elm_genlist_item_decorate_mode_set(). 6416 * 6417 * @deprecated elm_genlist_decorated_item_get() 6418 */ 6419 EINA_DEPRECATED EAPI const Elm_Object_Item *elm_genlist_mode_item_get(const Evas_Object *obj); 6420 6421 /** 6422 * Set Genlist edit mode 6423 * 6424 * This sets Genlist edit mode. 6425 * 6426 * @param obj The Genlist object 6427 * @param The edit mode status 6428 * (EINA_TRUE = edit mode, EINA_FALSE = normal mode 6429 * 6430 * @deprecated elm_genlist_decorate_mode_set 6431 */ 6432 EINA_DEPRECATED EAPI void elm_genlist_edit_mode_set(Evas_Object *obj, Eina_Bool edit_mode); 6433 6434 /** 6435 * Get Genlist edit mode 6436 * 6437 * @param obj The genlist object 6438 * @return The edit mode status 6439 * (EINA_TRUE = edit mode, EINA_FALSE = normal mode 6440 * 6441 * @deprecated elm_genlist_decorate_mode_get() 6442 */ 6443 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_edit_mode_get(const Evas_Object *obj); 6444 6445 /** 6446 * @brief Notify the compositor that a uri should be preloaded 6447 * 6448 * @param[in] uri This is the uri to notify with 6449 * 6450 * @since 1.18 6451 * 6452 * @ingroup Efl_Ui_Win 6453 * @deprecated This is a possibly security issue and is non-portable outside enlightenment and there is no code to detect if it exists and even works, so better not to have this 6454 */ 6455 EINA_DEPRECATED EAPI void elm_win_teamwork_uri_preload(Efl_Ui_Win *obj, const char *uri); 6456 6457 /** 6458 * @brief Notify the compositor that a uri should be displayed 6459 * 6460 * Sends the current mouse coordinates as a hint for displaying the related uri 6461 * in the compositor. 6462 * 6463 * @param[in] uri This is the uri to notify with 6464 * 6465 * @since 1.18 6466 * 6467 * @ingroup Efl_Ui_Win 6468 * @deprecated This is a possibly security issue and is non-portable outside enlightenment and there is no code to detect if it exists and even works, so better not to have this 6469 */ 6470 EINA_DEPRECATED EAPI void elm_win_teamwork_uri_show(Efl_Ui_Win *obj, const char *uri); 6471 6472 /** 6473 * @brief Notify the compositor that a uri should be hidden 6474 * 6475 * Hides any uri-related media displayed in the compositor through previous 6476 * @ref elm_win_teamwork_uri_show request 6477 * 6478 * @since 1.18 6479 * 6480 * @ingroup Efl_Ui_Win 6481 * @deprecated This is a possibly security issue and is non-portable outside enlightenment and there is no code to detect if it exists and even works, so better not to have this 6482 */ 6483 EINA_DEPRECATED EAPI void elm_win_teamwork_uri_hide(Efl_Ui_Win *obj); 6484 6485 /** 6486 * @brief Notify the compositor that a uri should be opened 6487 * 6488 * Use the compositor's default application to open a uri 6489 * 6490 * @param[in] uri This is the uri to open 6491 * 6492 * @since 1.18 6493 * 6494 * @ingroup Efl_Ui_Win 6495 * @deprecated This is a possibly security issue and is non-portable outside enlightenment and there is no code to detect if it exists and even works, so better not to have this 6496 */ 6497 EINA_DEPRECATED EAPI void elm_win_teamwork_uri_open(Efl_Ui_Win *obj, const char *uri); 6498 6499 /** 6500 * @} 6501 */ 6502
