open_textwindowopen_textwindowOpenTextwindowOpenTextwindow (Operator)

Name

open_textwindowopen_textwindowOpenTextwindowOpenTextwindow — Öffnen eines Textfensters.

Warnung

open_textwindowopen_textwindowOpenTextwindowOpenTextwindowOpenTextwindow ist veraltet und wird nur aus Gründen der Rückwärtskompatibilität zur Verfügung gestellt. Neue Applikationen sollten stattdessen den Operator open_windowopen_windowOpenWindowOpenWindowOpenWindow verwenden.

Signatur

Beschreibung

open_textwindowopen_textwindowOpenTextwindowOpenTextwindowOpenTextwindow öffnet ein neues Textfenster, das zur Aus- und Eingabe von Text, sowie für die Ausgabe von Bildern verwendet werden kann. Unter Verwendung der logischen Fensternummer WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle können alle Ausgaben (write_stringwrite_stringWriteStringWriteStringWriteString, read_stringread_stringReadStringReadStringReadString, disp_regiondisp_regionDispRegionDispRegionDispRegion, etc.) auf dieses Fenster geleitet werden.

Textfenster besitzen neben dem Mauscursor auch einen Textcursor, der die aktuelle Schreibposition bezeichnet (genauer: die linke untere Ecke des auszugebenden Strings ohne Berücksichtigung der Unterlängen). Seine Position wird durch einen Unterstrich (oder eine andere Form) angezeigt (die Anzeige dieser Position kann aber auch ausgeschaltet sein (= Defaulteinstellung); vgl. set_tshapeset_tshapeSetTshapeSetTshapeSetTshape). Mit den Operatoren set_tpositionset_tpositionSetTpositionSetTpositionSetTposition und get_tpositionget_tpositionGetTpositionGetTpositionGetTposition kann die Position gesetzt bzw. abgefragt werden.

Beim Öffnen eines Textfensters wird die Cursorposition auf (H,0) gesetzt, wobei H die Höhe des Defaultfonts abzüglich der Unterlängen angibt. Der Cursor wird aber nicht angezeigt. Die Ausgabe beginnt also beim Schreiben in der linken oberen Ecke des Fensters.

Die Farben für den Hintergrund und den Bildrand können mit query_colorquery_colorQueryColorQueryColorQueryColor abgefragt werden. Dies kann auch mit einem Fenster vom Typ 'invisible' durchgeführt werden. Das Clipping von Texten bei der Ausgabe (write_stringwrite_stringWriteStringWriteStringWriteString) an den Fensterrändern kann mit set_check(::'~text':) eingeschaltet werden, d.h. es wird dann keine Fehlermeldung mehr erzeugt, falls der Text über den Rand des Fensters hinausragt.

Der Ursprung des Koordinatensystems des Fensters liegt in der linken oberen Ecke (Koordinaten: (0,0)). Nach unten nimmt der Zeilenindex zu (maximal: HeightHeightHeightHeightheight-1), nach rechts steigt der Spaltenindex (maximal: WidthWidthWidthWidthwidth-1) an.

Der Parameter MachineMachineMachineMachinemachine gibt den Namen des Rechners an, auf dem das Fenster geöffnet werden soll. Im Falle von X-Window wird bei TCP-IP nur der Name, bei DEC-Net wird noch ein Doppelpunkt hinter den Namen gesetzt. Der „Server“ bzw. der „Screen“ wird nicht mit angegeben. Übergibt man den leeren String, so wird die Environmentvariable DISPLAY zur Festlegung des Zielrechners verwendet. Hierbei wird der Name in der üblichen Syntax <Host>:0.0 angegeben.

Mit dem Parameter FatherWindowFatherWindowFatherWindowFatherWindowfatherWindow kann für die Fenstertypen 'WIN32-Window', 'X-Window' und 'Cocoa' das Vaterfenster für das zu öffnende Fenster angegeben werden. Ist die Kontrolle 'father' mittels set_checkset_checkSetCheckSetCheckSetCheck eingeschaltet, so muss FatherWindowFatherWindowFatherWindowFatherWindowfatherWindow ein HALCON-Fenster sein, andernfalls (set_check('~father')) kann es auch ein Betriebssystem-Fenster sein. Wird für FatherWindowFatherWindowFatherWindowFatherWindowfatherWindow der Wert 0 oder 'root' übergeben, so ist der Desktop (Windows) bzw. das Root-Fenster (unixartige Systeme) das Vaterfenster. In diesem Fall ist die Einstellung der Kontrolle 'father' mittels set_checkset_checkSetCheckSetCheckSetCheck nicht relevant. Der Aufrufer muss sicherstellen, dass FatherWindowFatherWindowFatherWindowFatherWindowfatherWindow ein gültiges Fensterhandle ist und dass dieses nicht zerstört wird, solange das eingebettete HALCON Fenster verwendet wird.

Die Position und Größe des Fensters kann sich im Laufe des Programms ändern. Dies kann zum einen mit set_window_extentsset_window_extentsSetWindowExtentsSetWindowExtentsSetWindowExtents erfolgen, aber auch durch externe Eingriffe (Windowmanager) hervorgerufen werden. Für den zweiten Fall ist der Operator set_window_extentsset_window_extentsSetWindowExtentsSetWindowExtentsSetWindowExtents vorgesehen.

Dem Fenster wird beim Öffnen ein sog. Defaultfont zugeordnet. Dieser wird für Operatoren wie write_stringwrite_stringWriteStringWriteStringWriteString verwendet und kann mit set_fontset_fontSetFontSetFontSetFont nach dem Aufruf von open_textwindowopen_textwindowOpenTextwindowOpenTextwindowOpenTextwindow überschrieben werden. Es ist jedoch auch möglich, den Defaultfont mit dem Aufruf set_system(::'default_font',<Fontname>:)set_system("default_font",<Fontname>)SetSystem("default_font",<Fontname>)SetSystem("default_font",<Fontname>)SetSystem("default_font",<Fontname>) vor dem Öffnen eines Fensters (und auch aller weiteren) festzulegen (siehe hierzu auch query_fontquery_fontQueryFontQueryFontQueryFont).

Die Farbe der Schrift (write_stringwrite_stringWriteStringWriteStringWriteString, read_stringread_stringReadStringReadStringReadString) wird mit set_colorset_colorSetColorSetColorSetColor, set_rgbset_rgbSetRgbSetRgbSetRgb, set_hsiset_hsiSetHsiSetHsiSetHsi oder set_grayset_graySetGraySetGraySetGray festgelegt. Mit set_insertset_insertSetInsertSetInsertSetInsert wird bestimmt, wie der Text (bzw. die Graphik) mit dem Inhalt des Bildwiederholspeichers verknüpft wird. Hierbei kann z.B. mit set_insertset_insertSetInsertSetInsertSetInsert(::'not':) erreicht werden, dass nach zweimaligem Schreiben des Textes an der gleichen Position die Schrift wieder beseitigt wird.

Normalerweise wird jede Ausgabe (z.B. mit write_stringwrite_stringWriteStringWriteStringWriteString, disp_regiondisp_regionDispRegionDispRegionDispRegion, disp_circledisp_circleDispCircleDispCircleDispCircle, etc.) in ein Fenster durch einen sog. „Flush“ abgeschlossen. Dies bewirkt, dass die Daten nach Beendigung der Ausgabeprozedur auf dem Bildschirm vollständig sichtbar werden. Dies ist aber nicht in allen Fällen erforderlich, insbesondere dann, wenn ständig Ausgaben erfolgen, oder eine Maus-Prozedur aktiv ist. Hier ist es günstiger (d.h. schneller), wenn die Daten gepuffert werden, bis genügend Daten vorhanden sind. Dieses Verhalten kann durch den Aufruf von set_system(::'flush_graphic','false':)set_system("flush_graphic","false")SetSystem("flush_graphic","false")SetSystem("flush_graphic","false")SetSystem("flush_graphic","false") eingestellt werden.

