4D Doc Center : MSG

4D Internet Commands v14

MSG_SetPrefs


MSG_SetPrefs ( retoursLigne ; dossierMsg ; dossierDocsJoints ) -> Résultat

Paramètre	Type	Description
retoursLigne	Entier	0 = Ne pas retirer les retours à la ligne, 1 = Retirer les retours à la ligne, -1 = Aucune modification
dossierMsg	Texte	Chemin d’accès au dossier des messages ("" = aucune modification)
dossierDocsJoints	Texte	Chemin d’accès du dossier des documents joints ("" = aucune modification)
Résultat	Entier	Code d’erreur

Description

La commande MSG_SetPrefs définit des préférences générales pour toutes les commandes MSG ultérieures.

Le paramètre retoursLigne vous permet de préciser comment traiter les caractères de retour à la ligne dans les messages téléchargés. La plupart des messages Internet associent un caractère Retour chariot (Carriage return) et un caractère Retour à la ligne (Line feed) pour indiquer la fin d’une ligne, à la différence des applications Macintosh qui requièrent un simple Retour chariot. Dans ce cas, cette option vous permet de supprimer les caractères Retour à la ligne superflus du texte des messages.

Si vous passez 0 (zéro) les messages récupérés seront conservés dans leur format initial.
Si vous passez 1, les caractères Retour à la ligne seront supprimés des messages récupérés.
Si vous passez -1, l’option reste telle qu’elle était précédemment définie.

Par défaut, cette option a pour valeur 1, les retours à la ligne rencontrés dans les messages sont automatiquement supprimés.

Le paramètre dossierMsg indique le chemin d’accès local du dossier dans lequel les messages récupérés doivent être enregistrés par défaut.

Note de compatibilité (version 6.8.1) : Si la commande MSG_SetPrefs n’est pas utilisée, ce sont les paramètres retoursLigne et dossierMsg de la commande POP3_SetPrefs qui seront pris en compte — si cette dernière a été préalablement exécutée. Si la commande MSG_SetPrefs est utilisée, les paramètres retoursLigne et dossierMsg de la commande POP3_SetPrefs seront ignorés.

Le paramètre dossierDocsJoints indique le chemin d’accès local du dossier dans lequel les fichiers joints doivent être enregistrés lorsque la commande MSG_Extract extrait les documents joints du corps du message.

Note de compatibilité (version 6.8.1) : Ce paramètre est également présent dans la commande POP3_SetPrefs, par conséquent vous pouvez le fixer à l’aide de l’une de ces deux commandes. L’usage de la commande MSG_SetPrefs est toutefois fortement recommandé. Le paramètre de la commande POP3_SetPrefs, conservé pour des raisons de compatibilité, ne sera plus utilisé dans les prochaines versions du plug-in (ce paramètre est désormais optionnel). Cette recommandation s’applique également à la commande POP3_GetPrefs.