man mdraw_coordinates_position () - Return the character position nearest to the coordinates.
NAME
mdraw_coordinates_position - Return the character position nearest to the coordinates.
SYNOPSIS
int mdraw_coordinates_position (MFrame * frame, MText * mt, int from, int to, int x_offset, int y_offset, MDrawControl * control)
DESCRIPTION
The mdraw_coordinates_position() function checks which character is to be drawn at coordinate (x, y) when the text between from and to of M-text mt is drawn at the coordinate (0, 0) using the mdraw_text_with_control() function with the drawing control object control. Here, the character position means the number of characters that precede the character in question in mt, that is, the character position of the first character is 0.
fram is used only to get the default face information.
RETURN VALUE
If the glyph image of a character covers coordinate (x,
y),
mdraw_coordinates_position()
returns the character position of that character.
If
y
is less than the minimum Y-coordinate of the drawn area, it returns
from.
If
y
is greater than the maximum Y-coordinate of the drawn area, it returns
to.
If
y
fits in with the drawn area but
x
is less than the minimum X-coordinate, it returns the character position of the first character drawn on the line
y.
If y fits in with the drawn area but x is greater than the maximum X-coordinate, it returns the character position of the last character drawn on the line y.