PrinterSettings Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Spécifie des informations sur l’impression d’un document, y compris l’imprimante qui l’imprime, lors de l’impression à partir d’une application Windows Forms.
public ref class PrinterSettings : ICloneable
public class PrinterSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
[System.Serializable]
public class PrinterSettings : ICloneable
type PrinterSettings = class
interface ICloneable
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Serializable>]
type PrinterSettings = class
interface ICloneable
[<System.Serializable>]
type PrinterSettings = class
interface ICloneable
Public Class PrinterSettings
Implements ICloneable
- Héritage
-
PrinterSettings
- Attributs
- Implémente
Exemples
L’exemple de code suivant imprime un document sur l’imprimante spécifiée. L’exemple présente trois prérequis :
Une variable nommée
filePatha été définie sur le chemin d’accès du fichier à imprimer.Une méthode nommée
pd_PrintPage, qui gère l’événement PrintPage , a été définie.Une variable nommée
printera été définie sur le nom de l’imprimante.
Utilisez les espaces de noms et System.Drawing les System.Drawing.Printingespaces System.IOde noms pour cet exemple.
public:
void Printing( String^ printer )
{
try
{
streamToPrint = gcnew StreamReader( filePath );
try
{
printFont = gcnew System::Drawing::Font( "Arial",10 );
PrintDocument^ pd = gcnew PrintDocument;
pd->PrintPage += gcnew PrintPageEventHandler(
this, &Form1::pd_PrintPage );
// Specify the printer to use.
pd->PrinterSettings->PrinterName = printer;
if ( pd->PrinterSettings->IsValid )
{
pd->Print();
}
else
{
MessageBox::Show( "Printer is invalid." );
}
}
finally
{
streamToPrint->Close();
}
}
catch ( Exception^ ex )
{
MessageBox::Show( ex->Message );
}
}
public void Printing(string printer) {
try {
streamToPrint = new StreamReader (filePath);
try {
printFont = new Font("Arial", 10);
PrintDocument pd = new PrintDocument();
pd.PrintPage += new PrintPageEventHandler(pd_PrintPage);
// Specify the printer to use.
pd.PrinterSettings.PrinterName = printer;
if (pd.PrinterSettings.IsValid) {
pd.Print();
}
else {
MessageBox.Show("Printer is invalid.");
}
}
finally {
streamToPrint.Close();
}
}
catch(Exception ex) {
MessageBox.Show(ex.Message);
}
}
Public Sub Printing(printer As String)
Try
streamToPrint = New StreamReader(filePath)
Try
printFont = New Font("Arial", 10)
Dim pd As New PrintDocument()
AddHandler pd.PrintPage, AddressOf pd_PrintPage
' Specify the printer to use.
pd.PrinterSettings.PrinterName = printer
If pd.PrinterSettings.IsValid then
pd.Print()
Else
MessageBox.Show("Printer is invalid.")
End If
Finally
streamToPrint.Close()
End Try
Catch ex As Exception
MessageBox.Show(ex.Message)
End Try
End Sub
Remarques
En règle générale, vous accédez à un accès via PrinterSettings ou PrintDocument.PrinterSettings à des PageSettings.PrinterSettings propriétés pour modifier les paramètres de l’imprimante. Le paramètre d’imprimante le plus courant est PrinterName, qui spécifie l’imprimante à imprimer.
Pour plus d’informations sur l’impression avec Windows Forms, consultez la vue d’ensemble de l’espace System.Drawing.Printing de noms. Si vous souhaitez imprimer à partir d’une application Windows Presentation Foundation, consultez l’espace System.Printing de noms.
Note
Dans .NET 6 et versions ultérieures, le package System.Drawing.Common, qui inclut ce type, n’est pris en charge que sur les systèmes d’exploitation Windows. L’utilisation de ce type dans les applications multiplateformes provoque des avertissements au moment de la compilation et des exceptions d’exécution. Pour plus d’informations, consultez System.Drawing.Common uniquement pris en charge sur Windows.
Constructeurs
| Nom | Description |
|---|---|
| PrinterSettings() |
Initialise une nouvelle instance de la classe PrinterSettings. |
Propriétés
| Nom | Description |
|---|---|
| CanDuplex |
Obtient une valeur indiquant si l’imprimante prend en charge l’impression double face. |
| Collate |
Obtient ou définit une valeur indiquant si le document imprimé est compilé. |
| Copies |
Obtient ou définit le nombre de copies du document à imprimer. |
| DefaultPageSettings |
Obtient les paramètres de page par défaut pour cette imprimante. |
| Duplex |
Obtient ou définit le paramètre d’imprimante pour l’impression double face. |
| FromPage |
Obtient ou définit le numéro de page de la première page à imprimer. |
| InstalledPrinters |
Obtient les noms de toutes les imprimantes installées sur l’ordinateur. |
| IsDefaultPrinter |
Obtient une valeur indiquant si la PrinterName propriété désigne l’imprimante par défaut, sauf lorsque l’utilisateur définit PrinterNameexplicitement . |
| IsPlotter |
Obtient une valeur indiquant si l’imprimante est un plotter. |
| IsValid |
Obtient une valeur indiquant si la PrinterName propriété désigne une imprimante valide. |
| LandscapeAngle |
Obtient l’angle, en degrés, que l’orientation portrait est pivotée pour produire l’orientation paysage. |
| MaximumCopies |
Obtient le nombre maximal de copies que l’imprimante permet à l’utilisateur d’imprimer à la fois. |
| MaximumPage |
Obtient ou définit la valeur maximale FromPage ou ToPage qui peut être sélectionnée dans un PrintDialog. |
| MinimumPage |
Obtient ou définit le minimum FromPage ou ToPage qui peut être sélectionné dans un PrintDialog. |
| PaperSizes |
Obtient les tailles de papier prises en charge par cette imprimante. |
| PaperSources |
Obtient les bacs sources de papier disponibles sur l’imprimante. |
| PrinterName |
Obtient ou définit le nom de l’imprimante à utiliser. |
| PrinterResolutions |
Obtient toutes les résolutions prises en charge par cette imprimante. |
| PrintFileName |
Obtient ou définit le nom du fichier lors de l’impression dans un fichier. |
| PrintRange |
Obtient ou définit les numéros de page que l’utilisateur a spécifiés pour être imprimés. |
| PrintToFile |
Obtient ou définit une valeur indiquant si la sortie d’impression est envoyée à un fichier au lieu d’un port. |
| SupportsColor |
Obtient une valeur indiquant si cette imprimante prend en charge l’impression de couleurs. |
| ToPage |
Obtient ou définit le nombre de la dernière page à imprimer. |
Méthodes
| Nom | Description |
|---|---|
| Clone() |
Crée une copie de ce PrinterSettingsfichier . |
| CreateMeasurementGraphics() |
Retourne une Graphics valeur qui contient des informations sur l’imprimante utiles lors de la création d’un PrintDocumentfichier . |
| CreateMeasurementGraphics(Boolean) |
Retourne une Graphics valeur qui contient des informations sur l’imprimante, en spécifiant éventuellement l’origine aux marges. |
| CreateMeasurementGraphics(PageSettings, Boolean) |
Crée un Graphics associé aux paramètres de page spécifiés et spécifie éventuellement l’origine aux marges. |
| CreateMeasurementGraphics(PageSettings) |
Retourne une Graphics valeur qui contient des informations d’imprimante associées à l’objet spécifié PageSettings. |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetHdevmode() |
Crée un handle dans une |
| GetHdevmode(PageSettings) |
Crée un handle dans une |
| GetHdevnames() |
Crée un handle dans une |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| IsDirectPrintingSupported(Image) |
Obtient une valeur indiquant si l’imprimante prend en charge l’impression du fichier image spécifié. |
| IsDirectPrintingSupported(ImageFormat) |
Retourne une valeur indiquant si l’imprimante prend en charge l’impression du format d’image spécifié. |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| SetHdevmode(IntPtr) |
Copie les informations pertinentes à partir du handle donné et dans le PrinterSettings. |
| SetHdevnames(IntPtr) |
Copie les informations pertinentes à partir du handle donné et dans le PrinterSettings. |
| ToString() |
Fournit des informations sur le PrinterSettings formulaire de chaîne. |