Margins Klasse

Definition

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Quelle:

Margins.cs

Gibt die Abmessungen der Seitenränder einer gedruckten Seite an.

public ref class Margins : ICloneable

[System.ComponentModel.TypeConverter(typeof(System.Drawing.Printing.MarginsConverter))]
public class Margins : ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Drawing.Printing.MarginsConverter))>]
type Margins = class
    interface ICloneable

Public Class Margins
Implements ICloneable

Vererbung

Object

Margins

Attribute

TypeConverterAttribute

Implementiert

ICloneable

Beispiele

Verwenden Sie die System.DrawingNamespaces System.Drawing.Printingund System.IO die Namespaces für dieses Beispiel.

Im folgenden Codebeispiel werden die Standardseiteneinstellungen für ein Dokument auf Ränder von jeweils 1 Zoll festgelegt.

void Printing()
{
   try
   {
      
      /* This assumes that a variable of type string, named filePath,
              has been set to the path of the file to print. */
      streamToPrint = gcnew StreamReader( filePath );
      try
      {
         printFont = gcnew System::Drawing::Font( "Arial",10 );
         PrintDocument^ pd = gcnew PrintDocument;
         
         /* This assumes that a method, named pd_PrintPage, has been
                   defined. pd_PrintPage handles the PrintPage event. */
         pd->PrintPage += gcnew PrintPageEventHandler( this, &Sample::pd_PrintPage );
         
         /* This assumes that a variable of type string, named 
                   printer, has been set to the printer's name. */
         pd->PrinterSettings->PrinterName = printer;
         
         // Create a new instance of Margins with one inch margins.
         Margins^ margins = gcnew Margins( 100,100,100,100 );
         pd->DefaultPageSettings->Margins = margins;
         pd->Print();
      }
      finally
      {
         streamToPrint->Close();
      }

   }
   catch ( Exception^ ex ) 
   {
      MessageBox::Show( String::Concat( "An error occurred printing the file - ", ex->Message ) );
   }

}

public void Printing()
{
  try 
  {
    /* This assumes that a variable of type string, named filePath,
       has been set to the path of the file to print. */
    streamToPrint = new StreamReader (filePath);
    try 
    {
      printFont = new Font("Arial", 10);
      PrintDocument pd = new PrintDocument(); 
      /* This assumes that a method, named pd_PrintPage, has been
         defined. pd_PrintPage handles the PrintPage event. */
      pd.PrintPage += new PrintPageEventHandler(pd_PrintPage);
      /* This assumes that a variable of type string, named 
         printer, has been set to the printer's name. */
      pd.PrinterSettings.PrinterName = printer;
      // Create a new instance of Margins with one inch margins.
      Margins margins = new Margins(100,100,100,100);
      pd.DefaultPageSettings.Margins = margins;
      pd.Print();
    } 
    finally 
    {
      streamToPrint.Close() ;
    }
  } 
  catch(Exception ex) 
  { 
    MessageBox.Show("An error occurred printing the file - " + ex.Message);
  }
}

Public Sub Printing()
    Try
        ' This assumes that a variable of type string, named filePath,
        ' has been set to the path of the file to print. 
        streamToPrint = New StreamReader(filePath)
        Try
            printFont = New Font("Arial", 10)
            Dim pd As New PrintDocument()
            ' This assumes that a method, named pd_PrintPage, has been
            ' defined. pd_PrintPage handles the PrintPage event. 
            AddHandler pd.PrintPage, AddressOf pd_PrintPage
            ' This assumes that a variable of type string, named
            ' printer, has been set to the printer's name. 
            pd.PrinterSettings.PrinterName = printer
            ' Create a new instance of Margins with one inch margins.
            Dim margins As New Margins(100, 100, 100, 100)
            pd.DefaultPageSettings.Margins = margins
            pd.Print()
        Finally
            streamToPrint.Close()
        End Try
    Catch ex As Exception
        MessageBox.Show("An error occurred printing the file - " & ex.Message)
    End Try
End Sub

Hinweise

Die Margins Klasse wird verwendet, um die Breite der Seitenränder in PageSettings und PrintController. MarginsConverter ist der Typdeskriptor für diese Klasse.

Left, Right, Topund Bottom sind Eigenschaften, die die Seitenränder definieren. Clone erstellt eine identische Margins. Equals bestimmt, ob ein anderes Objekt die gleichen Dimensionen wie ein Margins.

Weitere Informationen zum Drucken finden Sie in der System.Drawing.Printing Namespaceübersicht.

Konstruktoren

Name	Beschreibung
Margins()	Initialisiert eine neue Instanz der Margins Klasse mit 1-Zoll-Breitenrändern.
Margins(Int32, Int32, Int32, Int32)	Initialisiert eine neue Instanz der Margins Klasse mit den angegebenen linken, rechten, oberen und unteren Rändern.

Eigenschaften

Name	Beschreibung
Bottom	Ruft den unteren Rand in Hundertstel eines Zolls ab oder legt den unteren Rand fest.
Left	Ruft die breite des linken Rands in Hundertsteln eines Zolls ab oder legt sie fest.
Right	Ruft die rechte Randbreite in Hundertsteln von zoll ab oder legt diese fest.
Top	Ruft die breite des oberen Rands in Hundertstel eines Zolls ab oder legt diese fest.

Methoden

Name	Beschreibung
Clone()	Ruft ein Duplikat dieses Objekts ab, Element nach Element.
Equals(Object)	Vergleicht dies Margins mit dem angegebenen Object Wert, um zu bestimmen, ob sie dieselben Dimensionen aufweisen.
GetHashCode()	Berechnet und ruft einen Hashcode basierend auf der Breite der linken, rechten, oberen und unteren Ränder ab.
ToString()	Konvertiert die Margins Zeichenfolge in eine Zeichenfolge.

Operatoren

Name	Beschreibung
Equality(Margins, Margins)	Vergleicht zwei Margins , um festzustellen, ob sie dieselben Dimensionen haben.
Inequality(Margins, Margins)	Vergleicht zwei Margins , um festzustellen, ob sie ungleich breit sind.

Weitere Informationen

• PageSettings
• PrintController
• MarginsConverter
• Druckunterstützung in Windows Forms