Returns a APicture object that contains the form image including the form controls, background, border and caption.
[ pic = ] Object.Image( [bIncludeNonClientArea=True] )
The Image property syntax has the following parts:
|
Name |
Type |
Description |
|
Object |
AForm |
AForm object |
|
bIncludeNonClientArea |
Bool |
Flag indicating whether Non-client area of Image should be included or not. By default True - It include. |
|
pic |
A handle (from Microsoft Windows) to a persistent graphic. |
The Image contains the form client area and non-client area. The client area displays the form background, controls and menus. The non-client area displays the form border and caption area. Use the picture property to set the background image of the client area.
In ATEasy 5.0, the user can use the flag, bIncludeNonClientArea not to include the non-client area.
An object's AutoRedraw property determines whether the repainting of an object occurs with a persistent graphics or through Paint events. The Windows operating environment identifies an object's persistent graphic by assigning a handle to it. The Image property can be used to get this handle. An Image value exists regardless of the setting for the AutoRedraw property. If AutoRedraw is True and nothing has been drawn, the image displays only the color set by the BackColor property and the picture. The AutoRedraw property can cause Image, which is a handle to a bitmap, to change. When AutoRedraw is True, an object's hDC property becomes a handle to a device context that contains the bitmap returned by Image.
You can assign the value of Image to the Picture property of an AImage control . The Image property also provides a value to pass to Windows API calls.
The Image is usually used to save the screen capture of the form with the SavePicture function, or when placing something on the Clipboard.
During OnLoad event the Image will not contain the proper Form Image since its image was not created yet.
The following statement saves the form image to a JPEG file:
SavePicture(Image, "c:\\temp\\a.jpg")
AutoRedraw, BackColor, hDC, OnPaint, Picture, SavePicture