Общие сведения о компоненте PrintDocument (Windows Forms) PrintDocument Component Overview (Windows Forms)

Компонент Windows Forms PrintDocument позволяет определять свойства, описывающие печатаемое содержимое, и распечатывать документы в приложениях Windows. The Windows Forms PrintDocument component is used to set the properties that describe what to print and the ability to print the document within Windows-based applications. Его можно использовать в сочетании с компонентом PrintDialog для управления всеми аспектами печати документов. It can be used in conjunction with the PrintDialog component to be in control of all aspects of document printing.

Работа с компонентом PrintDocument Working with the PrintDocument Component

Ниже приведены два основных сценария, в которых участвует PrintDocument компонент: Two of the main scenarios that involve the PrintDocument component are:

Простые задания печати, такие как печать отдельного текстового файла. Simple print jobs, such as printing an individual text file. В этом случае необходимо добавить PrintDocument компонент в форму Windows Forms, а затем добавить программную логику, которая выводит файл в PrintPage обработчике событий. In such a case you would add the PrintDocument component to a Windows Form, then add programming logic that prints a file in the PrintPage event handler. Логика программирования должна завершающейся с помощью Print метода для печати документа. The programming logic should culminate with the Print method to print the document. Этот метод отправляет на Graphics принтер объект, содержащийся в Graphics свойстве PrintPageEventArgs класса. This method sends a Graphics object, contained in the Graphics property of the PrintPageEventArgs class, to the printer. Пример, демонстрирующий печать текстового документа с помощью PrintDocument компонента, см. в разделе инструкции. Печать многостраничного текстового файла в Windows Forms. For an example that shows how to print a text document using the PrintDocument component, see How to: Print a Multi-Page Text File in Windows Forms.

