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....


Home BasePack FileSys TUnivSaveDialog Methods Execute
See also: FileName, Parameters, UseStandardDialog, OnFileSelect, OnFileCheck, OnOverwrite, ParentWnd 

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: 2023-Feb-06