get_string_extentsT_get_string_extentsGetStringExtentsGetStringExtents (Operator)
Name
get_string_extentsT_get_string_extentsGetStringExtentsGetStringExtents — Größe eines Strings abfragen.
Signatur
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
Hlong HWindow::GetStringExtents(const wchar_t* Values, Hlong* Descent, Hlong* Width, Hlong* Height) const
(Nur Windows)
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. Dabei werden
Strings mit mehreren Zeilen behandelt als ob sie zu einer Zeile konkateniert
wären.
Zusätzlich 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
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control) window → HWindow, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
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