Более сложные задания печати, например ситуации, когда требуется повторное использование уже написанной логики печати. More complex print jobs, such as a situation where you will want to reuse printing logic you have written. В этом случае необходимо создать новый компонент из PrintDocument компонента и переопределить (см. Дополнительные сведения о Visual Basic или переопределении для C#) PrintPage события. In such a case you would derive a new component from the PrintDocument component and override (see Overrides for Visual Basic or override for C#) the PrintPage event.

При добавлении в форму PrintDocument компонент отображается в области в нижней части конструктор Windows Forms в Visual Studio. When it is added to a form, the PrintDocument component appears in the tray at the bottom of the Windows Forms Designer in Visual Studio.

Элементы управления и компоненты диалоговых окон (Windows Forms) Dialog-Box Controls and Components (Windows Forms)

Перечисленные ниже элементы управления и компоненты Windows Forms представляют стандартные диалоговые окна. The following Windows Forms controls and components present standard dialog boxes. Чтобы получить дополнительную информацию о функциях, доступных в каждом диалоговом окне, щелкните соответствующую ссылку. Follow the links for more information about the functions available in each dialog box.

Справочник Reference

ColorDialog
Справочная информация о классе ColorDialog и его членах. Provides reference information about the ColorDialog class and its members.

FontDialog
Справочная информация о классе FontDialog и его членах. Provides reference information about the FontDialog class and its members.

OpenFileDialog
Справочная информация о классе OpenFileDialog и его членах. Provides reference information about the OpenFileDialog class and its members.

PageSetupDialog
Справочная информация о классе PageSetupDialog и его членах. Provides reference information about the PageSetupDialog class and its members.

PrintDialog
Справочная информация о классе PrintDialog и его членах. Provides reference information about the PrintDialog class and its members.

PrintPreviewDialog
Справочная информация о классе PrintPreviewDialog и его членах. Provides reference information about the PrintPreviewDialog class and its members.

SaveFileDialog
Справочная информация о классе SaveFileDialog и его членах. Provides reference information about the SaveFileDialog class and its members.

Связанные разделы Related Sections

Диалоговые окна в Windows Forms Dialog Boxes in Windows Forms
Инструкции по созданию диалогового окна для формы Windows Forms. Describes how to create a dialog box for a Windows Form.

Общие сведения о компоненте ColorDialog ColorDialog Component Overview
Предоставляет стандартное диалоговое окно для выбора цветов из палитры и добавления в нее дополнительных цветов. Enables the user to select a color from a palette in a pre-configured dialog box and to add custom colors to that palette.

Общие сведения о компоненте FontDialog FontDialog Component Overview
Предоставляет приложениям шрифты, установленные в системе на текущий момент. Exposes the fonts that are currently installed on the system.

Общие сведения о компоненте OpenFileDialog OpenFileDialog Component Overview
Позволяет пользователям открывать файлы в стандартном диалоговом окне. Allows users to open files via a pre-configured dialog box.

Общие сведения о компоненте PageSetupDialog PageSetupDialog Component Overview
Предоставляет стандартное диалоговое окно для задания параметров страницы для печати. Sets page details for printing via a pre-configured dialog box.

Общие сведения о компоненте PrintDialog PrintDialog Component Overview
Служит для выбора принтера, печатаемых страниц и других параметров печати. Selects a printer, chooses the pages to print, and determines other print-related settings.

Общие сведения об элементе управления PrintPreviewDialog PrintPreviewDialog Control Overview
Выводит документ в том виде, как он будет выглядеть при печати. Displays a document as it will appear when it is printed.

Общие сведения о компоненте SaveFileDialog SaveFileDialog Component Overview
Служит для выбора сохраняемых файлов и места их сохранения. Selects files to save and where to save them.

Компонент ToolTip (Windows Forms) ToolTip Component (Windows Forms)

Компонент ToolTip в Windows Forms отображает текст при наведении указателя мыши на элементы управления. The Windows Forms ToolTip component displays text when the user points at controls. Компонент ToolTip можно связать с любым элементом управления. A ToolTip can be associated with any control. Пример использования этого компонента: для экономии места в форме можно настроить отображение маленького значка для кнопки и использовать компонент ToolTip для объяснения ее функции. An example use of this control: In order to save space on a form, you can display a small icon on a button and use a ToolTip to explain the button’s function.

в этом разделе In This Section

Общие сведения об элементе управления ToolTip ToolTip Component Overview
Основные понятия, связанные с компонентом ToolTip, который позволяет пользователям просматривать текст при наведении указателя мыши на элемент управления. Introduces the general concepts of the ToolTip component, which allows users to see text when they point the mouse at a control.

Практическое руководство. Изменение значения задержки для компонента ToolTip в Windows Forms How to: Change the Delay of the Windows Forms ToolTip Component
Описание настройки значений, определяющих время задержки отображения подсказки, а также время, в течение которого она отображается. Explains how to set values that control how long a Tooltip takes to appear and the length of time for which it is shown.

Справочник Reference

Класс ToolTip ToolTip class
Справочная информация о классе и его членах. Provides reference information on the class and its members.

Связанные разделы Related Sections

Элементы управления для использования в формах Windows Forms Controls to Use on Windows Forms
Полный список элементов управления Windows Forms со ссылками на информацию об их применении. Provides a complete list of Windows Forms controls, with links to information on their use.

Отображение справки по элементам управления с помощью всплывающих подсказок Control Help Using ToolTips
Описание использования подсказок в качестве кратких специализированных справочных сообщений для отдельных элементов управления в формах Windows Forms. Discusses Tooltips as a way to make brief, specialized Help messages for individual controls on Windows Forms.

Элементы управления для использования в формах Windows Forms Controls to Use on Windows Forms

Ниже приведен алфавитный список элементов управления и компонентов, используемых в формах Windows Forms. The following is an alphabetic list of controls and components that can be used on Windows Forms. Помимо элементов управления Windows Forms, описанных в этом разделе, в формы Windows Forms можно добавлять элементы управления ActiveX и пользовательские элементы управления. In addition to the Windows Forms controls covered in this section, you can add ActiveX and custom controls to Windows Forms. Если вам не удается найти нужный элемент управления в этом списке, вы можете создать свой собственный. If you do not find the control you need listed here, you can also create your own. См. раздел Создание элементов управления Windows Forms во время разработки. For details, see Developing Windows Forms Controls at Design Time. Дополнительные сведения о выборе необходимого элемента управления см. в разделе Функциональная классификация элементов управления Windows Forms. For more information about choosing the control you need, see Windows Forms Controls by Function.

Visual Basic элементы управления основаны на классах, предоставляемых .NET Framework. Visual Basic controls are based on classes provided by the .NET Framework.

в этом разделе In This Section

Функциональная классификация элементов управления Windows Forms Windows Forms Controls by Function
Содержит список и описание Windows Forms элементов управления на основе .NET Framework. Lists and describes Windows Forms controls based on the .NET Framework.

Элементы управления Windows Forms со встроенной поддержки рисования владельцем Controls with Built-In Owner-Drawing Support
Описание возможностей изменения аспектов внешнего вида элемента управления, которые недоступны через свойства. Describes how to alter aspects of a control’s appearance that are not available through properties.

Компонент BackgroundWorker BackgroundWorker Component
Позволяет форме или элементу управления выполнять операцию асинхронно. Enables a form or control to run an operation asynchronously.

BindingNavigator — элемент управления BindingNavigator Control
Представляет собой пользовательский интерфейс для перехода и обработки для элементов управления, которые привязываются к данным. Provides the navigation and manipulation user interface (UI) for controls that are bound to data.

Компонент BindingSource BindingSource Component
Инкапсулирует источник данных для привязки к элементам управления. Encapsulates a data source for binding to controls.

Элемент управления Button Button Control
Представляет стандартную кнопку, которую пользователь может нажать для выполнения действий. Presents a standard button that the user can click to perform actions.

Элемент управления CheckBox CheckBox Control
Указывает, включено или выключено условие. Indicates whether a condition is on or off.

Элемент управления CheckedListBox CheckedListBox Control
Отображает список элементов с флажками слева от каждого элемента. Displays a list of items with a check box next to each item.

Компонент ColorDialog ColorDialog Component
Предоставляет стандартное диалоговое окно для выбора цветов из палитры и добавления в нее дополнительных цветов. Allows the user to select a color from a palette in a pre-configured dialog box and to add custom colors to that palette.

Элемент управления ComboBox ComboBox Control
Отображает данные в раскрывающемся поле со списком. Displays data in a drop-down combo box.

Компонент ContextMenu ContextMenu Component
Предоставляет пользователям быстрый доступ к меню часто используемых команд, связанных с выбранным объектом. Provides users with an easily accessible menu of frequently used commands that are associated with the selected object. Хотя ContextMenuStrip заменяет и добавляет функциональные возможности для ContextMenu управления предыдущими версиями, ContextMenu сохраняется как для обратной совместимости, так и для будущего использования, если это необходимо. Although ContextMenuStrip replaces and adds functionality to the ContextMenu control of previous versions, ContextMenu is retained for both backward compatibility and future use if so desired.

Элемент управления ContextMenuStrip ContextMenuStrip Control
Представляет контекстное меню. Represents a shortcut menu. Хотя ContextMenuStrip заменяет и добавляет функциональные возможности для ContextMenu управления предыдущими версиями, ContextMenu сохраняется как для обратной совместимости, так и для будущего использования, если это необходимо. Although ContextMenuStrip replaces and adds functionality to the ContextMenu control of previous versions, ContextMenu is retained for both backward compatibility and future use if so desired.

Элемент управления DataGrid DataGrid Control
Отображает табличные данные из набора данных и позволяет вносить изменения в источник данных. Displays tabular data from a dataset and allows for updates to the data source.

Элемент управления DataGridView DataGridView Control
Предоставляет гибкую, расширяемую систему для отображения и редактирования табличных данных. Provides a flexible, extensible system for displaying and editing tabular data.

Элемент управления DateTimePicker DateTimePicker Control
Позволяет пользователю выбрать один элемент из списка дат или времени. Allows the user to select a single item from a list of dates or times.

Элементы управления и компоненты диалоговых окон Dialog-Box Controls and Components
Описание набора элементов управления для выполнения пользователем стандартных действий в приложении или системе. Describes a set of controls that allow users to perform standard interactions with the application or system.

Элемент управления DomainUpDown DomainUpDown Control
Отображает текстовые строки, которые пользователь может просматривать и выбирать. Displays text strings that a user can browse through and select from.

Компонент ErrorProvider ErrorProvider Component
Отображает сведения об ошибке для пользователя в фоновом режиме. Displays error information to the user in a non-intrusive way.

Класс FileDialog Предоставляет функциональные возможности базового класса для диалоговых окон файлов. FileDialog Class Provides base-class functionality for file dialog boxes.

Элемент управления FlowLayoutPanel FlowLayoutPanel Control
Представляет панель, которая динамически располагает содержимое по горизонтали или вертикали. Represents a panel that dynamically lays out its contents horizontally or vertically.

Компонент FolderBrowserDialog FolderBrowserDialog Component
Отображает интерфейс, с помощью которого пользователи могут просматривать и выбирать каталоги или создавать их. Displays an interface with which users can browse and select a directory or create a new one.

Компонент FontDialog FontDialog Component
Предоставляет приложениям шрифты, установленные в системе на текущий момент. Exposes the fonts that are currently installed on the system.

Элемент управления GroupBox GroupBox Control
Предоставляет возможность идентифицируемой группировки других элементов управления. Provides an identifiable grouping for other controls.

Компонент HelpProvider HelpProvider Component
Связывает HTML-файл справки с приложением Windows. Associates an HTML Help file with a Windows-based application.

Элементы управления HScrollBar и VScrollBar HScrollBar and VScrollBar Controls
Используются для просмотра длинных списков элементов или большого объема данных с помощью горизонтальной или вертикальной прокрутки окна приложения либо элемента управления. Provide navigation through a list of items or a large amount of information by scrolling either horizontally or vertically within an application or control.

Компонент ImageList ImageList Component
Отображает изображения на других элементах управления. Displays images on other controls.

Элемент управления Label Label Control
Отображает текст, который не может быть изменен пользователем. Displays text that cannot be edited by the user.

Элемент управления LinkLabel LinkLabel Control
Позволяет добавлять веб-ссылки в приложения Windows Forms. Allows you to add Web-style links to Windows Forms applications.

Элемент управления ListBox ListBox Control
Позволяет пользователю выбрать один или несколько элементов из заранее определенного списка. Allows the user to select one or more items from a predefined list.

Элемент управления ListView ListView Control
Отображает список элементов со значками в стиле проводника Windows. Displays a list of items with icons, in the manner of Windows Explorer.

Компонент MainMenu MainMenu Component
Отображает меню во время выполнения. Displays a menu at run time. Хотя элемент управления MenuStrip заменяет элемент управления MainMenu предыдущих версий и расширяет его функциональные возможности, однако при необходимости элемент управления MainMenu можно сохранить для обратной совместимости и использования в будущем. Although MenuStrip replaces and adds functionality to the MainMenu control of previous versions, MainMenu is retained for both backward compatibility and future use if you choose.

Элемент управления MaskedTextBox MaskedTextBox Control
Ограничивает формат вводимых пользователем данных в форме. Constrains the format of user input in a form.

Элемент управления MenuStrip MenuStrip Control
Предоставляет систему меню для формы. Provides a menu system for a form. Хотя элемент управления MenuStrip заменяет элемент управления MainMenu предыдущих версий и расширяет его функциональные возможности, однако при необходимости элемент управления MainMenu можно сохранить для обратной совместимости и использования в будущем. Although MenuStrip replaces and adds functionality to the MainMenu control of previous versions, MainMenu is retained for both backward compatibility and future use if you choose.

Элемент управления MonthCalendar MonthCalendar Control
Предоставляет интуитивно понятный графический интерфейс для пользователей для просмотра и задания сведений о дате. Presents an intuitive graphical interface for users to view and set date information.

Компонент NotifyIcon NotifyIcon Component
Отображает значки для процессов, выполняемых в фоновом режиме и не имеющих пользовательских интерфейсов. Displays icons for processes that run in the background and would not otherwise have user interfaces.

Элемент управления NumericUpDown NumericUpDown Control
Отображает числовые значения, которые пользователь может просматривать и выбирать. Displays numerals that a user can browse through and select from.

Компонент OpenFileDialog OpenFileDialog Component
Позволяет пользователям открывать файлы в стандартном диалоговом окне. Allows users to open files by using a pre-configured dialog box.

Компонент PageSetupDialog PageSetupDialog Component
Предоставляет стандартное диалоговое окно для задания параметров страницы для печати. Sets page details for printing through a pre-configured dialog box.

Элемент управления панели Panel Control
Предоставляет возможность идентифицируемой группировки других элементов управления, а также прокрутку. Provide an identifiable grouping for other controls, and allows for scrolling.

Элемент управления PictureBox PictureBox Control
Отображает рисунки в формате точечного рисунка, GIF, JPEG, метафайла или значка. Displays graphics in bitmap, GIF, JPEG, metafile, or icon format.

Компонент PrintDialog PrintDialog Component
Служит для выбора принтера, печатаемых страниц и других параметров печати. Selects a printer, chooses the pages to print, and determines other print-related settings.

Компонент PrintDocument PrintDocument Component
Задает свойства, описывающие содержимое для печати, и печатает документ в приложениях Windows. Sets the properties that describe what to print, and prints the document in Windows-based applications.

Элемент управления PrintPreviewControl PrintPreviewControl Control
Позволяет создавать собственный компонент или диалоговое окно PrintPreview , вместо использования стандартных версий. Allows you to create your own PrintPreview component or dialog box instead of using the pre-configured version.

Элемент управления PrintPreviewDialog PrintPreviewDialog Control
Выводит документ в том виде, как он будет выглядеть при печати. Displays a document as it will appear when it is printed.

Элемент управления ProgressBar ProgressBar Control
Графически показывает ход выполнения действия. Graphically indicates the progress of an action towards completion.

Элемент управления RadioButton RadioButton Control
Представляет набор из двух или более взаимоисключающих вариантов выбора для пользователя. Presents a set of two or more mutually exclusive options to the user.

Элемент управления RichTextBox RichTextBox Control
Позволяет пользователям вводить, отображать и изменять текст с форматированием. Allows users to enter, display, and manipulate text with formatting.

Компонент SaveFileDialog SaveFileDialog Component
Служит для выбора сохраняемых файлов и места их сохранения. Selects files to save and where to save them.

SoundPlayer, класс Позволяет легко включать звуки в приложения. SoundPlayer Class Enables you to easily include sounds in your applications.

Элемент управления SplitContainer SplitContainer Control
Позволяет пользователю изменять размер закрепленного элемента управления. Allows the user to resize a docked control.

Элемент управления Splitter Splitter Control
Разрешает пользователю изменять размер закрепленного элемента управления (.NET Framework версии 1. x). Allows the user to resize a docked control (.NET Framework version 1.x).

Элемент управления StatusBar StatusBar Control
Отображает сведения о состоянии элемента управления, который находится в фокусе. Displays status information related to the control that has focus. Хотя StatusStrip заменяет и расширяет элемент управления StatusBar предыдущих версий, StatusBar сохраняется для обеспечения обратной совместимости и использования в будущем при его выборе. Although StatusStrip replaces and extends the StatusBar control of previous versions, StatusBar is retained for both backward compatibility and future use if you choose.

Элемент управления StatusStrip StatusStrip Control
Предоставляет элемент управления Windows «Строка состояния». Represents a Windows status bar control. Хотя StatusStrip заменяет и расширяет элемент управления StatusBar предыдущих версий, StatusBar сохраняется для обеспечения обратной совместимости и использования в будущем при его выборе. Although StatusStrip replaces and extends the StatusBar control of previous versions, StatusBar is retained for both backward compatibility and future use if you choose.

Элемент управления TabControl TabControl Control
Отображает несколько вкладок, содержащих рисунки и другие элементы управления. Displays multiple tabs that can contain pictures or other controls.

Элемент управления TableLayoutPanel TableLayoutPanel Control
Представляет панель, в которой содержимое динамически отображается в сетке, состоящей из строк и столбцов. Represents a panel that dynamically lays out its contents in a grid composed of rows and columns.

Элемент управления TextBox TextBox Control
Позволяет пользователю вводить изменяемый текст из нескольких строк. Allows editable, multiline input from the user.

Компонент Timer Timer Component
Вызывает событие через определенные интервалы. Raises an event at regular intervals.

Элемент управления ToolBar ToolBar Control
Отображает меню и кнопки с растровыми изображениями, активирующие команды. Displays menus and bitmapped buttons that activate commands. Вы можете расширить функциональные возможности элемента управления и изменить его внешний вид и поведение. You can extend the functionality of the control and modify its appearance and behavior. Хотя элемент управления ToolStrip заменяет элемент управления ToolBar предыдущих версий и расширяет его функциональные возможности, однако при необходимости элемент управления ToolBar можно сохранить для обратной совместимости и использования в будущем. Although ToolStrip replaces and adds functionality to the ToolBar control of previous versions, ToolBar is retained for both backward compatibility and future use if you choose.

Элемент управления ToolStrip ToolStrip Control
Создает пользовательские панели инструментов и меню в приложениях Windows Forms. Creates custom toolbars and menus in your Windows Forms applications. Хотя элемент управления ToolStrip заменяет элемент управления ToolBar предыдущих версий и расширяет его функциональные возможности, однако при необходимости элемент управления ToolBar можно сохранить для обратной совместимости и использования в будущем. Although ToolStrip replaces and adds functionality to the ToolBar control of previous versions, ToolBar is retained for both backward compatibility and future use if you choose.

Элемент управления ToolStripContainer ToolStripContainer Control
Предоставляет панели на каждой стороне формы для закрепления, нависания и упорядочения ToolStrip элементов управления, а также для использования в качестве центра ToolStripContentPanel для традиционных элементов управления. Provides panels on each side of a form for docking, rafting, and arranging ToolStrip controls, and a central ToolStripContentPanel for traditional controls.

Элемент управления ToolStripPanel ToolStripPanel Control
Предоставляет одну панель для стыковки, нависания и упорядочения ToolStrip элементов управления. Provides one panel for docking, rafting and arranging ToolStrip controls.

Общие сведения об элементе управления ToolStripProgressBar ToolStripProgressBar Control Overview
Графически показывает ход выполнения действия. Graphically indicates the progress of an action towards completion. ToolStripProgressBarОбычно содержится в StatusStrip . The ToolStripProgressBar is typically contained in a StatusStrip.

Компонент ToolTip ToolTip Component
Отображает текст при наведении указателя мыши на другие элементы управления. Displays text when the user points at other controls.

Элемент управления TrackBar TrackBar Control
Служит для перемещения по большому объему данных или для визуальной настройки числовых параметров. Allows navigation through a large amount of information or visually adjusting a numeric setting.

Элемент управления TreeView TreeView Control
Отображает иерархию узлов, которые можно разворачивать и сворачивать. Displays a hierarchy of nodes that can be expanded or collapsed.

Элемент управления WebBrowser WebBrowser Control
Содержит веб-страницы и обеспечивает возможности просмотра интернет-страниц в приложении. Hosts Web pages and provides Internet Web browsing capabilities to your application.

Создание списка для выбора элементов в Windows Forms Windows Forms Controls Used to List Options
Описание набора элементов управления, используемых для предоставления пользователям списка вариантов для выбора. Describes a set of controls used to provide users with a list of options to choose from.

Связанные разделы Related Sections

Элементы управления Windows Forms Windows Forms Controls
Описание использования элементов управления Windows Forms и важных понятий для работы с ними. Explains the use of Windows Forms controls, and describes important concepts for working with them.

Создание элементов управления Windows Forms во время разработки Developing Windows Forms Controls at Design Time
Ссылки на разделы с инструкциями, рекомендации по выбору создаваемого элемента управления, а также другие сведения о создании собственных элементов управления. Provides links to step-by-step topics, recommendations for which kind of control to create, and other information about creating your own control.

Сравнение элементов управления и программируемых объектов в разных языках и библиотеках Controls and Programmable Objects Compared in Various Languages and Libraries
Предоставляет таблицу, которая сопоставляет элементы управления в Visual Basic 6,0 с соответствующим элементом управления в Visual Basic .NET. Provides a table that maps controls in Visual Basic 6.0 to the corresponding control in Visual Basic .NET. Обратите внимание, что элементы управления теперь являются классами в .NET Framework. Note that controls are now classes in the .NET Framework.

Практическое руководство. Добавление элементов управления ActiveX в формы Windows Forms. How to: Add ActiveX Controls to Windows Forms
В этой статье описывается использование элементов управления ActiveX в формах Windows Forms. Describes how to use ActiveX controls on Windows Forms.