KlassenKlassenKlassenKlassen | | | | Operatoren

query_colorT_query_colorQueryColorquery_colorQueryColorQueryColor (Operator)

Name

query_colorT_query_colorQueryColorquery_colorQueryColorQueryColor — Abfragen aller im Fenster darstellbaren Farbnamen.

Signatur

query_color( : : WindowHandle : Colors)

Herror T_query_color(const Htuple WindowHandle, Htuple* Colors)

Herror query_color(const HTuple& WindowHandle, HTuple* Colors)

HTuple HWindow::QueryColor() const

void QueryColor(const HTuple& WindowHandle, HTuple* Colors)

HTuple HWindow::QueryColor() const

void HOperatorSetX.QueryColor(
[in] VARIANT WindowHandle, [out] VARIANT* Colors)

VARIANT HWindowX.QueryColor()

static void HOperatorSet.QueryColor(HTuple windowHandle, out HTuple colors)

HTuple HWindow.QueryColor()

Beschreibung

query_colorquery_colorQueryColorquery_colorQueryColorQueryColor gibt für das Ausgabefenster die Namen aller Farben aus, die bei der Darstellung von Regionen (disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, disp_polygondisp_polygonDispPolygondisp_polygonDispPolygonDispPolygon, disp_circledisp_circleDispCircledisp_circleDispCircleDispCircle, etc.) verwendet werden können. Diese können mit dem Operator set_colorset_colorSetColorset_colorSetColorSetColor gesetzt werden. Bei einem S/W-Bildschirm liefert query_colorquery_colorQueryColorquery_colorQueryColorQueryColor die Werte 'black' und 'white'. Diese beiden „Farben“ stehen bei jedem Bildschirm zur Verfügung. Bei Bildschirmen mit Graustufen werden auch einige Grautöne angegeben (z.B.: 'dim gray'). Bei Bildschirmen mit Farbtabellen wird eine Liste von darstellbaren Farben zurückgeliefert. Per Default beginnt das Tupel der Farben dabei mit S/W, gefolgt von den drei Grundfarben ('red','green','blue') und einigen Grautönen. Eine Liste aller dem System bekannten Farben erhält man dazu mit dem Aufruf query_all_colors(::WindowHandle:Colors )query_all_colors(WindowHandle,Colors )QueryAllColors(WindowHandle,Colors )query_all_colors(WindowHandle,Colors )QueryAllColors(WindowHandle,Colors )QueryAllColors(WindowHandle,Colors ). Genau diese Liste wird übrigens bei Bildschirmen mit Echtfarbenausgabe auch von query_colorquery_colorQueryColorquery_colorQueryColorQueryColor ausgegeben. Dies sind natürlich nicht alle Farben, die dargestellt werden können. Diese müssen dann mit set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb oder set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi direkt gewählt werden. Werden Farbnamen verwendet, die HALCON zwar bekannt sind, aber auf dem Rechner nicht darstellbar sind, dann wählt HALCON eine ähnliche Farbe aus (und erzeugt keine Fehlermeldung), falls set_checkset_checkSetCheckset_checkSetCheckSetCheck mit dem Parameter 'color' aufgerufen wird.

Parallelisierung

Parameter

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

Fenster-Handle.

ColorsColorsColorsColorsColorscolors (output_control)  string-array HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Namen der Farben.

Beispiel (HDevelop)

open_window(0,0,-1,-1,'root','invisible','',WindowHandle)
query_color(WindowHandle,Colors)
close_window(WindowHandle)
fwrite_string (FileHandle, ['Displayable colors: ',Colors])

Beispiel (C)

Htuple  Colors, WindowHandleTuple ;
open_window(0,0,-1,-1,0,"invisible","",&WindowHandle);
create_tuple(&WindowHandleTuple,1) ;
set_i(WindowHandleTuple, WindowHandle, 0) ;
T_query_color(WindowHandleTuple,&Colors);
close_window(WindowHandle);
for (i=0; i<length_tuple(Colors); i++)
  printf("Farbe #%s = %s\n",i,get_s(Colors,i));

Beispiel (HDevelop)

open_window(0,0,-1,-1,'root','invisible','',WindowHandle)
query_color(WindowHandle,Colors)
close_window(WindowHandle)
fwrite_string (FileHandle, ['Displayable colors: ',Colors])

Beispiel (HDevelop)

open_window(0,0,-1,-1,'root','invisible','',WindowHandle)
query_color(WindowHandle,Colors)
close_window(WindowHandle)
fwrite_string (FileHandle, ['Displayable colors: ',Colors])

Beispiel (HDevelop)

open_window(0,0,-1,-1,'root','invisible','',WindowHandle)
query_color(WindowHandle,Colors)
close_window(WindowHandle)
fwrite_string (FileHandle, ['Displayable colors: ',Colors])

Beispiel (HDevelop)

open_window(0,0,-1,-1,'root','invisible','',WindowHandle)
query_color(WindowHandle,Colors)
close_window(WindowHandle)
fwrite_string (FileHandle, ['Displayable colors: ',Colors])

Ergebnis

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

Nachfolger

set_colorset_colorSetColorset_colorSetColorSetColor, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion

Siehe auch

query_all_colorsquery_all_colorsQueryAllColorsquery_all_colorsQueryAllColorsQueryAllColors, set_colorset_colorSetColorset_colorSetColorSetColor, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren