PrintPageEventArgs Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет данные о событии PrintPage.
public ref class PrintPageEventArgs : EventArgs
public class PrintPageEventArgs : EventArgs
type PrintPageEventArgs = class
inherit EventArgs
Public Class PrintPageEventArgs
Inherits EventArgs
- Наследование
Примеры
В следующем примере кода предполагаетсяButton, что в объекте Formсоздано именованное имя printButton и PrintDocument именованное имяpd. Убедитесь, Click что событие для Button метода связано с методом, а PrintPage событие PrintDocument связано с printButton_Clickpd_PrintPage методом в примере. Метод printButton_Click из примера вызывает метод, вызывающий PrintPrintPage событие, и выводит файл .bmp, указанный в методе pd_PrintPage . Чтобы запустить этот пример, измените путь к растровой карте, которую вы хотите распечатать.
System.Drawing System.Drawing.PrintingИспользуйте пространства имен и System.Windows.Forms пространства имен для этого примера.
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
Комментарии
Замечание
В .NET 6 и более поздних версиях пакет System.Drawing.Common, который включает этот тип, поддерживается только в операционных системах Windows. Использование этого типа в кроссплатформенных приложениях вызывает предупреждения во время компиляции и исключения во время выполнения. Дополнительные сведения см. в статье System.Drawing.Common, поддерживаемой только в Windows.
Свойство MarginBounds извлекает прямоугольную область, представляющую часть страницы между полями. Свойство PageBounds извлекает прямоугольную область, представляющую общую область страницы. Свойство Graphics определяет графический объект, с помощью которого выполняется рисование. Свойство PageSettings извлекает параметры принтера для текущей страницы. Остальные свойства указывают, следует ли отменить задание печати или иметь ли задание печати больше страниц.
Дополнительные сведения о печати с помощью Windows Forms см. в обзоре System.Drawing.Printing пространства имен. Если вы хотите распечатать из приложения Windows Presentation Foundation, просмотрите System.Printing пространство имен.
Конструкторы
| Имя | Описание |
|---|---|
| PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings) |
Инициализирует новый экземпляр класса PrintPageEventArgs. |
Свойства
| Имя | Описание |
|---|---|
| Cancel |
Возвращает или задает значение, указывающее, следует ли отменить задание печати. |
| Graphics |
Возвращает используемый Graphics для рисования страницы. |
| HasMorePages |
Возвращает или задает значение, указывающее, следует ли распечатать дополнительную страницу. |
| MarginBounds |
Получает прямоугольную область, представляющую часть страницы внутри полей. |
| PageBounds |
Возвращает прямоугольную область, представляющую общую область страницы. |
| PageSettings |
Возвращает параметры страницы для текущей страницы. |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |