KlassenKlassen | | Operatoren

get_string_extentsget_string_extentsGetStringExtentsGetStringExtents (Operator)

Name

get_string_extentsget_string_extentsGetStringExtentsGetStringExtents — Größe eines Strings abfragen.

Signatur

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)

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

HTuple HWindow::GetStringExtents(const HTuple& Values, HTuple* Descent, HTuple* Width, HTuple* 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

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

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

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

Beschreibung

get_string_extentsget_string_extentsGetStringExtentsGetStringExtentsGetStringExtents bestimmt die Breite und Höhe von Strings in dem Font, der momentan für das Fenster eingestellt ist. Außerdem wird die Ausdehnung oberhalb und unterhalb der Schreiblinie angegeben (AscentAscentAscentAscentascent bzw. DescentDescentDescentDescentdescent).

Die Größenangaben erfolgen in dem Koordinatensystem des Fensters (d.h. bei Textfenstern in Pixelkoordinaten). Mit Hilfe von get_string_extentsget_string_extentsGetStringExtentsGetStringExtentsGetStringExtents ist es möglich, Textausgabe und Texteingabe unabhängig vom Font zu programmieren. Die Umsetzung von ganzen Zahlen und Gleitpunktzahlen zu Zeichenreihen erfolgt genauso wie bei write_stringwrite_stringWriteStringWriteStringWriteString.

Ausführungsinformationen

Parameter

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window HWindow, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Fenster-Handle.

ValuesValuesValuesValuesvalues (input_control)  string(-array) HTupleHTupleHtuple (string / real / integer) (string / double / int / long) (HString / double / Hlong) (char* / double / Hlong)

Zu untersuchende Werte.

Defaultwert: 'test_string' "test_string" "test_string" "test_string" "test_string"

AscentAscentAscentAscentascent (output_control)  extent.y HTupleHTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)

Maximale Höhe über der Schreiblinie.

DescentDescentDescentDescentdescent (output_control)  extent.y HTupleHTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)

Maximale Tiefe unter der Schreiblinie.

WidthWidthWidthWidthwidth (output_control)  extent.x HTupleHTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)

Länge des Textes.

HeightHeightHeightHeightheight (output_control)  extent.y HTupleHTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)

Höhe des Textes.

Ergebnis

get_string_extentsget_string_extentsGetStringExtentsGetStringExtentsGetStringExtents liefert den Wert 2 (H_MSG_TRUE), falls das Fenster gültig ist. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_windowopen_windowOpenWindowOpenWindowOpenWindow, set_fontset_fontSetFontSetFontSetFont

Nachfolger

set_tpositionset_tpositionSetTpositionSetTpositionSetTposition, write_stringwrite_stringWriteStringWriteStringWriteString, read_stringread_stringReadStringReadStringReadString, read_charread_charReadCharReadCharReadChar

Siehe auch

get_font_extentsget_font_extentsGetFontExtentsGetFontExtentsGetFontExtents, set_tpositionset_tpositionSetTpositionSetTpositionSetTposition, set_fontset_fontSetFontSetFontSetFont

Modul

Foundation


KlassenKlassen | | Operatoren