Printer.Write, méthode

Article
09/04/2008

Mise à jour : novembre 2007

Imprime le texte sur une page sans ajouter de retour chariot.

Espace de noms : Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

Public Sub Write ( _
    ParamArray args As Object() _
)

Dim instance As Printer
Dim args As Object()

instance.Write(args)

public void Write(
    params Object[] args
)

public:
void Write(
    ... array<Object^>^ args
)

public function Write(
    ... args : Object[]
)

Paramètres

args
Type : array<System.Object[]

Tableau de paramètres contenant des paramètres d'impression facultatifs.

Notes

La méthode Write réinitialise CurrentX et CurrentY à la fin de la ligne active après son exécution. Pour déplacer à la ligne suivante après l'impression (insérer un retour chariot), appelez plutôt la méthode Print.

Plusieurs expressions peuvent être séparées par un espace ou un point-virgule.

Remarque :
Étant donné que la méthode Print imprime en général avec des caractères espacés de façon proportionnelle, il n'y a aucune corrélation entre le nombre de caractères imprimé et le nombre de colonnes à largeur fixe que ces caractères occupent. Par exemple, une lettre large, telle qu'un « W », occupe plusieurs colonnes à largeur fixe et une lettre étroite, telle qu'un « i », occupe moins d'une colonne. Pour tenir compte des cas dans lesquels des caractères plus larges que la moyenne sont utilisés, vos colonnes tabulaires doivent être positionnées suffisamment loin les unes des autres. Vous pouvez également imprimer dans une police à pas fixe (tel que Courrier) pour vous assurer que chaque caractère occupe une seule colonne.

Étant donné que la méthode Print imprime en général avec des caractères espacés de façon proportionnelle, il n'y a aucune corrélation entre le nombre de caractères imprimé et le nombre de colonnes à largeur fixe que ces caractères occupent. Par exemple, une lettre large, telle qu'un « W », occupe plusieurs colonnes à largeur fixe et une lettre étroite, telle qu'un « i », occupe moins d'une colonne. Pour tenir compte des cas dans lesquels des caractères plus larges que la moyenne sont utilisés, vos colonnes tabulaires doivent être positionnées suffisamment loin les unes des autres. Vous pouvez également imprimer dans une police à pas fixe (tel que Courrier) pour vous assurer que chaque caractère occupe une seule colonne.

Le tableau de paramètres args() emploie la syntaxe et les éléments suivants :

{Spc(n) | Tab(n)} expressioncharPos

Paramètre	Description
)n Spc(	Facultatif. Utilisé pour insérer des espaces dans la sortie, où n est le nombre d'espaces à insérer.
)n Tab(	Facultatif. Utilisé pour placer le point d'insertion sur un numéro de colonne absolu, où n est le numéro de colonne. Utilisez Tab sans argument pour positionner le point d'insertion au début de la zone d'impression suivante.
expression	Facultatif. Expression numérique ou expression de chaîne à imprimer.
charPos	Facultatif. Spécifie le point d'insertion pour le caractère suivant. Utilisez un point-virgule (;) pour positionner le point d'insertion juste après le dernier caractère affiché. Utilisez Tab(n) pour placer le point d'insertion sur un numéro de colonne absolu, où n est le numéro de colonne. Utilisez Tab sans argument pour positionner le point d'insertion au début de la zone d'impression suivante. Si charPos est omis, le caractère suivant est imprimé sur la ligne suivante.

Remarque :
Les fonctions et objets de l'espace de noms Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 sont fournis pour être utilisés par les outils permettant de mettre à niveau à partir de Visual Basic 6.0 vers Visual Basic 2008. Dans la plupart des cas, ces fonctions et objets dupliquent les fonctionnalités que vous pouvez trouver dans d'autres espaces de noms dans le .NET Framework. Ils sont nécessaires uniquement lorsque le modèle de code Visual Basic 6.0 diffère considérablement de l'implémentation du .NET Framework.

Les fonctions et objets de l'espace de noms Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 sont fournis pour être utilisés par les outils permettant de mettre à niveau à partir de Visual Basic 6.0 vers Visual Basic 2008. Dans la plupart des cas, ces fonctions et objets dupliquent les fonctionnalités que vous pouvez trouver dans d'autres espaces de noms dans le .NET Framework. Ils sont nécessaires uniquement lorsque le modèle de code Visual Basic 6.0 diffère considérablement de l'implémentation du .NET Framework.

Exemples

L'exemple de code suivant illustre la méthode Print.

Dim Printer As New Printer

Autorisations

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.