VarCreateFolderPopup Function (ROM Call 0x28F)

menus.h

HANDLE VarCreateFolderPopup (unsigned short *CurIndex, unsigned short Flags);

Creates a popup menu containing a list of all folders.

VarCreateFolderPopup creates a dynamic popup (or pulldown) menu which contains a list of all folders in the VAT folder table, and returns a handle to it (or H_NULL in case of an error).

The parameter Flags is usually zero, but it may contain additional flags from the enum VCFPFlags:

VCFP_ALL "All" is included as the first option in the list, like in the "View" dialog of the Var-Link window.
VCFP_SKIP_CURDIR The currently active folder is not included in the list.

This function also stores the index of the currently active folder in the word pointed to by CurIndex.

Note: You need to free the returned handle later by calling HeapFree.

This routine may cause heap compression.


Uses: PopupAddText, PopupNew, HeapFree, XR_stringPtr, FolderOp, SymCpy0, SymFindFirst, SymFindNext
Used by: VarNew, VarOpen, VarSaveAs, MO_modeDialog