get_window_background_imageT_get_window_background_imageGetWindowBackgroundImageGetWindowBackgroundImageget_window_background_image (算子)

名称

get_window_background_imageT_get_window_background_imageGetWindowBackgroundImageGetWindowBackgroundImageget_window_background_image — 获取 HALCON 窗口背景图像的副本。

签名

get_window_background_image( : BackgroundImage : WindowHandle : )

描述

get_window_background_imageget_window_background_imageGetWindowBackgroundImageGetWindowBackgroundImageGetWindowBackgroundImageget_window_background_image returns a copy of the background image BackgroundImageBackgroundImageBackgroundImageBackgroundImagebackgroundImagebackground_image set in the window WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle. This operator is specially useful in cases where the user would like to perform some operations in one of the callback functions of a drawing object attached to the window. See set_drawing_object_callbackset_drawing_object_callbackSetDrawingObjectCallbackSetDrawingObjectCallbackSetDrawingObjectCallbackset_drawing_object_callback for more details.

执行信息

多线程类型：可重入（与非独占算子并行运行）。
多线程作用域：全局（可从任何线程调用）。
未采用并行化处理。

参数

BackgroundImageBackgroundImageBackgroundImageBackgroundImagebackgroundImagebackground_image (输出对象) (multichannel-)image → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Copy of the background image.

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (输入控制) window → (handle)

窗口句柄。

结果

如果窗口存在且指定参数正确 get_window_background_imageget_window_background_imageGetWindowBackgroundImageGetWindowBackgroundImageGetWindowBackgroundImageget_window_background_image 返回 2 ( H_MSG_TRUE )。如有必要，则抛出异常。

可能的前趋

attach_background_to_windowattach_background_to_windowAttachBackgroundToWindowAttachBackgroundToWindowAttachBackgroundToWindowattach_background_to_window

可能的后继

close_windowclose_windowCloseWindowCloseWindowCloseWindowclose_window, detach_background_from_windowdetach_background_from_windowDetachBackgroundFromWindowDetachBackgroundFromWindowDetachBackgroundFromWindowdetach_background_from_window, attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindowattach_drawing_object_to_window

另见

attach_background_to_windowattach_background_to_windowAttachBackgroundToWindowAttachBackgroundToWindowAttachBackgroundToWindowattach_background_to_window, detach_drawing_object_from_windowdetach_drawing_object_from_windowDetachDrawingObjectFromWindowDetachDrawingObjectFromWindowDetachDrawingObjectFromWindowdetach_drawing_object_from_window

模块

基础

算子