Der Inhalt von Fenstern wird (falls die Treibersoftware dies unterstützt) gesichert; d.h. er bleibt erhalten, auch wenn das Fenster von anderen Fenstern überlappt wird. Dies ist jedoch nicht in allen Fällen notwendig: Wenn man ein Textfenster z.B. als Vaterfenster für andere Fenster verwendet, so kann für dieses der Sicherungsmechanismus abgestellt und damit der hierfür nötige Speicher eingespart werden. Dies geschieht mit dem Aufruf von set_system(::'backing_store','false':)set_system("backing_store","false")SetSystem("backing_store","false")SetSystem("backing_store","false")SetSystem("backing_store","false") vor dem Öffnen des Fensters.

Unterschied: Graphikfenster - Textfenster

• Im Gegensatz zu Graphikfenstern (open_windowopen_windowOpenWindowOpenWindowOpenWindow) können für Textfenster mehr Parameter (Farbe, Rand) beim Öffnen festgelegt werden.

• Nur Textfenster können zum Einlesen von Benutzerdaten verwendet werden (read_stringread_stringReadStringReadStringReadString).

• Die Ausgabe von Bildern, Regionen und Graphiken wird bei Textfenstern an den Rändern „geclippt“, während bei Graphikfenstern „gezoomt“ wird.

• Das Koordinatensystem (z.B. bei get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbutton oder get_mpositionget_mpositionGetMpositionGetMpositionGetMposition) ist unabhängig von der Bildgröße immer in Bildschirmkoordinaten. Die maximalen Koordinaten entsprechen also der Größe des Fensters minus 1. Im Gegensatz dazu wird bei Graphikfenstern (open_windowopen_windowOpenWindowOpenWindowOpenWindow) immer ein Koordinatensystem verwendet, das dem Bildformat entspricht.

Der Parameter ModeModeModeModemode legt den Modus des Fensters fest. Dieser kann folgende Werte annehmen:

'visible':

Dies ist der normale Modus für Textfenster: Das Fenster wird entsprechend den Parametern erzeugt und alle Ein- und Ausgaben sind möglich.

'invisible':

Unsichtbare Fenster werden nicht auf dem Bildschirm dargestellt. Die Parameter RowRowRowRowrow, ColumnColumnColumnColumncolumn, BorderWidthBorderWidthBorderWidthBorderWidthborderWidth, BorderColorBorderColorBorderColorBorderColorborderColor, BackgroundColorBackgroundColorBackgroundColorBackgroundColorbackgroundColor und FatherWindowFatherWindowFatherWindowFatherWindowfatherWindow sind ohne Bedeutung. Ausgaben auf diese Fenster haben keine Wirkung. Eingaben (read_stringread_stringReadStringReadStringReadString, Maus, etc.) sind nicht möglich. Diese Fenster werden verwendet, wenn man Darstellungsparameter für ein Ausgabegerät abfragen möchte, ohne ein (sichtbares) Fenster zu öffnen. Übliche Anfragen sind z.b. query_colorquery_colorQueryColorQueryColorQueryColor und get_string_extentsget_string_extentsGetStringExtentsGetStringExtentsGetStringExtents.

'transparent':

Diese Fenster sind durchsichtig: Das Fenster selbst ist nicht sichtbar (Rand und Hintergrund), jedoch sind alle sonstigen Operationen möglich und alle Ausgaben werden dargestellt. Die Parameter BorderColorBorderColorBorderColorBorderColorborderColor und BackgroundColorBackgroundColorBackgroundColorBackgroundColorbackgroundColor sind hier ohne Bedeutung. Eine übliche Verwendung für diesen Modus ist die Erzeugung von Maus-sensitiven Bereichen.

'buffer':

