efl/legacy/elementary/src/lib/elm_label.eo

import elm_general;

enum Elm.Label.Slide_Mode
{
   [[
     @addtogroup Label
     Slide mode of a label widget
   ]]
   none = 0, [[No slide effect.]]
   auto, [[Slide only if the label area is bigger than the text width length.]]
   always [[Slide always.]]
}

class Elm.Label (Elm.Layout)
{
   eo_prefix: elm_obj_label;
   methods {
      @property wrap_width {
         set {
            /*@
            @brief Set wrap width of the label

            This function sets the maximum width size hint of the label.

            @warning This is only relevant if the label is inside a container.

            @ingroup Label */
         }
         get {
            /*@
            @brief Get wrap width of the label

            @return The wrap width in pixels at a minimum where words need to wrap

            @see elm_label_wrap_width_set()

            @ingroup Label */
         }
         values {
            w: Evas.Coord; /*@ The wrap width in pixels at a minimum where words need to wrap */
         }
      }
      @property slide_speed {
         set {
            /*@
            @brief Set the slide speed of the label

            @see elm_label_slide_duration_set()

            @ingroup Label */
         }
         get {
            /*@
            @brief Get the slide speed of the label

            @return The slide animation speed in px per seconds

            @note If you set the duration of the slide using elm_label_slide_duration_set()
            you cannot get the correct speed using this function until the label
            is actually rendered and resized.

            @see elm_label_slide_speed_set()

            @ingroup Label */
         }
         values {
            speed: double; /*@ The speed of the slide animation in px per seconds */
         }
      }
      @property slide_mode {
         set {
            /*@
            @brief Set the slide mode of the label widget.

            elm_label_slide_mode_set() changes label slide mode.
            By default, slide mode is none. Possible values for @p mode are:
            @li #ELM_LABEL_SLIDE_MODE_NONE - no slide effect
            @li #ELM_LABEL_SLIDE_MODE_AUTO - slide only if the label area is bigger than
            the text width length
            @li #ELM_LABEL_SLIDE_MODE_ALWAYS -slide always

            @warning #ELM_LABEL_SLIDE_MODE_AUTO, #ELM_LABEL_SLIDE_MODE_ALWAYS only work
            with the themes "slide_short", "slide_long" and "slide_bounce".
            @warning #ELM_LABEL_SLIDE_MODE_AUTO, #ELM_LABEL_SLIDE_MODE_ALWAYS don't work
            if the line wrap(elm_label_line_wrap_set()) or
            ellipsis(elm_label_ellipsis_set()) is set.

            @see elm_label_slide_mode_get().
            @since 1.8

            @ingroup Label */
         }
         get {
            /*@
            @brief Get the slide mode of the label widget.

            @return The slide mode

            @see elm_label_slide_mode_set()
            @since 1.8

            @ingroup Label */
         }
         values {
            mode: Elm.Label.Slide_Mode; /*@ The slide mode */
         }
      }
      @property slide_duration {
         set {
            /*@
            @brief Set the slide duration of the label

            @see elm_label_slide_speed_set()

            @ingroup Label */
         }
         get {
            /*@
            @brief Get the slide duration of the label

            @return The duration time in moving text from slide begin position to slide end position

            @note If you set the speed of the slide using elm_label_slide_speed_set()
            you cannot get the correct duration using this function until the label
            is actually rendered and resized.

            @see elm_label_slide_duration_set()

            @ingroup Label */
         }
         values {
            duration: double; /*@ The duration in seconds in moving text from slide begin position
            to slide end position */
         }
      }
      @property line_wrap {
         set {
            /*@
            @brief Set the wrapping behavior of the label

            By default no wrapping is done. Possible values for @p wrap are:
            @li #ELM_WRAP_NONE - No wrapping
            @li #ELM_WRAP_CHAR - wrap between characters
            @li #ELM_WRAP_WORD - wrap between words
            @li #ELM_WRAP_MIXED - Word wrap, and if that fails, char wrap

            @ingroup Label */
         }
         get {
            /*@
            @brief Get the wrapping behavior of the label

            @return Wrap type

            @see elm_label_line_wrap_set()

            @ingroup Label */
         }
         values {
            wrap: Elm.Wrap.Type; /*@ To wrap text or not */
         }
      }
      @property ellipsis {
         set {
            /*@
            @brief Set the ellipsis behavior of the label

            If set to true and the text doesn't fit in the label an ellipsis("...")
            will be shown at the end of the widget.

            @warning This doesn't work with slide(elm_label_slide_set()) or if the
            chosen wrap method was #ELM_WRAP_WORD.

            @ingroup Label */
         }
         get {
            /*@
            @brief Get the ellipsis behavior of the label

            @return If true, an ellipsis will be shown at the end of the label area.

            @see elm_label_ellipsis_set()

            @ingroup Label */
         }
         values {
            ellipsis: bool; /*@ To ellipsis text or not */
         }
      }
      slide_go {
         /*@
         @brief Start slide effect.

         @see elm_label_slide_mode_set()
         @since 1.8

         @ingroup Label */

      }
   }
   implements {
      class.constructor;
      Eo.Base.constructor;
      Evas.Object_Smart.add;
      Elm.Widget.focus_next_manager_is;
      Elm.Widget.focus_direction_manager_is;
      Elm.Widget.theme_apply;
      Elm.Layout.text_set;
      Elm.Layout.text_aliases.get;
      Elm.Layout.sizing_eval;
   }
   events {
      language,changed;
      access,changed;
      slide,end;
   }

}