TABLE OF CONTENTS

UIK:Objects/UIKObj_FileSelector


UIK:Objects/UIKObj_FileSelector

    COPYRIGHT

                 UIKObj_rtFileReq    (c) Jérôme Santini 1993

        Jérôme Santini
        123 rue d'Entraigues
        37000 TOURS
        FRANCE

    FUNCTION

    Ceci  est  un  objet  UIK  qui  peut  être  utilisé  comme  alternative
à UIKObj_FileSelector. Il utilise la requête de la bibliothèque reqtools.

        Bien  que  ReqTools  et UIK fonctionnent en 1.2, cet objet requiert
une dos.library v37+

    Pourquoi, diront certains, une nouvelle requête de fichier alors que UIK
en propose une en standard?
    (1) J'aime avoir le choix
    (2) La requête d'UIK ne me plait pas beaucoup
    (3)  ASL,  (  et  reqtools  qui lui ressemble beaucoup - en mieux ) est
standard:   mieux  vaut  avoir  un  seul  type  de  requête  pour  tous les
programmes

    Voir le programme 'tst' pour un exemple.

    A  noter  que  si  l'objet  à  pour  parent un UIKObj_Toggle, il change
automatiquement l'état de celui-ci qd il est démarré/arrété, et lui ajoute
un vecteur qui UIK_Start/Stop la requête en fonction de GADGETUP.

    STD EVENTS
        Aucun.

    TAGS

        UIKTAG_RTFR_OKFUNC equivalent à UIKTAG_FS_OKFUNC
        		( Voir doc UIKOBJ_FileSelector )
        UIKTAG_RTFR_CANCELFUNC  Idem...
        UIKTAG_RTFR_INITPATH    Idem...
        UIKTAG_RTFR_PATTERN     Idem...
        UIKTAG_RTFR_DirsOnly    Idem...

        UIKTAG_RTFR_ReqPos  Voir  doc  rtEZRequestA()  (je  me  contente de
repasser les valeurs à reqtools)
          Les valeurs possibles sont:
              REQPOS_POINTER
              REQPOS_CENTERSCR
              REQPOS_CENTERWIN
              REQPOS_TOPLEFTSCR
              REQPOS_TOPLEFTWIN   ( valeur par défaut )

        UIKTAG_RTFR_FILE
            Contenu du champ "fichier" de la  requête, au départ.

        UIKTAG_RTFR_StrGad
            Objet String qui sera utilisé par defaut ds les fonctions pubiques,
si un aute string n'est pas spécifié.
            De plus, un vecteur lui est ajouté qui remet à jours la requête
qd on enfonce RETURN/ENTER/ESC/HAUT/BAS. Et de même, l'objet string est remis
à jours qd la requête est 'OK'.

    STRUCTURE
        struct UIKObjRTFR

    CALLBACKS
        Fonction installée par le tag UIKTAG_FS_OKFUNC
        		( Voir doc UIKOBJ_FileSelector )

        Fonction installée par le tag UIKTAG_FS_CANCELFUNC
        		( Voir doc UIKOBJ_FileSelector )

    PUBLIC FUNCTIONS

        UIKFUNC_RTFR_GetFilename
            renvoie le nom du fichier en cours :
                Parm 1 = buffer de taille >= 256 où copier le nom.
                Parm 2 = NULL

        UIKFUNC_RTFR_SetFilename
            Change le fichier en cours ds la requête
            !!! Attention !!! Pour que reqtools en tienne compte, la requête est
        fermée puis réouverte.
                Parm 1 = pointeur sur le nouveau nom
                Parm 2 = NULL

        UIKFUNC_RTFR_ReqToString
            recopie le contenu de la requête ds un objet string.
                Parm  1  ==  NULL  ->  on utilise l'objet défini par le tag
UIKTAG_RTFR_StrGad
                Parm 1 != NULL -> Adresse d'un objet string.
                Parm 2 = NULL

        UIKFUNC_RTFR_StringToReq
            recopie le contenu d'unun objet string ds la requête.
            Même remarque que pour SetFilename.
                Parm  1  ==  NULL  ->  on utilise l'objet défini par le tag
UIKTAG_RTFR_StrGad
                Parm 1 != NULL -> Adresse d'un objet string.
                Parm 2 = NULL