PRINTERS LIST

PRINTERS LIST ( tabNoms {; tabNomsAlt {; tabModèles}} )

Paramètre	Type		Description
tabNoms	Text array	←	Noms des imprimantes
tabNomsAlt	Text array	←	Windows : Emplacements des imprimantes, macOS : Noms personnalisés des imprimantes
tabModèles	Text array	←	Modèles des imprimantes

Description

La commande PRINTERS LIST remplit le ou les tableau(x) passé(s) en paramètre(s) avec les noms ainsi que, facultativement, les emplacements ou les noms personnalisés et les modèles des imprimantes disponibles pour le poste.

Passez dans le paramètre tabNoms le nom d’un tableau texte. Après l’exécution de la commande, ce tableau contiendra la liste des noms d’imprimantes disponibles. Sous Mac OS, il s'agit des noms “système” fixes.

Note : Si les imprimantes sont gérées via un serveur d’impression (“spouleur”), le chemin d’accès complet (sous Windows) ou le nom du spouleur (sous macOS) est retourné.

Vous pouvez passer un deuxième tableau facultatif, tabNomsAlt. Le contenu de ce tableau dépend de la plate-forme :

• Sous Windows, vous récupérez pour chaque imprimante son emplacement réseau (ou son port local).
• Sous macOS, vous récupérez pour chaque imprimante son nom personnalisé, modifiable par l'utilisateur. Ce nom peut être utilisé par exemple dans des boîtes de dialogue.

Le paramètre facultatif tabModèles permet de récupérer le modèle de chaque imprimante.

Utilisez les commandes SET CURRENT PRINTER et Get current printer pour modifier ou connaître l’imprimante sélectionnée dans 4D. Vous devez leur passer les noms retournés dans le premier tableau (tabNoms).

Sous Windows, le nom d’une imprimante peut être modifié manuellement au niveau du système d’exploitation. En revanche, son emplacement et son modèle sont liés à ses caractéristiques physiques. Vous pouvez donc utiliser les valeurs des tableaux optionnels pour vérifier les caractéristiques de l’imprimante sélectionnée — typiquement, vous pouvez vérifier que tous les clients utilisent la même imprimante.
Sous macOS, cette vérification peut s’effectuer sur le nom de l’imprimante (nom du serveur d’impression), qui est le même pour chaque poste connecté.

Variables et ensembles système

La variable système OK prend la valeur 1 si la commande a été exécutée correctement, sinon elle prend la valeur 0 et les tableaux sont retournés vides.

Voir aussi

Get current printer
SET CURRENT PRINTER

Propriétés

Numéro de commande	789
Thread safe	✗
Modifie les variables	OK