Description

Hints for an object's alignment.

These are hints on how to align an object inside the boundaries of a container/manager. Accepted values are in the 0.0 to 1.0 range, with the special value Efl.Gfx.Size.Hint.Fill used to specify "justify" or "fill" by some users. In this case, maximum size hints should be enforced with higher priority, if they are set. Also, any padding hint set on objects should add up to the alignment space on the final scene composition.

See documentation of possible users: in Evas, they are the @ref Evas_Object_Box "box" and @ref Evas_Object_Table "table" smart objects.

For the horizontal component, 0.0 means to the left, 1.0 means to the right. Analogously, for the vertical component, 0.0 to the top, 1.0 means to the bottom.

This is not a size enforcement in any way, it's just a hint that should be used whenever appropriate.

Default alignment hint values are 0.5, for both axes.

Values

  • x - Double, ranging from 0.0 to 1.0 or with the special value Efl.Gfx.Size.Hint.Fill, to use as horizontal alignment hint.
  • y - Double, ranging from 0.0 to 1.0 or with the special value Efl.Gfx.Size.Hint.Fill, to use as vertical alignment hint.

Signature

@property hint_align @pure_virtual {
    get {
        values {
            x: double;
            y: double;
        }
    }
    set {
        values {
            x: double;
            y: double;
        }
    }
}

C signature

void efl_gfx_size_hint_align_get(const Eo *obj, double *x, double *y);
void efl_gfx_size_hint_align_set(Eo *obj, double x, double y);

Implemented by

  • Efl.Gfx.Size.Hint.hint_align