ClassesClassesClassesClasses | | | | Operators

get_string_extentsget_string_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents (Operator)

Name

get_string_extentsget_string_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents — Get the spatial size of a string.

Signature

get_string_extents( : : WindowHandle, Values : Ascent, Descent, Width, Height)

Herror get_string_extents(const Hlong WindowHandle, const char* Values, Hlong* Ascent, Hlong* Descent, Hlong* Width, Hlong* Height)

Herror T_get_string_extents(const Htuple WindowHandle, const Htuple Values, Htuple* Ascent, Htuple* Descent, Htuple* Width, Htuple* Height)

Herror get_string_extents(const HTuple& WindowHandle, const HTuple& Values, Hlong* Ascent, Hlong* Descent, Hlong* Width, Hlong* Height)

Hlong HWindow::GetStringExtents(const HTuple& Values, HTuple* Descent, HTuple* Width, HTuple* Height) const

void GetStringExtents(const HTuple& WindowHandle, const HTuple& Values, HTuple* Ascent, HTuple* Descent, HTuple* Width, HTuple* Height)

Hlong HWindow::GetStringExtents(const HTuple& Values, Hlong* Descent, Hlong* Width, Hlong* Height) const

Hlong HWindow::GetStringExtents(const HString& Values, Hlong* Descent, Hlong* Width, Hlong* Height) const

Hlong HWindow::GetStringExtents(const char* Values, Hlong* Descent, Hlong* Width, Hlong* Height) const

void HOperatorSetX.GetStringExtents(
[in] VARIANT WindowHandle, [in] VARIANT Values, [out] VARIANT* Ascent, [out] VARIANT* Descent, [out] VARIANT* Width, [out] VARIANT* Height)

Hlong HWindowX.GetStringExtents(
[in] VARIANT Values, [out] Hlong* Descent, [out] Hlong* Width, [out] Hlong* Height)

static void HOperatorSet.GetStringExtents(HTuple windowHandle, HTuple values, out HTuple ascent, out HTuple descent, out HTuple width, out HTuple height)

int HWindow.GetStringExtents(HTuple values, out int descent, out int width, out int height)

int HWindow.GetStringExtents(string values, out int descent, out int width, out int height)

Description

get_string_extentsget_string_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents queries width and height of the output size of a string using the font of the window. In addition, the extension above and below the baseline is returned (AscentAscentAscentAscentAscentascent and DescentDescentDescentDescentDescentdescent, respectively).

The sizes are measured in the coordinate system of the window (for text windows in pixels). Using get_string_extentsget_string_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents, it is possible to determine text output and input independently from the used font. The conversion from integer numbers and floating point numbers to text strings is the same as in write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString.

Parallelization

Parameters

WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window HWindow, HTupleHTupleHTupleHWindowX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Window identifier.

ValuesValuesValuesValuesValuesvalues (input_control)  string(-array) HTupleHTupleHTupleVARIANTHtuple (string / real / integer) (string / double / int / long) (HString / double / Hlong) (char* / double / Hlong) (BSTR / double / Hlong) (char* / double / Hlong)

Values to consider.

Default value: 'test_string' "test_string" "test_string" "test_string" "test_string" "test_string"

AscentAscentAscentAscentAscentascent (output_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Maximum height above baseline.

DescentDescentDescentDescentDescentdescent (output_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Maximum extension below baseline.

WidthWidthWidthWidthWidthwidth (output_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Text width.

HeightHeightHeightHeightHeightheight (output_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Text height.

Result

get_string_extentsget_string_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents returns 2 (H_MSG_TRUE) if the window is valid. Otherwise an exception is raised.

Possible Predecessors

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, open_textwindowopen_textwindowOpenTextwindowopen_textwindowOpenTextwindowOpenTextwindow, set_fontset_fontSetFontset_fontSetFontSetFont

Possible Successors

set_tpositionset_tpositionSetTpositionset_tpositionSetTpositionSetTposition, write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString, read_stringread_stringReadStringread_stringReadStringReadString, read_charread_charReadCharread_charReadCharReadChar

See also

get_font_extentsget_font_extentsGetFontExtentsget_font_extentsGetFontExtentsGetFontExtents, set_tpositionset_tpositionSetTpositionset_tpositionSetTpositionSetTposition, set_fontset_fontSetFontset_fontSetFontSetFont

Module

Foundation


ClassesClassesClassesClasses | | | | Operators