SL_FileRequesterA


NAME
SL_FileRequesterA -- brings up a file requester.
SL_FileRequester -- varags stub.

SYNOPSIS
success = SL_FileRequesterA(apphandle, type, buff, bufflen, tags);
D0 A0 D0 A1 D1 A2

SLFLAG SL_FileRequesterA(APPHANDLE, UWORD, SLCHAR *, UWORD, struct TagItem *);

success = SL_FileRequester(apphandle, type, buff, bufflen, tag1, ...);

SLFLAG SL_FileRequester(APPHANDLE, UWORD, SLCHAR *, UWORD, Tag, ...);

FUNCTION
This call presents a file requester to the user and allows them to
choose a file from it.

INPUTS
apphandle - as returned by SL_AppInitA.
type - one of FILEREQ_LOAD, FILEREQ_SAVE, or FILEREQ_DRAWER.
buff - a buffer to hold the selected path and file.
bufflen - the maximum length of buff.
tags - pointer to a tag list. see the tag definitions below.

RESULTS
success - TRUE if the user selected a file, FALSE if no file was selected.

TAGS
FILEREQ_Title (SLCHAR *) - This is used to set the title of the file
requester.

FILEREQ_InitialPath (SLCHAR *) - This is the initial path the file
requester will be opened up with.

FILEREQ_InitialFile (SLCHAR *) - This is the intial file the file
requester will come up with.

FILEREQ_PositiveText (SLCHAR *) - This is the text to use for the positive
or "Ok" button in the file requester.

FILEREQ_NegativeText(SLCHAR *) - This is the text to use for the negative
or "Cancel" button in the file requester.

FILEREQ_UpdateIntialPath (SLFLAG) - If TRUE then the Initial path string
will be updated with the selected path if the user selects a
file and ok's the requester. The default is FALSE.

FILEREQ_UpdateIntialFile (SLFLAG) - If TRUE then the Initial file string
will be updated with the selected file if the user selects a
file and ok's the requester. The default is FALSE.

NOTES
This functions puts the calling app into a wait state via SL_AppWaitState.

SEE ALSO
SL_AlertRequesterA, SL_BusyRequesterA, SL_FileRequesterAdd Page, SL_FontRequester, SL_ScreenRequester.

 

SL_FileRequesterA  Command Section By Type  url:SL_FileRequesterA
  created:2008-03-01 23:36:15   last updated:2008-03-01 23:36:15
  Copyright © 1985-2024 GrasshopperLLC. All Rights Reserved.

User Contributed Comments For SL_FileRequesterA
There are no user contributed comments for this page.