Tizen Native API

Elementary is designed to be finger-friendly for touchscreens, and so in addition to scaling for display resolution, it can also scale based on finger "resolution" (or size). You can then customize the granularity of the areas meant to receive clicks on touchscreens.

Remarks:
Different profiles may have pre-set values for finger sizes.

Functions

void elm_coords_finger_size_adjust (int times_w, Evas_Coord *w, int times_h, Evas_Coord *h)
 Adjusts the size of an element for finger usage.

Function Documentation

Gets the configured "finger size".

This gets the globally configured finger size, in pixels.

Since :
2.3.1
Returns:
The finger size

Sets the configured finger size.

This sets the globally configured finger size in pixels.

Since :
2.3.1
Parameters:
[in]sizeThe finger size
void elm_coords_finger_size_adjust ( int  times_w,
Evas_Coord w,
int  times_h,
Evas_Coord h 
)

Adjusts the size of an element for finger usage.

Since :
2.3.1
Remarks:
This takes width and height sizes (in pixels) as input and a size multiple (which is how many fingers you want to place within the area, with "finger" as the size set by elm_finger_size_set()), and adjusts the size to be large enough to accommodate the resulting size, if it doesn't already accommodate it. On return the w and h sizes pointed to by these parameters are modified, on those conditions.
This is a kind of low level Elementary call, most useful on size evaluation times for widgets. An external user wouldn't be calling, most of the time.
Parameters:
[in]times_wThe number of fingers that fit horizontally
[out]wA pointer to the width size to adjust
[in]times_hThe number of fingers that fit vertically
[out]hA pointer to the height size to adjust