Dies sind ebenfalls nicht sichtbare Fenster. Die Ausgabe von Bildern, Regionen und Graphik ist auf dem Bildschirm nicht sichtbar, wird jedoch im Speicher gepuffert. Die Parameter RowRowRowRowrow, ColumnColumnColumnColumncolumn, BorderWidthBorderWidthBorderWidthBorderWidthborderWidth, BorderColorBorderColorBorderColorBorderColorborderColor, BackgroundColorBackgroundColorBackgroundColorBackgroundColorbackgroundColor und FatherWindowFatherWindowFatherWindowFatherWindowfatherWindow sind ohne Bedeutung. Puffer-Fenster verwendet man beispielsweise, wenn man Ausgaben (im Hintergrund) vorbereitet und schließlich mit copy_rectanglecopy_rectangleCopyRectangleCopyRectangleCopyRectangle in ein sichtbares Fenster kopiert. Eine andere Anwendung wäre die schnelle Verarbeitung von Bildauschnitten bei interaktiven Manipulationen. Texteingaben und Mausinteraktion ist mit dem Modus 'buffer' nicht möglich.

Achtung

Es ist zu beachten, dass die Parameter RowRowRowRowrow, ColumnColumnColumnColumncolumn, WidthWidthWidthWidthwidth und HeightHeightHeightHeightheight durch das Ausgabegerät beschränkt sind. Wird ein Vaterfenster (FatherWindowFatherWindowFatherWindowFatherWindowfatherWindow <> 'root') angegeben, dann sind die Koordinaten relativ zum diesem Fenster.

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.

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

open_textwindow(0,0,900,600,1,'black','slate blue','root','visible', \
              '',WindowHandle1)
open_textwindow(10,10,300,580,3,'red','blue',WindowHandle1,'visible', \
              '',WindowHandle2)
open_window(10,320,570,580,WindowHandle1,'visible','',WindowHandle)
set_color(WindowHandle,'red')
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
Button := 0
repeat
  try
      get_mposition(WindowHandle,Row,Column,Button)
      get_grayval(Image,Row,Column,Gray)
      write_string(WindowHandle2,['  Position (',Row,',',Column,')  '])
      write_string(WindowHandle2,['Gray value (',Gray,')  '])
      new_line(WindowHandle2)
  catch (Exception)
  endtry
until(Button == 4)
close_window(WindowHandle1)

open_textwindow(0,0,900,600,1,"black","slate blue","root","visible",
                "",&WindowHandle1) ;
open_textwindow(10,10,300,580,3,"red","blue",Father,"visible",
                "",&WindowHandle2) ;
open_window(10,320,570,580,Father,"visible","",&WindowHandle) ;
set_color(WindowHandle,"red") ;
read_image(&Image,"monkey") ;
disp_image(Image,WindowHandle) ;
create_tuple(&String,1) ;
do {
  get_mposition(WindowHandle,&Row,&Column,&Button) ;
  get_grayval(Image,Row,Column,&Gray) ;
  sprintf(buf,"Position( %d,%d ) ",Row,Column) ;
  set_s(String,buf,0) ;
  T_fwrite_string(String) ;
  new_line(WindowHandle) ;
}
while(Button < 4) ;
close_window(WindowHandle) ;
clear_obj(Image) ;

open_textwindow(0,0,900,600,1,'black','slate blue','root','visible', \
              '',WindowHandle1)
open_textwindow(10,10,300,580,3,'red','blue',WindowHandle1,'visible', \
              '',WindowHandle2)
open_window(10,320,570,580,WindowHandle1,'visible','',WindowHandle)
set_color(WindowHandle,'red')
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
Button := 0
repeat
  try
      get_mposition(WindowHandle,Row,Column,Button)
      get_grayval(Image,Row,Column,Gray)
      write_string(WindowHandle2,['  Position (',Row,',',Column,')  '])
      write_string(WindowHandle2,['Gray value (',Gray,')  '])
      new_line(WindowHandle2)
  catch (Exception)
  endtry
until(Button == 4)
close_window(WindowHandle1)

open_textwindow(0,0,900,600,1,'black','slate blue','root','visible', \
              '',WindowHandle1)
open_textwindow(10,10,300,580,3,'red','blue',WindowHandle1,'visible', \
              '',WindowHandle2)
