Syntax
|
Picture
X,Y,width,height,PictureName$,PictureType [,[.Identifier] [,style]]
|
Description
|
Creates a picture control in a dialog box template.
|
Comments
|
Picture controls are used for the display of graphics images only. The user cannot interact with these controls.
The
Picture
statement accepts the following parameters:
|
|
Parameter
|
Description
|
|
X, Y
|
Integer coordinates specifying the position of the control (in dialog units) static to the upper left corner of the dialog box.
|
|
width, height
|
Integer coordinates specifying the dimensions of the control in dialog units.
|
|
PictureName$
|
String containing the name of the picture. If PictureType is 0, then this name specifies the name of the file containing the image. If PictureType is 10, then PictureName$ specifies the name of the image within the resource of the picture library.
If PictureName$ is empty, then no picture will be associated with the control. A picture can later be placed into the picture control using the
DlgSetPicture
statement.
|
|
PictureType
|
Integer specifying the source for the image. The following sources are supported:
|
|
|
0
|
The image is contained in a file on disk.
|
|
|
10
|
The image is contained in a picture library as specified by the PicName$ parameter on the Begin Dialog statement.
|
|
.Identifier
|
Name by which this control can be referenced by statements in a dialog function (such as
DlgFocus
and
DlgEnable
). If omitted, then the first two words of PictureName$ are used.
|
|
style
|
Specifies whether the picture is drawn within a 3D frame. It can be any of the following values:
|
|
|
0
|
Draw the picture control with a normal frame.
|
|
|
1
|
Draw the picture control with a 3D frame.
|
|
|
If omitted, then the picture control is drawn with a normal frame.
|
|
The picture control extracts the actual image from either a disk file or a picture library. In the case of bitmaps, both 2- and 16-color bitmaps are supported. In the case of WMFs, the Basic Control Engine supports the Placeable Windows Metafile.
If PictureName$ is a zero-length string, then the picture is removed from the picture control, freeing any memory associated with that picture.
|
Example 1
|
This first example shows how to use a picture from a file.
Sub Main()
Begin Dialog LogoDialogTemplate 16,32,288,76,"Introduction"
OKButton 240,8,40,14
Picture 8,8,224,64,"c:\bitmaps\logo.bmp",0,.Logo
End Dialog
Dim LogoDialog As LogoDialogTemplate
Dialog LogoDialog
End Sub
|
Example 2
|
This second example shows how to use a picture from a picture library with a 3D frame.
Sub Main()
Begin Dialog LogoDialogTemplate 16,31,288,76,"Introduction",,"pictures.dll"
OKButton 240,8,40,14
Picture 8,8,224,64,"CompanyLogo",10,.Logo,1
End Dialog
Dim LogoDialog As LogoDialogTemplate
Dialog LogoDialog
End Sub
|
See Also
|
CancelButton (statement); CheckBox (statement); ComboBox (statement); Dialog (function); Dialog (statement); DropListBox (statement); GroupBox (statement); ListBox (statement); OptionButton (statement); OptionGroup (statement); PushButton (statement); Text (statement); TextBox (statement); Begin
Dialog (statement), PictureButton (statement); DlgSetPicture (statement).
|
Notes
|
Picture controls can contain either a bitmap or a WMF (Windows metafile). When extracting images from a picture library, the Basic Control Engine assumes that the resource type for metafiles is 256.
Picture libraries are implemented as DLLs on the Windows and Win32 platforms.
|