GetPict Function | |
-- todo --
Displays the Open Picture dialog box and returns the name of the picture file you chose.
You can preview images in Windows 2000 and later by clicking the View Menu icon and then Thumbnails.
X# uses the Thumbnails view as the default setting to provide mini-previews of images. Therefore, the Open Picture dialog box no longer includes a frame
for displaying an image. The Preview check box appears in the Open Picture dialog box only when running X# on operating systems earlier than Windows 2000.
Namespace:
XSharp.VFP
Assembly:
XSharp.VFP (in XSharp.VFP.dll) Version: 2.21
Syntax FUNCTION GetPict(
cFileExtensions,
cFileNameCaption,
cOpenButtonCaption
) AS STRING CLIPPER
[ClipperCallingConventionAttribute(new string[] { ... })]
public static string GetPict(
Usual cFileExtensions = default,
Usual cFileNameCaption = default,
Usual cOpenButtonCaption = default
)
Request Example
View SourceParameters
- cFileExtensions (Optional)
- Type: Usual
Specifies the file extensions of the picture files displayed in the scrollable list when the All Files menu item isn't chosen.
- cFileNameCaption (Optional)
- Type: Usual
Specifies the caption displayed to the left of the File Name text box. cFileNameCaption replaces "File Name" that appears when cFileNameCaption is omitted.
- cOpenButtonCaption (Optional)
- Type: Usual
Specifies a caption for the OK button.
Return Value
Type:
String
Character data type. Returns the name of the picture file you chose.
Remarks
The GetPict( ) function returns the empty string if you exit the Open Picture dialog box by pressing Esc, choosing the Cancel button,
or clicking the Close button. The Open Picture dialog box displayed by typing
GetPict( ) in the Command window makes it possible for you
to quickly locate all the graphic files supported in X#. In versions earlier than X# 8.0, check the Preview check box in the Picture Open dialog box
to display the currently selected graphics file.
The following table lists the graphic file formats that X# supports.
Graphic format | File extention |
---|
Animated Cursor | .ani |
Bitmap | .bmp |
Cursor | .cur |
Device Independent Bitmap | .dib |
Exchangeable Image File | .exif |
Graphics Interchange Format | .gif, .gfa |
Joint Photographic Electronic Group, JPEG File Interchange Format | .jpg, .jpeg, .jpe, .jfif |
Icon | .ico |
Portable Networks Graphics | .png |
Tag Image File Format | .tif, .tiff |
Windows Enhanced Metafile | .emf |
Note |
---|
In X#, cursor, animated cursor, and icon files can be used as graphics files. For example, you can specify an animated cursor file for the
Picture property for the Image control (however, the Image control displays the static representation of the cursor).>
|
Use the Clear RESOURCES command to clear all cached graphic files, including .gif and .jpg files.
cFileExtensions can take the following forms:
See Also