CREATE ALIAS

4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next

version 6.7


CREATE ALIAS (targetPath; aliasPath)

ParameterTypeDescription
targetPathStringName or access path of the alias/shortcut target
aliasPathStringName or full pathname for the alias or shortcut

Description

The CREATE ALIAS command creates an alias (named "shortcut" under Windows) for the target file or folder passed in targetPath. The name and location are defined by the targetPath parameter.

An alias can be made for any kind of document or folder. The alias icon will be the same as the target item. The icon contains a small arrow at the bottom left side. Under Mac OS, the icon name is also displayed in italics characters.

This command does not assign a name by default, the name has to be passed in the aliasPath parameter. If just a name is passed in this parameter, the alias is created in the current working folder (usually the folder containing the structure file).

Note: Under Windows, the shortcuts are designated by a ".LNK" extension (invisible). If this extension is not passed, it is automatically added by the command.

If an empty string is passed in the targetPath, the command does nothing.

Example

Your database generates text files called "Report Number" sorted in the database folder. The user would like to create shortcuts to these reports and to store them at a convenient location:

      `Method CREATE_REPORT
   C_TEXT($vtRport)
   C_STRING(250;$vtpath)
   C_STRING(80;$vaname)
   C_TIME(vDoc)
   C_INTEGER($ReportNber)

   $vTReport:=...    `Create report
   $ReportNber:=...   `Compute the report number
   $vaName:="Report"+String($ReportNber)+".txt"   `File name
   vDoc:=Create document($vaName)
   If (OK=1)
      SEND PACKET(vDoc;$vTReport)
      CLOSE DOCUMENT(vDoc)
         `Add the alias
      CONFIRM("Create an alias for this report?")
      If (OK=1)
         $vtPath:=Select folder("Where do you want the alias to be created?")
         If (OK=1)
            CREATE ALIAS ($vaName;$vtPath+$vaName)
            If (OK=1)
               SHOW ON DISK($vtPath+$vaName)
                  `Show the alias location  
            End if
         End if
      End if
   End if

System Variables or Sets

The OK system variable is set to 1 if the command execution was successful; otherwise it is set to 0.

See Also

RESOLVE ALIAS.


4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next