open_window(10,320,570,580,WindowHandle1,'visible','',WindowHandle)
set_color(WindowHandle,'red')
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
Button := 0
repeat
  try
      get_mposition(WindowHandle,Row,Column,Button)
      get_grayval(Image,Row,Column,Gray)
      write_string(WindowHandle2,['  Position (',Row,',',Column,')  '])
      write_string(WindowHandle2,['Gray value (',Gray,')  '])
      new_line(WindowHandle2)
  catch (Exception)
  endtry
until(Button == 4)
close_window(WindowHandle1)

open_textwindow(0,0,900,600,1,'black','slate blue','root','visible', \
              '',WindowHandle1)
open_textwindow(10,10,300,580,3,'red','blue',WindowHandle1,'visible', \
              '',WindowHandle2)
open_window(10,320,570,580,WindowHandle1,'visible','',WindowHandle)
set_color(WindowHandle,'red')
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
Button := 0
repeat
  try
      get_mposition(WindowHandle,Row,Column,Button)
      get_grayval(Image,Row,Column,Gray)
      write_string(WindowHandle2,['  Position (',Row,',',Column,')  '])
      write_string(WindowHandle2,['Gray value (',Gray,')  '])
      new_line(WindowHandle2)
  catch (Exception)
  endtry
until(Button == 4)
close_window(WindowHandle1)

Ergebnis

Sind die Parameterwerte korrekt, dann liefert open_textwindowopen_textwindowOpenTextwindowOpenTextwindowOpenTextwindow den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

reset_obj_dbreset_obj_dbResetObjDbResetObjDbResetObjDb

Nachfolger

set_colorset_colorSetColorSetColorSetColor, query_window_typequery_window_typeQueryWindowTypeQueryWindowTypeQueryWindowType, get_window_typeget_window_typeGetWindowTypeGetWindowTypeGetWindowType, set_window_typeset_window_typeSetWindowTypeSetWindowTypeSetWindowType, get_mpositionget_mpositionGetMpositionGetMpositionGetMposition, set_tpositionset_tpositionSetTpositionSetTpositionSetTposition, set_tshapeset_tshapeSetTshapeSetTshapeSetTshape, set_window_extentsset_window_extentsSetWindowExtentsSetWindowExtentsSetWindowExtents, get_window_extentsget_window_extentsGetWindowExtentsGetWindowExtentsGetWindowExtents, query_colorquery_colorQueryColorQueryColorQueryColor, set_checkset_checkSetCheckSetCheckSetCheck, set_systemset_systemSetSystemSetSystemSetSystem

Alternativen

open_windowopen_windowOpenWindowOpenWindowOpenWindow

Siehe auch

write_stringwrite_stringWriteStringWriteStringWriteString, read_stringread_stringReadStringReadStringReadString, new_linenew_lineNewLineNewLineNewLine, get_string_extentsget_string_extentsGetStringExtentsGetStringExtentsGetStringExtents, get_tpositionget_tpositionGetTpositionGetTpositionGetTposition, set_colorset_colorSetColorSetColorSetColor, query_window_typequery_window_typeQueryWindowTypeQueryWindowTypeQueryWindowType, get_window_typeget_window_typeGetWindowTypeGetWindowTypeGetWindowType, set_window_typeset_window_typeSetWindowTypeSetWindowTypeSetWindowType, get_mpositionget_mpositionGetMpositionGetMpositionGetMposition, set_tpositionset_tpositionSetTpositionSetTpositionSetTposition, set_tshapeset_tshapeSetTshapeSetTshapeSetTshape, set_window_extentsset_window_extentsSetWindowExtentsSetWindowExtentsSetWindowExtents, get_window_extentsget_window_extentsGetWindowExtentsGetWindowExtentsGetWindowExtents, query_colorquery_colorQueryColorQueryColorQueryColor, set_checkset_checkSetCheckSetCheckSetCheck, set_systemset_systemSetSystemSetSystemSetSystem

Modul

Foundation