PrintPageEventArgs Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
PrintPage olayı için veriler sağlar.
public ref class PrintPageEventArgs : EventArgs
public class PrintPageEventArgs : EventArgs
type PrintPageEventArgs = class
inherit EventArgs
Public Class PrintPageEventArgs
Inherits EventArgs
- Devralma
Örnekler
Aşağıdaki kod örneği, üzerinde Formbir Button adlandırılmış printButton
ve bir PrintDocument adlandırılmış pd
oluşturulduğunu varsayar. için Button olayının Click yöntemiyle ilişkilendirildiğinden printButton_Click
ve PrintPage olayının PrintDocument örnekteki yöntemle ilişkilendirildiğinden pd_PrintPage
emin olun. printButton_Click
Örnekteki yöntemi olayı yükselten PrintPage yöntemini çağırır Print ve yönteminde pd_PrintPage
belirtilen .bmp dosyasını yazdırır. Bu örneği çalıştırmak için, yolu yazdırmak istediğiniz bit eşlem olarak değiştirin.
System.DrawingBu örnek için , System.Drawing.Printingve System.Windows.Forms ad alanlarını kullanın.
private:
// Specifies what happens when the user clicks the Button.
void printButton_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
{
try
{
pd->Print();
}
catch ( Exception^ ex )
{
MessageBox::Show( "An error occurred while printing", ex->ToString() );
}
}
// Specifies what happens when the PrintPage event is raised.
void pd_PrintPage( Object^ /*sender*/, PrintPageEventArgs^ ev )
{
// Draw a picture.
ev->Graphics->DrawImage( Image::FromFile( "C:\\My Folder\\MyFile.bmp" ),
ev->Graphics->VisibleClipBounds );
// Indicate that this is the last page to print.
ev->HasMorePages = false;
}
// Specifies what happens when the user clicks the Button.
private void printButton_Click(object sender, EventArgs e)
{
try
{
// Assumes the default printer.
pd.Print();
}
catch(Exception ex)
{
MessageBox.Show("An error occurred while printing", ex.ToString());
}
}
// Specifies what happens when the PrintPage event is raised.
private void pd_PrintPage(object sender, PrintPageEventArgs ev)
{
// Draw a picture.
ev.Graphics.DrawImage(Image.FromFile("C:\\My Folder\\MyFile.bmp"), ev.Graphics.VisibleClipBounds);
// Indicate that this is the last page to print.
ev.HasMorePages = false;
}
' Specifies what happens when the user clicks the Button.
Private Sub printButton_Click(sender As Object, e As EventArgs) _
Handles printButton.Click
Try
pd.Print()
Catch ex As Exception
MessageBox.Show("An error occurred while printing", _
ex.ToString())
End Try
End Sub
' Specifies what happens when the PrintPage event is raised.
Private Sub pd_PrintPage(sender As Object, ev As PrintPageEventArgs) _
Handles pd.PrintPage
' Draw a picture.
ev.Graphics.DrawImage(Image.FromFile("C:\My Folder\MyFile.bmp"), _
ev.Graphics.VisibleClipBounds)
' Indicate that this is the last page to print.
ev.HasMorePages = False
End Sub
Açıklamalar
Not
.NET 6 ve sonraki sürümlerde, bu türü içeren System.Drawing.Common paketi yalnızca Windows işletim sistemlerinde desteklenir. Platformlar arası uygulamalarda bu türün kullanılması derleme zamanı uyarılarına ve çalışma zamanı özel durumlarına neden olur. Daha fazla bilgi için bkz . System.Drawing.Common yalnızca Windows'ta desteklenir.
özelliği, MarginBounds sayfanın kenar boşlukları arasındaki bölümünü temsil eden dikdörtgen alanı alır. özelliği, PageBounds sayfanın toplam alanını temsil eden dikdörtgen alanı alır. özelliği, Graphics boyamanın gerçekleştirildiği grafik nesnesini tanımlar. PageSettings özelliği geçerli sayfanın yazıcı ayarlarını alır. Kalan özellikler, yazdırma işinin iptal edilmesi gerektiğini veya yazdırma işinin daha fazla sayfaya sahip olup olmadığını gösterir.
Windows Forms ile yazdırma hakkında daha fazla bilgi için bkz. ad alanına System.Drawing.Printing genel bakış. bir Windows Presentation Foundation uygulamasından yazdırmak istiyorsanız ad alanına System.Printing bakın.
Oluşturucular
PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings) |
PrintPageEventArgs sınıfının yeni bir örneğini başlatır. |
Özellikler
Cancel |
Yazdırma işinin iptal edilip edilmeyeceğini belirten bir değer alır veya ayarlar. |
Graphics |
Sayfayı Graphics boyamak için kullanılan öğesini alır. |
HasMorePages |
Ek bir sayfanın yazdırılıp yazdırılmayacağını belirten bir değer alır veya ayarlar. |
MarginBounds |
Sayfanın kenar boşlukları içindeki bölümünü temsil eden dikdörtgen alanı alır. |
PageBounds |
Sayfanın toplam alanını temsil eden dikdörtgen alanı alır. |
PageSettings |
Geçerli sayfanın sayfa ayarlarını alır. |
Yöntemler
Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |