KlassenKlassenKlassenKlassen | | | | Operatoren

write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString (Operator)

Name

write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString — Ausgabe von Text in ein Fenster.

Signatur

write_string( : : WindowHandle, String : )

Herror write_string(const Hlong WindowHandle, const char* String)

Herror T_write_string(const Htuple WindowHandle, const Htuple String)

Herror write_string(const HTuple& WindowHandle, const HTuple& String)

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

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 HOperatorSetX.WriteString(
[in] VARIANT WindowHandle, [in] VARIANT String)

void HWindowX.WriteString([in] VARIANT String)

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

void HWindow.WriteString(HTuple stringVal)

void HWindow.WriteString(string stringVal)

Beschreibung

write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString gibt im Ausgabefenster einen StringStringStringStringStringstringVal 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_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents 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_stringWriteStringwrite_stringWriteStringWriteString kann alle drei Datentypen ausgeben. Die Konversion in eine Zeichenreihe erfolgt nach folgenden Regeln:

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

Achtung

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

Parallelisierung

Parameter

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

Fenster-Handle.

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

Tupel von auszugebenden Werten (beliebige Typen).

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

Ergebnis

write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString 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_checkSetCheckset_checkSetCheckSetCheck). Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, set_fontset_fontSetFontset_fontSetFontSetFont, get_string_extentsget_string_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents

Alternativen

fwrite_stringfwrite_stringFwriteStringfwrite_stringFwriteStringFwriteString

Siehe auch

set_tpositionset_tpositionSetTpositionset_tpositionSetTpositionSetTposition, get_string_extentsget_string_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents, set_fontset_fontSetFontset_fontSetFontSetFont, set_systemset_systemSetSystemset_systemSetSystemSetSystem, set_checkset_checkSetCheckset_checkSetCheckSetCheck

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren