Margins 类

定义

命名空间:

System.Drawing.Printing

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v8.0.0

Source:

Margins.cs

指定打印页的边距尺寸。

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

继承

Object

Margins

属性

TypeConverterAttribute

实现

ICloneable

示例

对于此示例， System.Drawing请使用 、 System.Drawing.Printing和 System.IO 命名空间。

下面的代码示例将文档的默认页面设置设置为每侧 1 英寸的边距。

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

注解

类Margins用于操作 和 PrintController中的PageSettings边距宽度。 MarginsConverter 是此类的类型描述符。

Left、 Right、 Top和 Bottom 是定义边距的属性。 Clone 创建相同的 Margins。 Equals 确定另一个 对象是否具有与 相同的维度 Margins。

有关打印的详细信息，请参阅 System.Drawing.Printing 命名空间概述。

构造函数

Margins()	使用 1 英寸宽的边距初始化 Margins 类的新实例。
Margins(Int32, Int32, Int32, Int32)	使用指定的左边距、右边距、上边距和下边距初始化 Margins 类的新实例。

属性

Bottom	获取或设置下边距（以百分之一英寸为单位）。
Left	获取或设置左边距宽度（以百分之一英寸为单位）。
Right	获取或设置右边距宽度（以百分之一英寸为单位）。
Top	获取或设置上边距宽度（以百分之一英寸为单位）。

方法

Clone()	逐个成员地检索此对象的重复。
Equals(Object)	将此 Margins 与指定的 Object 进行比较，以确定它们是否具有相同的尺寸。
GetHashCode()	计算并检索基于左边距、右边距、上边距和下边距宽度的哈希代码。
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	将 Margins 转换为字符串。

运算符

Equality(Margins, Margins)	将两个 Margins 进行比较，以确定它们是否具有相同的尺寸。
Inequality(Margins, Margins)	将两个 Margins 进行比较，以确定它们的宽度是否不相等。

另请参阅

• PageSettings
• PrintController
• MarginsConverter
• Windows 窗体打印支持