4D v16.3

GET DOCUMENT ICON

Home

 
4D v16.3
GET DOCUMENT ICON

GET DOCUMENT ICON 


 

GET DOCUMENT ICON ( docPath ; icon {; size} ) 
Parameter Type   Description
docPath  String in Name or path of document to get icon, or Empty string for standard Open File dialog box
icon  Picture field, Picture variable in Document icon
size  Longint in Size of the returned picture (in pixels)

The GET DOCUMENT ICON command returns, in the 4D picture variable or field icon, the icon of the document whose name or complete pathname is passed in docPath. docPath can specify a file of any type (executable, document, shortcut or alias, etc.) or a folder.

docPath contains the full pathname of the document. You can also pass the document name only or a relative pathname, in this case the document must be placed in the database current working directory (usually, the folder containing the database structure file).
If you pass an empty string in docPath, the standard Open File dialog box appears. The user can then select the file to read. Once the dialog box is validated, the Document system variable contains the full pathname to the selected file.

Pass a 4D picture field or variable in icon. After the command is executed, this parameter contains the icon of the file (PICT format).

The optional size parameter sets the dimensions in pixels of the returned icon. This value actually represents the side length of the square including the icon. Icons are usually defined in 32x32 pixels (“large icons”) or 16x16 pixels (“small icons”). If you pass 0 or omit this parameter, the largest available icon is returned.

 
PROPERTIES 

Product: 4D
Theme: System Documents
Number: 700

This command modifies the system Document variableThis command modifies the Error system variable

 
HISTORY 

Created: 4D v6.7

 
ARTICLE USAGE

4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)