Margins Třída

Definice

Obor názvů:

System.Drawing.Printing

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v11.0.0-preview.5.26302.115

Zdroj:

Margins.cs

Určuje rozměry okrajů vytištěné stránky.

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

Dědičnost

Object

Margins

Atributy

TypeConverterAttribute

Implementuje

ICloneable

Příklady

V tomto příkladu System.Drawingpoužijte obory názvů , System.Drawing.Printinga System.IO obory názvů.

Následující příklad kódu nastaví výchozí nastavení stránky dokumentu na okraje 1 palce na každé straně.

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

Poznámky

Třída Margins slouží k manipulaci s šířkou okrajů v PageSettings a PrintController. MarginsConverter je popisovač typu pro tuto třídu.

Left, Right, Topa Bottom jsou vlastnosti, které definují okraje. Clone vytvoří identický Margins. Equals určuje, zda má jiný objekt stejné dimenze jako Margins.

Další informace o tisku najdete v přehledu System.Drawing.Printing oboru názvů.

Konstruktory

Name	Description
Margins()	Inicializuje novou instanci Margins třídy s 1palcovými širokými okraji.
Margins(Int32, Int32, Int32, Int32)	Inicializuje novou instanci Margins třídy se zadaným levým, pravým, horním a dolním okrajem.

Vlastnosti

Name	Description
Bottom	Získá nebo nastaví dolní okraj v stovkách palce.
Left	Získá nebo nastaví šířku levého okraje v stovkách palce.
Right	Získá nebo nastaví šířku pravého okraje v stovkách palce.
Top	Získá nebo nastaví šířku horního okraje v stovkách palce.

Metody

Name	Description
Clone()	Načte duplikát tohoto objektu člena podle člena.
Equals(Object)	Porovná ho Margins se zadaným kódem Object a určí, jestli mají stejné dimenze.
GetHashCode()	Vypočítá a načte hashovací kód na základě šířky levého, pravého, horního a dolního okraje.
ToString()	Převede řetězec Margins na řetězec.

Operátory

Name	Description
Equality(Margins, Margins)	Porovná dva Margins a určí, jestli mají stejné dimenze.
Inequality(Margins, Margins)	Porovná dva Margins a určí, jestli mají nerovnou šířku.

Viz také

• PageSettings
• PrintController
• MarginsConverter
• Podpora tisku pro model Windows Forms