The SDL Component Suite is an industry leading collection of components supporting scientific and engineering computing. Please visit the SDL Web site for more information....



Execute


Unit:SDL_filesys
Class:TUnivSaveDialog
Declaration:function Execute: boolean;

The method Execute opens the save dialog (which is either the standard Delphi/C++Builder save dialog if UseStandardDialog is TRUE, or a customized dialog), returning TRUE when the user selects a file name and clicks OK. If the user cancels the save operation, Execute returns a FALSE value.

Hint 1: A more detailed description of the usage of the dialog is provided in the survey.

Hint 2: If UseStandardDialog is TRUE, the Delphi standard save dialog may receive parameters (e.g. an invalid pre-set filename) which prevents it from functioning correctly. In this case an exception is raised which displays the error number as a hexadecimal code. The meaning of the error code is as follows:
    CDERR_STRUCTSIZE       = $0001;
    CDERR_INITIALIZATION   = $0002;
    CDERR_NOTEMPLATE       = $0003;
    CDERR_NOHINSTANCE      = $0004;
    CDERR_LOADSTRFAILURE   = $0005;
    CDERR_FINDRESFAILURE   = $0006;
    CDERR_LOADRESFAILURE   = $0007;
    CDERR_LOCKRESFAILURE   = $0008;
    CDERR_MEMALLOCFAILURE  = $0009;
    CDERR_MEMLOCKFAILURE   = $000A;
    CDERR_NOHOOK           = $000B;
    CDERR_REGISTERMSGFAIL  = $000C;
    FNERR_FILENAMECODES    = $3000;
    FNERR_SUBCLASSFAILURE  = $3001;
    FNERR_INVALIDFILENAME  = $3002;
    FNERR_BUFFERTOOSMALL   = $3003;
More information about these error codes can be found in the Delphi/C++Builder help (topic "CommDlgExtendedError").



Last Update: 2013-May-14