/// <summary>
/// The application calls this function to get the pixel location relative to the top-left of the layout box
/// given the text position and the logical side of the position.
/// This function is normally used as part of caret positioning of text where the caret is drawn
/// at the location corresponding to the current text editing position.
/// It may also be used as a way to programmatically obtain the geometry of a particular text position in UI automation.</summary>
/// <param name="textPosition">The text position used to get the pixel location</param>
/// <param name="isTrailingHit">A Boolean flag that whether the pixel location is of the leading or
/// the trailing side of the specified text position</param>
/// <returns>HitTestMetrics of given text position</returns>
public HitTestMetrics HitTestTextPosition(int textPosition, bool isTrailingHit)
{
float x, y;
var hitTestMetrics = NativeTextLayout.HitTestTextPosition(textPosition, isTrailingHit, out x, out y);
var result = new HitTestMetrics
{
TextPosition = hitTestMetrics.TextPosition,
Length = hitTestMetrics.Length,
Point = new PointF(x, y),
Width = hitTestMetrics.Width,
Height = hitTestMetrics.Height
};
return(result);
}
/// <summary>
/// The application calls this function passing in a specific pixel location relative to the top-left location
/// of the layout box and obtains the information about the correspondent hit-test metrics of the text string
/// where the hit-test has occurred. When the specified pixel location is outside the text string,
/// the function sets the output value IsInside to False.</summary>
/// <param name="x">The pixel location X to hit-test, relative to the top-left location of the layout box.</param>
/// <param name="y">The pixel location Y to hit-test, relative to the top-left location of the layout box.</param>
/// <returns>HitTestMetrics of text string where hit test occurs</returns>
public HitTestMetrics HitTestPoint(float x, float y)
{
Bool isTrailingHit;
Bool isInside;
var hitTestMetrics = NativeTextLayout.HitTestPoint(x, y, out isTrailingHit, out isInside);
var result = new HitTestMetrics
{
IsInside = isInside,
IsTrailingHit = isTrailingHit,
TextPosition = hitTestMetrics.TextPosition,
Length = hitTestMetrics.Length
};
return(result);
}
/// <summary>
/// The application calls this function to get a set of hit-test metrics corresponding to a range of text positions.
/// One of the main usages is to implement highlight selection of the text string.</summary>
/// <param name="textPosition">The first text position of the specified range.</param>
/// <param name="textLength">The number of positions of the specified range.</param>
/// <param name="originX">The origin pixel location X at the left of the layout box.
/// This offset is added to the hit-test metrics returned. </param>
/// <param name="originY">The origin pixel location Y at the top of the layout box.
/// This offset is added to the hit-test metrics returned. </param>
/// <returns>An array of D2dTextHitTestMetrics fully enclosing the specified position range.</returns>
public HitTestMetrics[] HitTestTextRange(int textPosition, int textLength, float originX, float originY)
{
var hitTestMetrics = NativeTextLayout.HitTestTextRange(textPosition, textLength, originX, originY);
var result = new HitTestMetrics[hitTestMetrics.Length];
for (int i = 0; i < hitTestMetrics.Length; ++i)
{
result[i].TextPosition = hitTestMetrics[i].TextPosition;
result[i].Length = hitTestMetrics[i].Length;
result[i].Point = new PointF(hitTestMetrics[i].Left, hitTestMetrics[i].Top);
result[i].Height = hitTestMetrics[i].Height;
result[i].Width = hitTestMetrics[i].Width;
result[i].Top = hitTestMetrics[i].Top;
}
return(result);
}
/// <summary>
/// The application calls this function passing in a specific pixel location relative to the top-left location
/// of the layout box and obtains the information about the correspondent hit-test metrics of the text string
/// where the hit-test has occurred. When the specified pixel location is outside the text string,
/// the function sets the output value IsInside to False.</summary>
/// <param name="x">The pixel location X to hit-test, relative to the top-left location of the layout box.</param>
/// <param name="y">The pixel location Y to hit-test, relative to the top-left location of the layout box.</param>
/// <returns>HitTestMetrics of text string where hit test occurs</returns>
public HitTestMetrics HitTestPoint(float x, float y)
{
#if WITH_SGD
SharpDX.Mathematics.Interop.RawBool isTrailingHit;
SharpDX.Mathematics.Interop.RawBool isInside;
#else
Bool isTrailingHit;
Bool isInside;
#endif
var hitTestMetrics = NativeTextLayout.HitTestPoint(x, y, out isTrailingHit, out isInside);
var result = new HitTestMetrics
{
IsInside = isInside,
IsTrailingHit = isTrailingHit,
TextPosition = hitTestMetrics.TextPosition,
Length = hitTestMetrics.Length
};
return(result);
}
/// <summary>
/// The application calls this function passing in a specific pixel location relative to the top-left location
/// of the layout box and obtains the information about the correspondent hit-test metrics of the text string
/// where the hit-test has occurred. When the specified pixel location is outside the text string,
/// the function sets the output value IsInside to False.</summary>
/// <param name="x">The pixel location X to hit-test, relative to the top-left location of the layout box.</param>
/// <param name="y">The pixel location Y to hit-test, relative to the top-left location of the layout box.</param>
public HitTestMetrics HitTestPoint(float x, float y)
{
Bool isTrailingHit;
Bool isInside;
var hitTestMetrics = NativeTextLayout.HitTestPoint(x, y, out isTrailingHit, out isInside);
var result = new HitTestMetrics
{
IsInside = isInside,
IsTrailingHit = isTrailingHit,
TextPosition = hitTestMetrics.TextPosition,
Length = hitTestMetrics.Length
};
return result;
}
/// <summary>
/// The application calls this function to get a set of hit-test metrics corresponding to a range of text positions.
/// One of the main usages is to implement highlight selection of the text string.
/// </summary>
/// <param name="textPosition">The first text position of the specified range.</param>
/// <param name="textLength">The number of positions of the specified range.</param>
/// <param name="originX">The origin pixel location X at the left of the layout box.
/// This offset is added to the hit-test metrics returned. </param>
/// <param name="originY">The origin pixel location Y at the top of the layout box.
/// This offset is added to the hit-test metrics returned. </param>
/// <returns>An array of D2dTextHitTestMetrics fully enclosing the specified position range.</returns>
public HitTestMetrics[] HitTestTextRange(int textPosition, int textLength, float originX, float originY)
{
var hitTestMetrics = NativeTextLayout.HitTestTextRange(textPosition, textLength, originX, originY);
var result = new HitTestMetrics[hitTestMetrics.Length];
for (int i = 0; i < hitTestMetrics.Length; ++i)
{
result[i].TextPosition = hitTestMetrics[i].TextPosition;
result[i].Length = hitTestMetrics[i].Length;
result[i].Point = new PointF(hitTestMetrics[i].Left, hitTestMetrics[i].Top);
result[i].Height = hitTestMetrics[i].Height;
result[i].Width = hitTestMetrics[i].Width;
result[i].Top = hitTestMetrics[i].Top;
}
return result;
}
/// <summary>
/// The application calls this function to get the pixel location relative to the top-left of the layout box
/// given the text position and the logical side of the position.
/// This function is normally used as part of caret positioning of text where the caret is drawn
/// at the location corresponding to the current text editing position.
/// It may also be used as a way to programmatically obtain the geometry of a particular text position in UI automation.
/// </summary>
/// <param name="textPosition">The text position used to get the pixel location.</param>
/// <param name="isTrailingHit">A Boolean flag that whether the pixel location is of the leading or
/// the trailing side of the specified text position.</param>
/// <returns></returns>
public HitTestMetrics HitTestTextPosition(int textPosition, bool isTrailingHit)
{
float x, y;
var hitTestMetrics = NativeTextLayout.HitTestTextPosition(textPosition, isTrailingHit, out x, out y );
var result = new HitTestMetrics
{
TextPosition = hitTestMetrics.TextPosition,
Length = hitTestMetrics.Length,
Point = new PointF(x,y),
Width = hitTestMetrics.Width,
Height = hitTestMetrics.Height
};
return result;
}
