====== zfilesel_GetPathA ======

===== Description =====

Retrieve the selected file name from a file selector variable (''VarID_filesel'').

===== Files =====

^ Declaration | ''Zeolite.h'' |
^ Implementation | ''Zeolite.cpp'' |

===== Function prototype =====

<code="C++">
bool zfilesel_GetPathA(ZVAR hFileSel, ZSTR hReturnStr);
</code>

===== Arguments =====

^  Name  ^  Type  ^ Comment ^
|  //hFileSel//  |  ''ZVAR''  | A [[zeolite:types:ZVAR]] handle to a ''VarID_filesel'' variable, the selected file name of which is to be retrieved. |
|  //hReturnStr//  |  ''ZSTR''  | A [[zeolite:types:ZSTR]] handle to a string variable that is to receive the file name of the file selector variable. |

===== Return value =====

False if an error occurred, and true otherwise.

===== Comments =====

==== Relative path ====

If a non-null value of the //lpDefaultDir// argument was given to the [[zeolite:functions:zfilesel_Init]] function, the path returned by ''zfile_GetPathA'' will be a relative path to the default directory, if a relative path can be made (i.e. on same disk volume, etc.) Callers should check whether the returned path is relative or absolute using the [[zeolite:functions:zfile_IsAbsolutePath]] function.