dev_open_tooldev_open_toolDevOpenToolDevOpenTool (Operator)
Name
dev_open_tooldev_open_toolDevOpenToolDevOpenTool
— Öffnen eines HDevelop Tools, eines nicht-modalen Dialogs oder eines
Assistenten.
Signatur
Herror dev_open_tool(const char* ToolName, const Hlong Row, const Hlong Column, const Hlong Width, const Hlong Height, const char* GenParamName, const char* GenParamValue, char* ToolId)
Herror T_dev_open_tool(const Htuple ToolName, const Htuple Row, const Htuple Column, const Htuple Width, const Htuple Height, const Htuple GenParamName, const Htuple GenParamValue, Htuple* ToolId)
Beschreibung
dev_open_tooldev_open_toolDevOpenToolDevOpenToolDevOpenTool
öffnet ein HDevelop Tool, einen nicht-modalen
Dialog oder einen Assistenten. Der Parameter ToolNameToolNameToolNameToolNametoolName
enthält
den Namen des zu öffnenden Tools. Als Rückgabewert liefert der
Operator im Parameter ToolIdToolIdToolIdToolIdtoolId
die Tool Id. Diese kann dann in
Operatoren, wie dev_set_tool_geometrydev_set_tool_geometryDevSetToolGeometryDevSetToolGeometryDevSetToolGeometry
, dev_show_tooldev_show_toolDevShowToolDevShowToolDevShowTool
und dev_close_tooldev_close_toolDevCloseToolDevCloseToolDevCloseTool
verwendet werden um ein bestimmtes HDevelop
Tool anzusprechen.
Das geöffnete Fenster wird automatisch aktiv.
Wenn der Parameter ToolNameToolNameToolNameToolNametoolName
auf 'halcon_news'"halcon_news""halcon_news""halcon_news""halcon_news"
gesetzt wird, so wird ToolIdToolIdToolIdToolIdtoolId
nur ein leeres Tupel
zurückgegeben, da diese Aktion nur zum Öffnen der News-Seite dient.
Die Parameter GenParamNameGenParamNameGenParamNameGenParamNamegenParamName
und GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue
können verwendet werden um eine bestimmte Seite des Tools anzuzeigen.
Die Verwendung dieser Parameter ist optional. Werden sie auf
[] gesetzt, so wird das Tool mit den Defaulteinstellungen
geöffnet.
Folgende Tools werden unterstützt.
ToolNameToolNameToolNameToolNametoolName |
Hauptfenster |
'graphics_window'"graphics_window""graphics_window""graphics_window""graphics_window" |
Grafikfenster |
'operator_window'"operator_window""operator_window""operator_window""operator_window" |
Operatorfenster |
'program_window'"program_window""program_window""program_window""program_window" |
Programmfenster |
'variable_window'"variable_window""variable_window""variable_window""variable_window" |
Variablenfenster
|
ToolNameToolNameToolNameToolNametoolName |
Assistenten |
'calibration_assistant'"calibration_assistant""calibration_assistant""calibration_assistant""calibration_assistant" |
Calibration Assistent |
'image_acquisition_assistant'"image_acquisition_assistant""image_acquisition_assistant""image_acquisition_assistant""image_acquisition_assistant" |
Image Aquisition Assistent |
'matching_assistant'"matching_assistant""matching_assistant""matching_assistant""matching_assistant" |
Matching Assistent |
'measure1d_assistant'"measure1d_assistant""measure1d_assistant""measure1d_assistant""measure1d_assistant" |
Measure Assistent |
'ocr_assistant'"ocr_assistant""ocr_assistant""ocr_assistant""ocr_assistant" |
OCR Assistent
|
ToolNameToolNameToolNameToolNametoolName |
Tools |
'call_stack'"call_stack""call_stack""call_stack""call_stack" |
Aufrufliste |
'feature_histogram'"feature_histogram""feature_histogram""feature_histogram""feature_histogram" |
Merkmalshistogramm |
'feature_inspection'"feature_inspection""feature_inspection""feature_inspection""feature_inspection" |
Merkmalsinspektion |
'gray_histogram'"gray_histogram""gray_histogram""gray_histogram""gray_histogram" |
Grauwerthistogramm |
'line_profile'"line_profile""line_profile""line_profile""line_profile" |
Linienprofile |
'zoom_window'"zoom_window""zoom_window""zoom_window""zoom_window" |
Zoomfenster |
'ocr_training_file_browser'"ocr_training_file_browser""ocr_training_file_browser""ocr_training_file_browser""ocr_training_file_browser" |
OCR Trainingsdateien Browser
|
ToolNameToolNameToolNameToolNametoolName |
Dialoge |
'browse_examples_dialog'"browse_examples_dialog""browse_examples_dialog""browse_examples_dialog""browse_examples_dialog" |
Beispiele durchsuchen |
'create_procedure_dialog'"create_procedure_dialog""create_procedure_dialog""create_procedure_dialog""create_procedure_dialog" |
Prozedur erstellen |
'edit_procedure_interface_dialog'"edit_procedure_interface_dialog""edit_procedure_interface_dialog""edit_procedure_interface_dialog""edit_procedure_interface_dialog" |
Prozedurschnittstellen bearbeiten |
'find_replace_dialog'"find_replace_dialog""find_replace_dialog""find_replace_dialog""find_replace_dialog" |
Suchen Ersetzen |
'output_console'"output_console""output_console""output_console""output_console" |
Ausgabekonsole |
'quick_navigation'"quick_navigation""quick_navigation""quick_navigation""quick_navigation"
|
Schnellzugriff |
'breakpoints_dialog'"breakpoints_dialog""breakpoints_dialog""breakpoints_dialog""breakpoints_dialog" |
Schnellzugriff / Haltepunkte |
'bookmarks_dialog'"bookmarks_dialog""bookmarks_dialog""bookmarks_dialog""bookmarks_dialog" |
Schnellzugriff / Lesezeichen |
'invalid_lines_dialog'"invalid_lines_dialog""invalid_lines_dialog""invalid_lines_dialog""invalid_lines_dialog" |
Schnellzugriff / Ungültige Zeilen |
'visualization_parameters_dialog'"visualization_parameters_dialog""visualization_parameters_dialog""visualization_parameters_dialog""visualization_parameters_dialog" |
Visualisierungs-Parameter |
'help'"help""help""help""help" |
Hilfefenster |
'preferences'"preferences""preferences""preferences""preferences" |
Einstellungen |
'halcon_news'"halcon_news""halcon_news""halcon_news""halcon_news" |
HALCON News Webseite
|
Weitere Einstellungen können mit GenParamNameGenParamNameGenParamNameGenParamNamegenParamName
und
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue
durchgeführt werden und sind für die folgenden Tools
möglich:
- 'calibration_assistant'"calibration_assistant""calibration_assistant""calibration_assistant""calibration_assistant" - Calibration Assistent:
-
- 'page'"page""page""page""page":
-
Legt die anzuzeigende Seite fest.
Value |
Page |
'setup'"setup""setup""setup""setup" |
Aufbau |
'calibration'"calibration""calibration""calibration""calibration" |
Kalibrierung |
'results'"results""results""results""results" |
Ergebnisse |
'code_generation'"code_generation""code_generation""code_generation""code_generation" |
Codegenerierung
|
Zum Beispiel: dev_open_tool ( 'calibration_assistant',..., 'page',
'results',...)
öffnet den Calibration Assistenten mit der Tab-Karte
Ergebnisse.
- 'image_acquisition_assistant'"image_acquisition_assistant""image_acquisition_assistant""image_acquisition_assistant""image_acquisition_assistant" - Image Aquisition Assistent:
-
- 'page'"page""page""page""page":
-
Legt die anzuzeigende Seite fest.
Value |
Page |
'source'"source""source""source""source" |
Quelle |
'connection'"connection""connection""connection""connection" |
Verbindung |
'parameters'"parameters""parameters""parameters""parameters" |
Parameter |
'code_generation'"code_generation""code_generation""code_generation""code_generation" |
Codegenerierung
|
Zum Beispiel: dev_open_tool ( 'image_acquisition',...,
'page', 'source',...)
öffnet den Image Acquisition Assistenten mit der Tab-Karte
Quelle.
- 'matching_assistant'"matching_assistant""matching_assistant""matching_assistant""matching_assistant" - Matching Assistent:
-
- 'page'"page""page""page""page":
-
Legt die anzuzeigende Seite fest.
Value |
Page |
'model_creation'"model_creation""model_creation""model_creation""model_creation" |
Modellerzeugung |
'model_parameter'"model_parameter""model_parameter""model_parameter""model_parameter" |
Modellparametrierung |
'model_use'"model_use""model_use""model_use""model_use" |
Modellanwendung |
'inspect'"inspect""inspect""inspect""inspect" |
Inspektion |
'code_generation'"code_generation""code_generation""code_generation""code_generation" |
Codegenerierung
|
Zum Beispiel: dev_open_tool ( 'matching_assistant',..., 'page',
'inspect',...)
öffnet den Matching Assistenten mit der Tab-Karte Inspektion.
- 'measure1d_assistant'"measure1d_assistant""measure1d_assistant""measure1d_assistant""measure1d_assistant" - Measure Assistent:
-
- 'page'"page""page""page""page":
-
Legt die anzuzeigende Seite fest.
Value |
Page |
'input'"input""input""input""input" |
Eingabe |
'edges'"edges""edges""edges""edges" |
Kanten |
'fuzzy'"fuzzy""fuzzy""fuzzy""fuzzy" |
Fuzzy |
'results'"results""results""results""results" |
Ergebnisse |
'code_generation'"code_generation""code_generation""code_generation""code_generation"
|
Codegenerierung
|
Zum Beispiel: dev_open_tool ( 'measure1d_assistant',..., 'page', 'edges',...)
öffnet den Measure Assistenten mit der Tab-Karte Kanten.
- 'quick_navigation'"quick_navigation""quick_navigation""quick_navigation""quick_navigation" - Schnellzugriff
-
- 'page'"page""page""page""page":
-
Legt die anzuzeigende Seite fest.
Value |
Page |
'invalid_lines'"invalid_lines""invalid_lines""invalid_lines""invalid_lines" |
Ungültige Zeilen |
'find_results'"find_results""find_results""find_results""find_results" |
Suchergebnisse |
'breakpoints'"breakpoints""breakpoints""breakpoints""breakpoints" |
Haltepunkte |
'bookmarks'"bookmarks""bookmarks""bookmarks""bookmarks"
|
Lesezeichen
|
Zum Beispiel: dev_open_tool ( 'quick_navigation',..., 'page',
'breakpoints',...)
öffnet die Programmzeilenansicht mit der Tab-Karte Haltepunkte.
- 'help'"help""help""help""help" - Hilfefenster:
-
Mögliche Eingaben für GenParamNameGenParamNameGenParamNameGenParamNamegenParamName
sind
'page'"page""page""page""page", 'operator'"operator""operator""operator""operator", 'manual'"manual""manual""manual""manual".
- 'page'"page""page""page""page":
-
Legt die anzuzeigende Seite fest.
Value |
Page |
'contents'"contents""contents""contents""contents" |
Inhalt |
'operator'"operator""operator""operator""operator" |
Operator |
'search'"search""search""search""search" |
Suche |
'index'"index""index""index""index" |
Index |
'bookmarks'"bookmarks""bookmarks""bookmarks""bookmarks" |
Lesezeichen
|
Zum Beispiel: dev_open_tool ( 'help',...,'page', 'search',...)
öffnet die Hilfe und zeigt die Tab-Karte Suche an.
- 'operator'"operator""operator""operator""operator":
-
Legt fest welche Operatortbeschreibung angezeigt werden soll.
Zum Beispiel: dev_open_tool ( 'help',...,
'['page','operator'],['search','read_image'] ...)
öffnet die Hilfe, wählt die Tab-Karte Suche und zeigt die
Beschreibung des Operators read_image.
- 'manual'"manual""manual""manual""manual":
-
Legt das anzuzeigende Manual fest.
- 'preferences'"preferences""preferences""preferences""preferences" - Einstellungen Dialog:
-
- 'page'"page""page""page""page":
-
Die Einstellungen für 'page' sind eine Kombination aus
zwei Werten. Zunächst wird die Gruppe gesetzt und
dannach die Tab-Karte in dieser Gruppe.
Die beiden Werte müssen durch '/' von einander getrennt
werden. Siehe nachfolgendes Beispiel.
Zum Beispiel: dev_open_tool ( 'preferences',...,
'page','user_interface/language', ...) öffnet die Tab-Karte
'language'"language""language""language""language" der Gruppe 'user_interface'"user_interface""user_interface""user_interface""user_interface".
Mögliche Grouppen sind:
Value |
Group |
'user_interface'"user_interface""user_interface""user_interface""user_interface" |
Benutzerschnittstelle |
'procedures'"procedures""procedures""procedures""procedures" |
Prozeduren |
'general_options'"general_options""general_options""general_options""general_options" |
Allgemeine Optionen |
'visualization_settings'"visualization_settings""visualization_settings""visualization_settings""visualization_settings" |
Visualisierung |
'runtime_settings'"runtime_settings""runtime_settings""runtime_settings""runtime_settings" |
Laufzeiteinstellungen
|
- 'user_interface'"user_interface""user_interface""user_interface""user_interface":
-
Legt die anzuzeigende Gruppe fest.
Value |
Page |
'user_interface/program_window'"user_interface/program_window""user_interface/program_window""user_interface/program_window""user_interface/program_window" |
Programmfenster |
'user_interface/fonts'"user_interface/fonts""user_interface/fonts""user_interface/fonts""user_interface/fonts" |
Schriftarten |
'user_interface/language'"user_interface/language""user_interface/language""user_interface/language""user_interface/language" |
Sprache |
'user_interface/layout'"user_interface/layout""user_interface/layout""user_interface/layout""user_interface/layout" |
Layout
|
- 'procedure'"procedure""procedure""procedure""procedure":
-
Legt die anzuzeigende Gruppe fest.
Value |
Page |
'procedures/directories'"procedures/directories""procedures/directories""procedures/directories""procedures/directories" |
Verzeichnisse |
'procedures/external_procedures'"procedures/external_procedures""procedures/external_procedures""procedures/external_procedures""procedures/external_procedures" |
Externe Prozeduren |
'procedures/manage_procedure_libraries'"procedures/manage_procedure_libraries""procedures/manage_procedure_libraries""procedures/manage_procedure_libraries""procedures/manage_procedure_libraries" |
Prozedurbibliothek verwalten |
'procedures/manage_passwords'"procedures/manage_passwords""procedures/manage_passwords""procedures/manage_passwords""procedures/manage_passwords" |
Passwörter verwalten |
'procedures/procedure_use'"procedures/procedure_use""procedures/procedure_use""procedures/procedure_use""procedures/procedure_use" |
Prozedurverwendung |
'procedures/unresolved_procedure_calls'"procedures/unresolved_procedure_calls""procedures/unresolved_procedure_calls""procedures/unresolved_procedure_calls""procedures/unresolved_procedure_calls" |
Nicht aufgelöste Prozeduraufrufe
|
- 'general_options'"general_options""general_options""general_options""general_options":
-
Legt die anzuzeigende Gruppe fest.
Page |
Value |
'general_options/general_options'"general_options/general_options""general_options/general_options""general_options/general_options""general_options/general_options" |
Allgemeine Optionen |
'general_options/experienced_user'"general_options/experienced_user""general_options/experienced_user""general_options/experienced_user""general_options/experienced_user" |
Erfahrener Anwender
|
- 'visualization_settings'"visualization_settings""visualization_settings""visualization_settings""visualization_settings":
-
Legt die anzuzeigende Gruppe fest.
Value |
Page |
'visualization_settings/pen'"visualization_settings/pen""visualization_settings/pen""visualization_settings/pen""visualization_settings/pen" |
Stift |
'visualization_settings/lut'"visualization_settings/lut""visualization_settings/lut""visualization_settings/lut""visualization_settings/lut" |
LUT |
'visualization_settings/paint'"visualization_settings/paint""visualization_settings/paint""visualization_settings/paint""visualization_settings/paint" |
Darstellung
|
- 'runtime_settings'"runtime_settings""runtime_settings""runtime_settings""runtime_settings":
-
Legt die anzuzeigende Gruppe fest.
Value |
Page |
'runtime_settings/runtime_settings'"runtime_settings/runtime_settings""runtime_settings/runtime_settings""runtime_settings/runtime_settings""runtime_settings/runtime_settings" |
Laufzeiteinstellung |
'runtime_settings/override_operator_behavior'"runtime_settings/override_operator_behavior""runtime_settings/override_operator_behavior""runtime_settings/override_operator_behavior""runtime_settings/override_operator_behavior" |
Operatorverhalten aufheben
|
Die Parameter RowRowRowRowrow
und ColumnColumnColumnColumncolumn
können verwendet werden
um das Tool beim Öffnen an eine bstimmte Position zu plazieren.
Zum Verwenden des Standardverhalten, also das Tool and der zuletzt
geöffneten Position zu positionieren, sollte 'default'"default""default""default""default"
übergeben werden.
Die Parameter WidthWidthWidthWidthwidth
und HeightHeightHeightHeightheight
können verwendet werden
um das Tool mit einer bestimmten Größe zu öffnen. Um die zuletzt
verwendete Größe zu verwenden, sollte der Wert ValrRef('default')
übergeben werden.
Mithilfe des Schließen
-Knopfes im Fensterrahmen, oder durch Aufruf
von dev_close_tooldev_close_toolDevCloseToolDevCloseToolDevCloseTool
kann das Tool geschlossen werden.
Achtung
Dieser Operator wird beim Codeexport ignoriert.
Parameter
ToolNameToolNameToolNameToolNametoolName
(input_control) string →
HTupleHTupleHtuple (string) (string) (HString) (char*)
Toolname.
RowRowRowRowrow
(input_control) rectangle.origin.y →
HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)
Zeile der oberen linken Ecke.
Defaultwert:
'default'
"default"
"default"
"default"
"default"
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
ColumnColumnColumnColumncolumn
(input_control) rectangle.origin.x →
HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)
Spalte der oberen linken Ecke.
Defaultwert:
'default'
"default"
"default"
"default"
"default"
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
WidthWidthWidthWidthwidth
(input_control) rectangle.extent.x →
HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)
Breite des Tools.
Defaultwert:
'default'
"default"
"default"
"default"
"default"
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
Restriktion: Width > 0
HeightHeightHeightHeightheight
(input_control) rectangle.extent.y →
HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)
Höhe des Tools.
Defaultwert:
'default'
"default"
"default"
"default"
"default"
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
Restriktion: Height > 0
GenParamNameGenParamNameGenParamNameGenParamNamegenParamName
(input_control) attribute.name(-array) →
HTupleHTupleHtuple (string) (string) (HString) (char*)
Namen der generischen Parameter.
Defaultwert: []
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue
(input_control) attribute.value(-array) →
HTupleHTupleHtuple (string) (string) (HString) (char*)
Werte der generischen Parameter.
Defaultwert: []
ToolIdToolIdToolIdToolIdtoolId
(output_control) dev_tool →
HTupleHTupleHtuple (string) (IntPtr) (HString) (char*)
Tool-Identifikator.
Beispiel (HDevelop)
dev_open_tool ('zoom_window',0, 0, Width, Height, [], [], ToolId)
dev_close_tool (ToolId)
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
dev_set_windowdev_set_windowDevSetWindowDevSetWindowDevSetWindow
den Wert 2 (H_MSG_TRUE).
Andernfalls wird eine Fehlerbehandlung durchgeführt und ein Fehlercode
zurückgeliefert.
Nachfolger
dev_set_tool_geometrydev_set_tool_geometryDevSetToolGeometryDevSetToolGeometryDevSetToolGeometry
,
dev_show_tooldev_show_toolDevShowToolDevShowToolDevShowTool
,
dev_close_tooldev_close_toolDevCloseToolDevCloseToolDevCloseTool
Modul
Foundation