Commande XLOPENFILE

Ouvre un classeur EXCEL.

L’application Excel doit d’abord avoir été ouverte avec EXCELOPEN.

CHGVAR	VAR(&CMD) VALUE('XLOPENFILE')
CHGVAR	VAR(&PARM1) VALUE('Chemin du fichier')
CHGVAR	VAR(&PARM2) VALUE(' [TEXT=True/False] [;ReadOnly=True/False] [;Visible=True/False] [;New=True/False] [;AddToWorkbook=True/False] [;Name="Nom de la feuille"] [;PWD="password"] ')
CALL	PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 + &PARM2 &RESULT)

Paramètres

Parm1

Chemin et nom du fichier à ouvrir. Si seul le fichier est spécifié, il sera alors ouvert dans le répertoire par défaut des documents EXCEL.

Parm2

Parm2 permet de fixer des propriétés pour l’ouverture.

Propriétés:

Text : pour ouvrir le fichier en mode texte. Le fichier doit être du même format que celui créé par LAUNCHER Office (format CSV).
L’option '*TEXT' est aussi accepté pour compatibilité avec les anciennes versions.

ReadOnly : pour ouvrir le fichier en lecture seule.
L’option '*ONLY' est aussi accepté pour compatibilité avec les anciennes versions.

AddToWorkbook : pour ajouter le fichier lu au classeur courant, sous forme d’une nouvelle feuille.
Si aucun classeur n’est ouvert, un nouveau est créé.

Name : permet de donner un nom à la nouvelle feuille du classeur, si l’option AddToWorkbook est aussi choisie.

New : crée un classeur vierge.

Visible : rend visible l’instance de Excel.

PWD : chaîne de caractères qui contient le mot de passe requis pour ouvrir un classeur protégé. Si cet argument est omis et que le classeur nécessite un mot de passe, le classeur est rendu visible, et l'utilisateur est invité à le saisir.

Remarque

En spécifiant l’option Text, LAUNCHER Office va rechercher s’il existe un fichier LFD, qui aurait été créé lors du transfert de fichier. Celui-ci reprend la description du fichier AS/400 pour la reproduire dans le classeur.

Exemples

CHGVAR	VAR(&CMD) VALUE('XLOPENFILE')
CHGVAR	VAR(&PARM1) VALUE('%LNCDIR%\Docs\fichier.xlsx')
CHGVAR	VAR(&PARM2) VALUE(' ')
CALL	PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 + &PARM2 &RESULT)

Dans cet exemple, le fichier sera ouvert depuis le répertoire d’installation de Launcher.

CHGVAR	VAR(&CMD) VALUE('XLOPENFILE')
CHGVAR	VAR(&PARM1) VALUE(' ')
CHGVAR	VAR(&PARM2) VALUE('New;Visible')
CALL	PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 + &PARM2 &RESULT)

Dans cet exemple, un nouveau classeur sera créé et rendu visible.

LNCCMD CMD(EXCELOPEN)

LNCCMD CMD(XLOPENFILE) PARM1('C:\A\base.xlsx')

Dans cet exemple, un classeur est ouvert après avoir créé une instance de l’application Excel.

LNCCMD CMD(EXCELOPEN) LNCCMD CMD(XLOPENFILE) PARM1('%TEMP%\LNC002.TXT') + PARM2('AddToWorkbook;Name="Customers"')

Dans l'exemple ci-dessus, le fichier "LNC002.TXT" est ajouté au classeur actuel sous le nom "Customers".

LNCCMD CMD(EXCELOPEN)
LNCCMD CMD(XLOPENFILE) PARM1('C:\A\protected_workbook.xlsx') PARM2('PWD="aura"')

Dans l'exemple ci-dessus, on ouvre un classeur protégé en spécifiant le mot de passe.

Voir aussi

• XLCLOSFILE

• XLSAVEAS