write_stringT_write_stringWriteStringWriteString (Operator)

Name

write_stringT_write_stringWriteStringWriteString — Ausgabe von Text in ein Fenster.

Signatur

write_string( : : WindowHandle, String : )

Herror T_write_string(const Htuple WindowHandle, const Htuple String)

void WriteString(const HTuple& WindowHandle, const HTuple& String)

void HWindow::WriteString(const HTuple& String) const

void HWindow::WriteString(const HString& String) const

void HWindow::WriteString(const char* String) const

void HWindow::WriteString(const wchar_t* String) const   (Nur Windows)

static void HOperatorSet.WriteString(HTuple windowHandle, HTuple stringVal)

void HWindow.WriteString(HTuple stringVal)

void HWindow.WriteString(string stringVal)

Beschreibung

write_stringwrite_stringWriteStringWriteStringWriteString gibt im Ausgabefenster einen StringStringStringStringstringVal aus, an der momentanen Textcursorposition. Der auszugebende Text darf nicht länger als der bis zum rechten Fensterrand verbleibende Platz sein (gegebenenfalls kann mit Hilfe des Operators get_string_extentsget_string_extentsGetStringExtentsGetStringExtentsGetStringExtents die Länge des Strings abgefragt werden).

Bei der Ausgabe wird der gerade für das Fenster eingestellte Font verwendet. Der Textcursor steht im Anschluss an die Ausgabe hinter dem geschriebenen Text.

write_stringwrite_stringWriteStringWriteStringWriteString kann alle drei Datentypen ausgeben. Die Konversion in eine Zeichenreihe erfolgt nach folgenden Regeln:

Für die Pufferung von Texten siehe set_systemset_systemSetSystemSetSystemSetSystem mit dem Flag 'flush_graphic'.

Achtung

Falls ein Klipping am Fensterrand erwünscht ist, kann die Fehlermeldung mit set_check('~text') ausgeschaltet werden.

Ausführungsinformationen

Parameter

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window HWindow, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Fenster-Handle.

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

Tupel von auszugebenden Werten (beliebige Typen).

Defaultwert: 'hello' "hello" "hello" "hello" "hello"

Ergebnis

write_stringwrite_stringWriteStringWriteStringWriteString liefert den Wert 2 (H_MSG_TRUE), falls das Fenster gültig ist und der auszugebende Text in der aktuellen Zeile noch Platz hat (siehe set_checkset_checkSetCheckSetCheckSetCheck). Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_windowopen_windowOpenWindowOpenWindowOpenWindow, set_fontset_fontSetFontSetFontSetFont, get_string_extentsget_string_extentsGetStringExtentsGetStringExtentsGetStringExtents

Alternativen

fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteString

Siehe auch

set_tpositionset_tpositionSetTpositionSetTpositionSetTposition, get_string_extentsget_string_extentsGetStringExtentsGetStringExtentsGetStringExtents, set_fontset_fontSetFontSetFontSetFont, set_systemset_systemSetSystemSetSystemSetSystem, set_checkset_checkSetCheckSetCheckSetCheck

Modul

Foundation