Margins Klasse

Referenz

Definition

Namespace:: System.Drawing.Printing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public ref class Margins : ICloneable

public class Margins : ICloneable

[System.ComponentModel.TypeConverter("System.Drawing.Printing.MarginsConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")]
public class Margins : ICloneable

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

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

type Margins = class
    interface ICloneable

[<System.ComponentModel.TypeConverter("System.Drawing.Printing.MarginsConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")>]
type Margins = class
    interface ICloneable

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

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

Public Class Margins
Implements ICloneable

Vererbung: Object
Margins

Attribute: TypeConverterAttribute SerializableAttribute

Implementiert: ICloneable

Beispiele

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

Im folgenden Codebeispiel werden die Standardseiteneinstellungen für ein Dokument auf Ränder von 1 Zoll auf jeder Seite 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 Ränder definieren. Clone erstellt eine identische Margins. Equals bestimmt, ob ein anderes Objekt die gleichen Dimensionen hat wie ein Margins.

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

Konstruktoren

Margins()	Initialisiert eine neue Instanz der Margins-Klasse mit Seitenrändern von 1 Zoll Breite.
Margins(Int32, Int32, Int32, Int32)	Initialisiert eine neue Instanz der Margins-Klasse mit den angegebenen Werten für den linken, rechten, oberen und unteren Seitenrand.

Eigenschaften

Bottom	Ruft den unteren Rand in 1/100 Zoll ab oder legt diesen fest.
Left	Ruft die linke Randbreite in 1/100 Zoll ab oder legt diese fest.
Right	Ruft die rechte Randbreite in 1/100 Zoll ab oder legt diese fest.
Top	Ruft die obere Randbreite in 1/100 Zoll ab oder legt diese fest.

Methoden

Clone()	Ruft Member für Member ein Duplikat dieses Objekts ab.
Equals(Object)	Vergleicht diese Instanz von Margins mit dem angegebenen Object, um zu bestimmen, ob die Abmessungen übereinstimmen.
GetHashCode()	Berechnet einen Hashcode anhand der Breite des linken, rechten, oberen und unteren Rands und ruft diesen Hashcode ab.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Konvertiert die Instanz von Margins in eine Zeichenfolge.

Operatoren

Equality(Margins, Margins)	Vergleicht zwei Instanzen von Margins, um zu bestimmen, ob die Abmessungen übereinstimmen.
Inequality(Margins, Margins)	Vergleicht zwei Instanzen von Margins, um zu bestimmen, ob sie unterschiedliche Breiten aufweisen.

Gilt für