The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

PrintPreviewDialog Class

.NET Framework (current version)

Other Versions

Represents a dialog box form that contains a PrintPreviewControl for printing from a Windows Forms application.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

Inheritance Hierarchy

System::Object
System::MarshalByRefObject
System.ComponentModel::Component
System.Windows.Forms::Control
System.Windows.Forms::ScrollableControl
System.Windows.Forms::ContainerControl
System.Windows.Forms::Form
System.Windows.Forms::PrintPreviewDialog

Syntax

C++

[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)]
public ref class PrintPreviewDialog : Form

Constructors

	Name	Description
	PrintPreviewDialog()	Initializes a new instance of the PrintPreviewDialog class.

Properties

	Name	Description
	AcceptButton	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the button on the form that is clicked when the user presses the ENTER key.
	AccessibilityObject	Gets the AccessibleObject assigned to the control.(Inherited from Control.)
	AccessibleDefaultActionDescription	Gets or sets the default action description of the control for use by accessibility client applications.(Inherited from Control.)
	AccessibleDescription	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the accessible description of the control.
	AccessibleName	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the accessible name of the control.
	AccessibleRole	This API supports the product infrastructure and is not intended to be used directly from your code. The accessible role of the control.
	ActiveControl	Gets or sets the active control on the container control.(Inherited from ContainerControl.)
	ActiveMdiChild	Gets the currently active multiple-document interface (MDI) child window.(Inherited from Form.)
	AllowDrop	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets whether the control can accept data that the user drags onto it.(Overrides Control::AllowDrop.)
	AllowTransparency	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a value indicating whether the opacity of the form can be adjusted.(Inherited from Form.)
	Anchor	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the anchor style for the control.(Overrides Control::Anchor.)
	AutoScale	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a value indicating whether the form adjusts its size to fit the height of the font used on the form and scales its controls.
	AutoScaleBaseSize	Obsolete. This API supports the product infrastructure and is not intended to be used directly from your code. The PrintPreviewDialog class does not support the AutoScaleBaseSize property.(Overrides Form::AutoScaleBaseSize.)
	AutoScaleDimensions	Gets or sets the dimensions that the control was designed to.(Inherited from ContainerControl.)
	AutoScaleFactor	Gets the scaling factor between the current and design-time automatic scaling dimensions. (Inherited from ContainerControl.)
	AutoScaleMode	Gets or sets the automatic scaling mode of the control.(Inherited from ContainerControl.)
	AutoScroll	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a value indicating whether the form enables autoscrolling.(Overrides Form::AutoScroll.)
	AutoScrollMargin	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the size of the auto-scroll margin.
	AutoScrollMinSize	Gets or sets the minimum size of the automatic scroll bars.
	AutoScrollOffset	Gets or sets where this control is scrolled to in ScrollControlIntoView.(Inherited from Control.)
	AutoScrollPosition	Gets or sets the location of the auto-scroll position.(Inherited from ScrollableControl.)
	AutoSize	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a value indicating whether the PrintPreviewDialog should automatically resize to fit its contents.(Overrides Form::AutoSize.)
	AutoSizeMode	Gets or sets the mode by which the form automatically resizes itself.(Inherited from Form.)
	AutoValidate	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets how the control performs validation when the user changes focus to another control.(Overrides Form::AutoValidate.)
	BackColor	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the background color of the form.(Overrides Form::BackColor.)
	BackgroundImage	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the background image for the control.(Overrides Control::BackgroundImage.)
	BackgroundImageLayout	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the layout of the BackgroundImage.(Overrides Control::BackgroundImageLayout.)
	BindingContext	Gets or sets the BindingContext for the control.(Inherited from ContainerControl.)
	Bottom	Gets the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area.(Inherited from Control.)
	Bounds	Gets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control.(Inherited from Control.)
	CancelButton	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the cancel button for the PrintPreviewDialog.
	CanEnableIme	Gets a value indicating whether the ImeMode property can be set to an active value, to enable IME support.(Inherited from ContainerControl.)
	CanFocus	Gets a value indicating whether the control can receive focus.(Inherited from Control.)
	CanRaiseEvents	Determines if events can be raised on the control.(Inherited from Control.)
	CanSelect	Gets a value indicating whether the control can be selected.(Inherited from Control.)
	Capture	Gets or sets a value indicating whether the control has captured the mouse.(Inherited from Control.)
	CausesValidation	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a value indicating whether entering the control causes validation for all controls that require validation.
	ClientRectangle	Gets the rectangle that represents the client area of the control.(Inherited from Control.)
	ClientSize	Gets or sets the size of the client area of the form.(Inherited from Form.)
	CompanyName	Gets the name of the company or creator of the application containing the control.(Inherited from Control.)
	Container	Gets the IContainer that contains the Component.(Inherited from Component.)
	ContainsFocus	Gets a value indicating whether the control, or one of its child controls, currently has the input focus.(Inherited from Control.)
	ContextMenu	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the shortcut menu for the control.(Overrides Control::ContextMenu.)
	ContextMenuStrip	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets how the short cut menu for the control.(Overrides Control::ContextMenuStrip.)
	ControlBox	Gets or sets a value indicating whether a control box is displayed in the caption bar of the form.
	Controls	Gets the collection of controls contained within the control.(Inherited from Control.)
	Created	Gets a value indicating whether the control has been created.(Inherited from Control.)
	CreateParams	Gets the required creation parameters when the control handle is created.(Inherited from Form.)
	CurrentAutoScaleDimensions	Gets the current run-time dimensions of the screen.(Inherited from ContainerControl.)
	Cursor	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the cursor for the control.(Overrides Control::Cursor.)
	DataBindings	This API supports the product infrastructure and is not intended to be used directly from your code. Gets the data bindings for the control.
	DefaultCursor	Gets or sets the default cursor for the control.(Inherited from Control.)
	DefaultImeMode	Gets the default Input Method Editor (IME) mode supported by the control.(Inherited from Form.)
	DefaultMargin	Gets the space, in pixels, that is specified by default between controls.(Inherited from Control.)
	DefaultMaximumSize	Gets the length and height, in pixels, that is specified as the default maximum size of a control.(Inherited from Control.)
	DefaultMinimumSize	Gets the default minimum size, in pixels, of the PrintPreviewDialog control.(Overrides Control::DefaultMinimumSize.)
	DefaultPadding	Gets the internal spacing, in pixels, of the contents of a control.(Inherited from Control.)
	DefaultSize	Gets the default size of the control.(Inherited from Form.)
	DesignMode	Gets a value that indicates whether the Component is currently in design mode.(Inherited from Component.)
	DesktopBounds	Gets or sets the size and location of the form on the Windows desktop.(Inherited from Form.)
	DesktopLocation	Gets or sets the location of the form on the Windows desktop.(Inherited from Form.)
	DeviceDpi	Gets the DPI value for the display device where the control is currently being displayed.(Inherited from Control.)
	DialogResult	Gets or sets the dialog result for the form.(Inherited from Form.)
	DisplayRectangle	Gets the rectangle that represents the virtual display area of the control.(Inherited from ScrollableControl.)
	Disposing	Gets a value indicating whether the base Control class is in the process of disposing.(Inherited from Control.)
	Dock	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets how the control should be docked in its parent control.(Overrides Control::Dock.)
	DockPadding	This API supports the product infrastructure and is not intended to be used directly from your code. Overrides the ScrollableControl::DockPadding property.
	Document	Gets or sets the document to preview.
	DoubleBuffered	Gets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker.(Inherited from Control.)
	Enabled	This API supports the product infrastructure and is not intended to be used directly from your code. Get or sets a value indicating whether the control is enabled.
	Events	Gets the list of event handlers that are attached to this Component.(Inherited from Component.)
	Focused	Gets a value indicating whether the control has input focus.(Inherited from Control.)
	Font	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the font used for the control.(Overrides Control::Font.)
	FontHeight	Gets or sets the height of the font of the control.(Inherited from Control.)
	ForeColor	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the foreground color of the control.(Overrides Control::ForeColor.)
	FormBorderStyle	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the border style of the form.
	Handle	Gets the window handle that the control is bound to.(Inherited from Control.)
	HasChildren	Gets a value indicating whether the control contains one or more child controls.(Inherited from Control.)
	Height	Gets or sets the height of the control.(Inherited from Control.)
	HelpButton	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a value indicating whether a Help button should be displayed in the caption box of the form.
	HorizontalScroll	Gets the characteristics associated with the horizontal scroll bar.(Inherited from ScrollableControl.)
	HScroll	Gets or sets a value indicating whether the horizontal scroll bar is visible.(Inherited from ScrollableControl.)
	Icon	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the icon for the form.
	ImeMode	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the Input Method Editor (IME) mode supported by this control.
	ImeModeBase	Gets or sets the IME mode of a control.(Inherited from Control.)
	InvokeRequired	Gets a value indicating whether the caller must call an invoke method when making method calls to the control because the caller is on a different thread than the one the control was created on.(Inherited from Control.)
	IsAccessible	Gets or sets a value indicating whether the control is visible to accessibility applications.(Inherited from Control.)
	IsDisposed	Gets a value indicating whether the control has been disposed of.(Inherited from Control.)
	IsHandleCreated	Gets a value indicating whether the control has a handle associated with it.(Inherited from Control.)
	IsMdiChild	Gets a value indicating whether the form is a multiple-document interface (MDI) child form.(Inherited from Form.)
	IsMdiContainer	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a value indicating whether the form is a container for multiple document interface (MDI) child forms.
	IsMirrored	Gets a value indicating whether the control is mirrored.(Inherited from Control.)
	IsRestrictedWindow	This API supports the product infrastructure and is not intended to be used directly from your code. Gets a value indicating whether the form can use all windows and user input events without restriction.(Inherited from Form.)
	KeyPreview	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a value indicating whether the form will receive key events before the event is passed to the control that has focus.
	LayoutEngine	Gets a cached instance of the control's layout engine.(Inherited from Control.)
	Left	Gets or sets the distance, in pixels, between the left edge of the control and the left edge of its container's client area.(Inherited from Control.)
	Location	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container.
	MainMenuStrip	Gets or sets the primary menu container for the form.(Inherited from Form.)
	Margin	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the margins for the control.
	MaximizeBox	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a value indicating whether the maximize button is displayed in the caption bar of the form.
	MaximizedBounds	Gets and sets the size of the form when it is maximized.(Inherited from Form.)
	MaximumSize	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the maximum size the form can be resized to.
	MdiChildren	Gets an array of forms that represent the multiple-document interface (MDI) child forms that are parented to this form.(Inherited from Form.)
	MdiParent	Gets or sets the current multiple-document interface (MDI) parent form of this form.(Inherited from Form.)
	Menu	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the MainMenu that is displayed in the form.
	MergedMenu	Gets the merged menu for the form.(Inherited from Form.)
	MinimizeBox	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a value indicating whether the minimize button is displayed in the caption bar of the form.
	MinimumSize	This API supports the product infrastructure and is not intended to be used directly from your code. Gets the minimum size the form can be resized to.
	Modal	Gets a value indicating whether this form is displayed modally.(Inherited from Form.)
	Name	Gets or sets the name of the control.(Inherited from Control.)
	Opacity	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the opacity level of the form.
	OwnedForms	Gets an array of Form objects that represent all forms that are owned by this form.(Inherited from Form.)
	Owner	Gets or sets the form that owns this form.(Inherited from Form.)
	Padding	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the padding for the control.
	Parent	Gets or sets the parent container of the control.(Inherited from Control.)
	ParentForm	Gets the form that the container control is assigned to.(Inherited from ContainerControl.)
	PreferredSize	Gets the size of a rectangular area into which the control can fit.(Inherited from Control.)
	PrintPreviewControl	Gets a value indicating the PrintPreviewControl contained in this form.
	ProductName	Gets the product name of the assembly containing the control.(Inherited from Control.)
	ProductVersion	Gets the version of the assembly containing the control.(Inherited from Control.)
	RecreatingHandle	Gets a value indicating whether the control is currently re-creating its handle.(Inherited from Control.)
	Region	Gets or sets the window region associated with the control.(Inherited from Control.)
	RenderRightToLeft	Obsolete. This property is now obsolete.(Inherited from Control.)
	ResizeRedraw	Gets or sets a value indicating whether the control redraws itself when resized.(Inherited from Control.)
	RestoreBounds	Gets the location and size of the form in its normal window state.(Inherited from Form.)
	Right	Gets the distance, in pixels, between the right edge of the control and the left edge of its container's client area.(Inherited from Control.)
	RightToLeft	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts. (Overrides Control::RightToLeft.)
	RightToLeftLayout	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a value indicating whether the PrintPreviewDialog should be laid out from right to left.(Overrides Form::RightToLeftLayout.)
	ScaleChildren	Gets a value that determines the scaling of child controls. (Inherited from Control.)
	ShowFocusCues	Gets a value indicating whether the control should display focus rectangles.(Inherited from Control.)
	ShowIcon	Gets or sets a value indicating whether an icon is displayed in the caption bar of the form.(Inherited from Form.)
	ShowInTaskbar	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a value indicating whether the form is displayed in the Windows taskbar.
	ShowKeyboardCues	Gets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators.(Inherited from Control.)
	ShowWithoutActivation	Gets a value indicating whether the window will be activated when it is shown.(Inherited from Form.)
	Site	Gets or sets the site of the control.(Inherited from Control.)
	Size	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the size of the form.
	SizeGripStyle	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the style of the size grip to display in the lower-right corner of the form.
	StartPosition	Gets or sets the starting position of the dialog box at run time.
	TabIndex	Gets or sets the tab order of the control within its container.(Inherited from Form.)
	TabStop	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a value indicating whether the user can give the focus to this control using the TAB key.
	Tag	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the object that contains data about the control.
	Text	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the text displayed on the control.(Overrides Form::Text.)
	Top	Gets or sets the distance, in pixels, between the top edge of the control and the top edge of its container's client area.(Inherited from Control.)
	TopLevel	Gets or sets a value indicating whether to display the form as a top-level window.(Inherited from Form.)
	TopLevelControl	Gets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in.(Inherited from Control.)
	TopMost	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a value indicating whether the form should be displayed as the topmost form of your application.
	TransparencyKey	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the color that will represent transparent areas of the form.
	UseAntiAlias	Gets or sets a value indicating whether printing uses the anti-aliasing features of the operating system.
	UseWaitCursor	This API supports the product infrastructure and is not intended to be used directly from your code. Gets the wait cursor, typically an hourglass shape.
	VerticalScroll	Gets the characteristics associated with the vertical scroll bar.(Inherited from ScrollableControl.)
	Visible	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a value indicating whether the control is visible.
	VScroll	Gets or sets a value indicating whether the vertical scroll bar is visible.(Inherited from ScrollableControl.)
	Width	Gets or sets the width of the control.(Inherited from Control.)
	WindowState	Gets or sets the form's window state.
	WindowTarget	This API supports the product infrastructure and is not intended to be used directly from your code. This property is not relevant for this class.(Inherited from Control.)

Methods

	Name	Description
	AccessibilityNotifyClients(AccessibleEvents, Int32)	Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control.(Inherited from Control.)
	AccessibilityNotifyClients(AccessibleEvents, Int32, Int32)	Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control .(Inherited from Control.)
	Activate()	Activates the form and gives it focus.(Inherited from Form.)
	ActivateMdiChild(Form^)	Activates the MDI child of a form.(Inherited from Form.)
	AddOwnedForm(Form^)	Adds an owned form to this form.(Inherited from Form.)
	AdjustFormScrollbars(Boolean)	Adjusts the scroll bars on the container based on the current control positions and the control currently selected. (Inherited from Form.)
	ApplyAutoScaling()	Obsolete. This API supports the product infrastructure and is not intended to be used directly from your code. Resizes the form according to the current value of the AutoScaleBaseSize property and the size of the current font.(Inherited from Form.)
	BeginInvoke(Delegate^)	Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on.(Inherited from Control.)
	BeginInvoke(Delegate^, array<Object^>^)	Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on.(Inherited from Control.)
	BringToFront()	Brings the control to the front of the z-order.(Inherited from Control.)
	CenterToParent()	This API supports the product infrastructure and is not intended to be used directly from your code. Centers the position of the form within the bounds of the parent form.(Inherited from Form.)
	CenterToScreen()	This API supports the product infrastructure and is not intended to be used directly from your code. Centers the form on the current screen.(Inherited from Form.)
	Close()	Closes the form.(Inherited from Form.)
	Contains(Control^)	Retrieves a value indicating whether the specified control is a child of the control.(Inherited from Control.)
	CreateAccessibilityInstance()	Creates a new accessibility object for the control.(Inherited from Control.)
	CreateControl()	Forces the creation of the visible control, including the creation of the handle and any visible child controls.(Inherited from Control.)
	CreateControlsInstance()	Creates a new instance of the control collection for the control.(Inherited from Form.)
	CreateGraphics()	Creates the Graphics for the control.(Inherited from Control.)
	CreateHandle()	Creates the handle for the form that encapsulates the PrintPreviewDialog.(Overrides Form::CreateHandle().)
	CreateObjRef(Type^)	Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.(Inherited from MarshalByRefObject.)
	DefWndProc(Message%)	Sends the specified message to the default window procedure.(Inherited from Form.)
	DestroyHandle()	Destroys the handle associated with the control.(Inherited from Control.)
	Dispose()	Releases all resources used by the Component.(Inherited from Component.)
	Dispose(Boolean)	Disposes of the resources (other than memory) used by the Form.(Inherited from Form.)
	DoDragDrop(Object^, DragDropEffects)	Begins a drag-and-drop operation.(Inherited from Control.)
	DrawToBitmap(Bitmap^, Rectangle)	Supports rendering to the specified bitmap.(Inherited from Control.)
	EndInvoke(IAsyncResult^)	Retrieves the return value of the asynchronous operation represented by the IAsyncResult passed.(Inherited from Control.)
	Equals(Object^)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	Finalize()	Releases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection.(Inherited from Component.)
	FindForm()	Retrieves the form that the control is on.(Inherited from Control.)
	Focus()	Sets input focus to the control.(Inherited from Control.)
	GetAccessibilityObjectById(Int32)	Retrieves the specified AccessibleObject.(Inherited from Control.)
	GetAutoSizeMode()	Retrieves a value indicating how a control will behave when its AutoSize property is enabled.(Inherited from Control.)
	GetChildAtPoint(Point)	Retrieves the child control that is located at the specified coordinates.(Inherited from Control.)
	GetChildAtPoint(Point, GetChildAtPointSkip)	Retrieves the child control that is located at the specified coordinates, specifying whether to ignore child controls of a certain type.(Inherited from Control.)
	GetContainerControl()	Returns the next ContainerControl up the control's chain of parent controls.(Inherited from Control.)
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetLifetimeService()	Retrieves the current lifetime service object that controls the lifetime policy for this instance.(Inherited from MarshalByRefObject.)
	GetNextControl(Control^, Boolean)	Retrieves the next control forward or back in the tab order of child controls.(Inherited from Control.)
	GetPreferredSize(Size)	Retrieves the size of a rectangular area into which a control can be fitted.(Inherited from Control.)
	GetScaledBounds(Rectangle, SizeF, BoundsSpecified)	Retrieves the bounds within which the control is scaled.(Inherited from Form.)
	GetScrollState(Int32)	Determines whether the specified flag has been set.(Inherited from ScrollableControl.)
	GetService(Type^)	Returns an object that represents a service provided by the Component or by its Container.(Inherited from Component.)
	GetStyle(ControlStyles)	Retrieves the value of the specified control style bit for the control.(Inherited from Control.)
	GetTopLevel()	Determines if the control is a top-level control.(Inherited from Control.)
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	Hide()	Conceals the control from the user.(Inherited from Control.)
	InitializeLifetimeService()	Obtains a lifetime service object to control the lifetime policy for this instance.(Inherited from MarshalByRefObject.)
	InitLayout()	Called after the control has been added to another container.(Inherited from Control.)
	Invalidate()	Invalidates the entire surface of the control and causes the control to be redrawn.(Inherited from Control.)
	Invalidate(Boolean)	Invalidates a specific region of the control and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.(Inherited from Control.)
	Invalidate(Rectangle)	Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control.(Inherited from Control.)
	Invalidate(Rectangle, Boolean)	Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.(Inherited from Control.)
	Invalidate(Region^)	Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control.(Inherited from Control.)
	Invalidate(Region^, Boolean)	Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.(Inherited from Control.)
	Invoke(Delegate^)	Executes the specified delegate on the thread that owns the control's underlying window handle.(Inherited from Control.)
	Invoke(Delegate^, array<Object^>^)	Executes the specified delegate, on the thread that owns the control's underlying window handle, with the specified list of arguments.(Inherited from Control.)
	InvokeGotFocus(Control^, EventArgs^)	Raises the GotFocus event for the specified control.(Inherited from Control.)
	InvokeLostFocus(Control^, EventArgs^)	Raises the LostFocus event for the specified control.(Inherited from Control.)
	InvokeOnClick(Control^, EventArgs^)	Raises the Click event for the specified control.(Inherited from Control.)
	InvokePaint(Control^, PaintEventArgs^)	Raises the Paint event for the specified control.(Inherited from Control.)
	InvokePaintBackground(Control^, PaintEventArgs^)	Raises the PaintBackground event for the specified control.(Inherited from Control.)
	IsInputChar(Char)	Determines if a character is an input character that the control recognizes.(Inherited from Control.)
	IsInputKey(Keys)	Determines whether the specified key is a regular input key or a special key that requires preprocessing.(Inherited from Control.)
	LayoutMdi(MdiLayout)	Arranges the multiple-document interface (MDI) child forms within the MDI parent form.(Inherited from Form.)
	LogicalToDeviceUnits(Int32)	Converts a Logical DPI value to it's equivalent DeviceUnit DPI value.(Inherited from Control.)
	MemberwiseClone()	Creates a shallow copy of the current Object.(Inherited from Object.)
	MemberwiseClone(Boolean)	Creates a shallow copy of the current MarshalByRefObject object.(Inherited from MarshalByRefObject.)
	NotifyInvalidate(Rectangle)	This API supports the product infrastructure and is not intended to be used directly from your code. Raises the Invalidated event with a specified region of the control to invalidate.(Inherited from Control.)
	OnActivated(EventArgs^)	Raises the Activated event.(Inherited from Form.)
	OnAutoSizeChanged(EventArgs^)	Raises the AutoSizeChanged event. (Inherited from Control.)
	OnAutoValidateChanged(EventArgs^)	Raises the AutoValidateChanged event.(Inherited from ContainerControl.)
	OnBackColorChanged(EventArgs^)	Raises the BackColorChanged event.(Inherited from Control.)
	OnBackgroundImageChanged(EventArgs^)	Raises the BackgroundImageChanged event.(Inherited from Form.)
	OnBackgroundImageLayoutChanged(EventArgs^)	Raises the BackgroundImageLayoutChanged event.(Inherited from Form.)
	OnBindingContextChanged(EventArgs^)	Raises the BindingContextChanged event.(Inherited from Control.)
	OnCausesValidationChanged(EventArgs^)	Raises the CausesValidationChanged event.(Inherited from Control.)
	OnChangeUICues(UICuesEventArgs^)	Raises the ChangeUICues event.(Inherited from Control.)
	OnClick(EventArgs^)	Raises the Click event.(Inherited from Control.)
	OnClientSizeChanged(EventArgs^)	Raises the ClientSizeChanged event. (Inherited from Control.)
	OnClosed(EventArgs^)	Raises the Closed event.(Inherited from Form.)
	OnClosing(CancelEventArgs^)	This API supports the product infrastructure and is not intended to be used directly from your code. Raises the Closing event.(Overrides Form::OnClosing(CancelEventArgs^).)
	OnContextMenuChanged(EventArgs^)	Raises the ContextMenuChanged event.(Inherited from Control.)
	OnContextMenuStripChanged(EventArgs^)	Raises the ContextMenuStripChanged event.(Inherited from Control.)
	OnControlAdded(ControlEventArgs^)	Raises the ControlAdded event.(Inherited from Control.)
	OnControlRemoved(ControlEventArgs^)	Raises the ControlRemoved event.(Inherited from Control.)
	OnCreateControl()	Raises the CreateControl event.(Inherited from Form.)
	OnCursorChanged(EventArgs^)	Raises the CursorChanged event.(Inherited from Control.)
	OnDeactivate(EventArgs^)	Raises the Deactivate event.(Inherited from Form.)
	OnDockChanged(EventArgs^)	Raises the DockChanged event.(Inherited from Control.)
	OnDoubleClick(EventArgs^)	Raises the DoubleClick event.(Inherited from Control.)
	OnDpiChanged(DpiChangedEventArgs^)	Raises the DpiChanged event. (Inherited from Form.)
	OnDpiChangedAfterParent(EventArgs^)	Raises the DpiChangedAfterParent event.(Inherited from Control.)
	OnDpiChangedBeforeParent(EventArgs^)	Raises the DpiChangedBeforeParent event. (Inherited from Control.)
	OnDragDrop(DragEventArgs^)	Raises the DragDrop event.(Inherited from Control.)
	OnDragEnter(DragEventArgs^)	Raises the DragEnter event.(Inherited from Control.)
	OnDragLeave(EventArgs^)	Raises the DragLeave event.(Inherited from Control.)
	OnDragOver(DragEventArgs^)	Raises the DragOver event.(Inherited from Control.)
	OnEnabledChanged(EventArgs^)	Raises the EnabledChanged event.(Inherited from Form.)
	OnEnter(EventArgs^)	Raises the Enter event.(Inherited from Form.)
	OnFontChanged(EventArgs^)	Raises the FontChanged event.(Inherited from Form.)
	OnForeColorChanged(EventArgs^)	Raises the ForeColorChanged event.(Inherited from Control.)
	OnFormClosed(FormClosedEventArgs^)	Raises the FormClosed event.(Inherited from Form.)
	OnFormClosing(FormClosingEventArgs^)	Raises the FormClosing event.(Inherited from Form.)
	OnGetDpiScaledSize(Int32, Int32, Size%)	Raises the GetDpiScaledSize event. (Inherited from Form.)
	OnGiveFeedback(GiveFeedbackEventArgs^)	Raises the GiveFeedback event.(Inherited from Control.)
	OnGotFocus(EventArgs^)	Raises the GotFocus event.(Inherited from Control.)
	OnHandleCreated(EventArgs^)	Raises the HandleCreated event.(Inherited from Form.)
	OnHandleDestroyed(EventArgs^)	Raises the HandleDestroyed event.(Inherited from Form.)
	OnHelpButtonClicked(CancelEventArgs^)	Raises the HelpButtonClicked event.(Inherited from Form.)
	OnHelpRequested(HelpEventArgs^)	Raises the HelpRequested event.(Inherited from Control.)
	OnImeModeChanged(EventArgs^)	Raises the ImeModeChanged event.(Inherited from Control.)
	OnInputLanguageChanged(InputLanguageChangedEventArgs^)	Raises the InputLanguageChanged event.(Inherited from Form.)
	OnInputLanguageChanging(InputLanguageChangingEventArgs^)	Raises the InputLanguageChanging event.(Inherited from Form.)
	OnInvalidated(InvalidateEventArgs^)	Raises the Invalidated event.(Inherited from Control.)
	OnKeyDown(KeyEventArgs^)	Raises the KeyDown event.(Inherited from Control.)
	OnKeyPress(KeyPressEventArgs^)	Raises the KeyPress event.(Inherited from Control.)
	OnKeyUp(KeyEventArgs^)	Raises the KeyUp event.(Inherited from Control.)
	OnLayout(LayoutEventArgs^)	Raises the Layout event.(Inherited from Form.)
	OnLeave(EventArgs^)	Raises the Leave event.(Inherited from Control.)
	OnLoad(EventArgs^)	Raises the Load event.(Inherited from Form.)
	OnLocationChanged(EventArgs^)	Raises the LocationChanged event.(Inherited from Control.)
	OnLostFocus(EventArgs^)	Raises the LostFocus event.(Inherited from Control.)
	OnMarginChanged(EventArgs^)	Raises the MarginChanged event. (Inherited from Control.)
	OnMaximizedBoundsChanged(EventArgs^)	Raises the MaximizedBoundsChanged event.(Inherited from Form.)
	OnMaximumSizeChanged(EventArgs^)	Raises the MaximumSizeChanged event.(Inherited from Form.)
	OnMdiChildActivate(EventArgs^)	Raises the MdiChildActivate event.(Inherited from Form.)
	OnMenuComplete(EventArgs^)	Raises the MenuComplete event.(Inherited from Form.)
	OnMenuStart(EventArgs^)	Raises the MenuStart event.(Inherited from Form.)
	OnMinimumSizeChanged(EventArgs^)	Raises the MinimumSizeChanged event.(Inherited from Form.)
	OnMouseCaptureChanged(EventArgs^)	Raises the MouseCaptureChanged event.(Inherited from Control.)
	OnMouseClick(MouseEventArgs^)	Raises the MouseClick event.(Inherited from Control.)
	OnMouseDoubleClick(MouseEventArgs^)	Raises the MouseDoubleClick event.(Inherited from Control.)
	OnMouseDown(MouseEventArgs^)	Raises the MouseDown event.(Inherited from Control.)
	OnMouseEnter(EventArgs^)	Raises the MouseEnter event.(Inherited from Control.)
	OnMouseHover(EventArgs^)	Raises the MouseHover event.(Inherited from Control.)
	OnMouseLeave(EventArgs^)	Raises the MouseLeave event.(Inherited from Control.)
	OnMouseMove(MouseEventArgs^)	Raises the MouseMove event.(Inherited from Control.)
	OnMouseUp(MouseEventArgs^)	Raises the MouseUp event.(Inherited from Control.)
	OnMouseWheel(MouseEventArgs^)	Raises the MouseWheel event.(Inherited from ScrollableControl.)
	OnMove(EventArgs^)	Raises the Move event.(Inherited from Control.)
	OnNotifyMessage(Message)	Notifies the control of Windows messages.(Inherited from Control.)
	OnPaddingChanged(EventArgs^)	Raises the PaddingChanged event.(Inherited from ScrollableControl.)
	OnPaint(PaintEventArgs^)	Raises the Paint event.(Inherited from Form.)
	OnPaintBackground(PaintEventArgs^)	Paints the background of the control.(Inherited from ScrollableControl.)
	OnParentBackColorChanged(EventArgs^)	Raises the BackColorChanged event when the BackColor property value of the control's container changes.(Inherited from Control.)
	OnParentBackgroundImageChanged(EventArgs^)	Raises the BackgroundImageChanged event when the BackgroundImage property value of the control's container changes.(Inherited from Control.)
	OnParentBindingContextChanged(EventArgs^)	Raises the BindingContextChanged event when the BindingContext property value of the control's container changes.(Inherited from Control.)
	OnParentChanged(EventArgs^)	Raises the ParentChanged event.(Inherited from ContainerControl.)
	OnParentCursorChanged(EventArgs^)	Raises the CursorChanged event.(Inherited from Control.)
	OnParentEnabledChanged(EventArgs^)	Raises the EnabledChanged event when the Enabled property value of the control's container changes.(Inherited from Control.)
	OnParentFontChanged(EventArgs^)	Raises the FontChanged event when the Font property value of the control's container changes.(Inherited from Control.)
	OnParentForeColorChanged(EventArgs^)	Raises the ForeColorChanged event when the ForeColor property value of the control's container changes.(Inherited from Control.)
	OnParentRightToLeftChanged(EventArgs^)	Raises the RightToLeftChanged event when the RightToLeft property value of the control's container changes.(Inherited from Control.)
	OnParentVisibleChanged(EventArgs^)	Raises the VisibleChanged event when the Visible property value of the control's container changes.(Inherited from Control.)
	OnPreviewKeyDown(PreviewKeyDownEventArgs^)	Raises the PreviewKeyDown event.(Inherited from Control.)
	OnPrint(PaintEventArgs^)	Raises the Paint event. (Inherited from Control.)
	OnQueryContinueDrag(QueryContinueDragEventArgs^)	Raises the QueryContinueDrag event.(Inherited from Control.)
	OnRegionChanged(EventArgs^)	Raises the RegionChanged event. (Inherited from Control.)
	OnResize(EventArgs^)	Raises the Resize event.(Inherited from Form.)
	OnResizeBegin(EventArgs^)	Raises the ResizeBegin event.(Inherited from Form.)
	OnResizeEnd(EventArgs^)	Raises the ResizeEnd event.(Inherited from Form.)
	OnRightToLeftChanged(EventArgs^)	Raises the RightToLeftChanged event.(Inherited from ScrollableControl.)
	OnRightToLeftLayoutChanged(EventArgs^)	Raises the RightToLeftLayoutChanged event.(Inherited from Form.)
	OnScroll(ScrollEventArgs^)	Raises the Scroll event.(Inherited from ScrollableControl.)
	OnShown(EventArgs^)	Raises the Shown event.(Inherited from Form.)
	OnSizeChanged(EventArgs^)	Raises the SizeChanged event.(Inherited from Control.)
	OnStyleChanged(EventArgs^)	Raises the StyleChanged event.(Inherited from Form.)
	OnSystemColorsChanged(EventArgs^)	Raises the SystemColorsChanged event.(Inherited from Control.)
	OnTabIndexChanged(EventArgs^)	Raises the TabIndexChanged event.(Inherited from Control.)
	OnTabStopChanged(EventArgs^)	Raises the TabStopChanged event.(Inherited from Control.)
	OnTextChanged(EventArgs^)	Raises the TextChanged event.(Inherited from Form.)
	OnValidated(EventArgs^)	Raises the Validated event.(Inherited from Control.)
	OnValidating(CancelEventArgs^)	Raises the Validating event.(Inherited from Control.)
	OnVisibleChanged(EventArgs^)	Raises the VisibleChanged event.(Inherited from Form.)
	PerformAutoScale()	Performs scaling of the container control and its children.(Inherited from ContainerControl.)
	PerformLayout()	Forces the control to apply layout logic to all its child controls.(Inherited from Control.)
	PerformLayout(Control^, String^)	Forces the control to apply layout logic to all its child controls.(Inherited from Control.)
	PointToClient(Point)	Computes the location of the specified screen point into client coordinates.(Inherited from Control.)
	PointToScreen(Point)	Computes the location of the specified client point into screen coordinates.(Inherited from Control.)
	PreProcessControlMessage(Message%)	Preprocesses keyboard or input messages within the message loop before they are dispatched.(Inherited from Control.)
	PreProcessMessage(Message%)	Preprocesses keyboard or input messages within the message loop before they are dispatched.(Inherited from Control.)
	ProcessCmdKey(Message%, Keys)	Processes a command key. (Inherited from Form.)
	ProcessDialogChar(Char)	Processes a dialog character.(Inherited from Form.)
	ProcessDialogKey(Keys)	Determines whether a key should be processed further.(Overrides Form::ProcessDialogKey(Keys).)
	ProcessKeyEventArgs(Message%)	Processes a key message and generates the appropriate control events.(Inherited from Control.)
	ProcessKeyMessage(Message%)	Processes a keyboard message.(Inherited from Control.)
	ProcessKeyPreview(Message%)	Previews a keyboard message.(Inherited from Form.)
	ProcessMnemonic(Char)	Processes a mnemonic character.(Inherited from Form.)
	ProcessTabKey(Boolean)	Processes the TAB key.(Overrides Form::ProcessTabKey(Boolean).)
	RaiseDragEvent(Object^, DragEventArgs^)	This API supports the product infrastructure and is not intended to be used directly from your code. Raises the appropriate drag event.(Inherited from Control.)
	RaiseKeyEvent(Object^, KeyEventArgs^)	This API supports the product infrastructure and is not intended to be used directly from your code. Raises the appropriate key event.(Inherited from Control.)
	RaiseMouseEvent(Object^, MouseEventArgs^)	This API supports the product infrastructure and is not intended to be used directly from your code. Raises the appropriate mouse event.(Inherited from Control.)
	RaisePaintEvent(Object^, PaintEventArgs^)	This API supports the product infrastructure and is not intended to be used directly from your code. Raises the appropriate paint event.(Inherited from Control.)
	RecreateHandle()	Forces the re-creation of the handle for the control.(Inherited from Control.)
	RectangleToClient(Rectangle)	Computes the size and location of the specified screen rectangle in client coordinates.(Inherited from Control.)
	RectangleToScreen(Rectangle)	Computes the size and location of the specified client rectangle in screen coordinates.(Inherited from Control.)
	Refresh()	Forces the control to invalidate its client area and immediately redraw itself and any child controls.(Inherited from Control.)
	RemoveOwnedForm(Form^)	Removes an owned form from this form.(Inherited from Form.)
	RescaleConstantsForDpi(Int32, Int32)	Provides constants for rescaling the control when a DPI change occurs.(Inherited from Control.)
	ResetBackColor()	Resets the BackColor property to its default value.(Inherited from Control.)
	ResetBindings()	Causes a control bound to the BindingSource to reread all the items in the list and refresh their displayed values.(Inherited from Control.)
	ResetCursor()	Resets the Cursor property to its default value.(Inherited from Control.)
	ResetFont()	Resets the Font property to its default value.(Inherited from Control.)
	ResetForeColor()	Resets the ForeColor property to its default value.(Inherited from Control.)
	ResetImeMode()	Resets the ImeMode property to its default value.(Inherited from Control.)
	ResetMouseEventArgs()	This API supports the product infrastructure and is not intended to be used directly from your code. Resets the control to handle the MouseLeave event.(Inherited from Control.)
	ResetRightToLeft()	Resets the RightToLeft property to its default value.(Inherited from Control.)
	ResetText()	Resets the Text property to its default value.(Inherited from Control.)
	ResumeLayout()	Resumes usual layout logic.(Inherited from Control.)
	ResumeLayout(Boolean)	Resumes usual layout logic, optionally forcing an immediate layout of pending layout requests.(Inherited from Control.)
	RtlTranslateAlignment(ContentAlignment)	Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text.(Inherited from Control.)
	RtlTranslateAlignment(HorizontalAlignment)	Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text.(Inherited from Control.)
	RtlTranslateAlignment(LeftRightAlignment)	Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text.(Inherited from Control.)
	RtlTranslateContent(ContentAlignment)	Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text.(Inherited from Control.)
	RtlTranslateHorizontal(HorizontalAlignment)	Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text.(Inherited from Control.)
	RtlTranslateLeftRight(LeftRightAlignment)	Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text.(Inherited from Control.)
	Scale(Single)	Obsolete. Scales the control and any child controls.(Inherited from Control.)
	Scale(Single, Single)	Obsolete. Scales the entire control and any child controls.(Inherited from Control.)
	Scale(SizeF)	Scales the control and all child controls by the specified scaling factor.(Inherited from Control.)
	ScaleBitmapLogicalToDevice(Bitmap^%)	Scales a logical bitmap value to it's equivalent device unit value when a DPI change occurs.(Inherited from Control.)
	ScaleControl(SizeF, BoundsSpecified)	Scales the location, size, padding, and margin of a control.(Inherited from Form.)
	ScaleCore(Single, Single)	Performs scaling of the form.(Inherited from Form.)
	ScrollControlIntoView(Control^)	Scrolls the specified child control into view on an auto-scroll enabled control.(Inherited from ScrollableControl.)
	ScrollToControl(Control^)	Calculates the scroll offset to the specified child control. (Inherited from ScrollableControl.)
	Select()	Activates the control.(Inherited from Control.)
	Select(Boolean, Boolean)	Selects this form, and optionally selects the next or previous control.(Inherited from Form.)
	SelectNextControl(Control^, Boolean, Boolean, Boolean, Boolean)	Activates the next control.(Inherited from Control.)
	SendToBack()	Sends the control to the back of the z-order.(Inherited from Control.)
	SetAutoScrollMargin(Int32, Int32)	Sets the size of the auto-scroll margins.(Inherited from ScrollableControl.)
	SetAutoSizeMode(AutoSizeMode)	Sets a value indicating how a control will behave when its AutoSize property is enabled.(Inherited from Control.)
	SetBounds(Int32, Int32, Int32, Int32)	Sets the bounds of the control to the specified location and size.(Inherited from Control.)
	SetBounds(Int32, Int32, Int32, Int32, BoundsSpecified)	Sets the specified bounds of the control to the specified location and size.(Inherited from Control.)
	SetBoundsCore(Int32, Int32, Int32, Int32, BoundsSpecified)	Performs the work of setting the specified bounds of this control.(Inherited from Form.)
	SetClientSizeCore(Int32, Int32)	Sets the client size of the form. This will adjust the bounds of the form to make the client size the requested size.(Inherited from Form.)
	SetDesktopBounds(Int32, Int32, Int32, Int32)	Sets the bounds of the form in desktop coordinates.(Inherited from Form.)
	SetDesktopLocation(Int32, Int32)	Sets the location of the form in desktop coordinates.(Inherited from Form.)
	SetDisplayRectLocation(Int32, Int32)	Positions the display window to the specified value.(Inherited from ScrollableControl.)
	SetScrollState(Int32, Boolean)	Sets the specified scroll state flag.(Inherited from ScrollableControl.)
	SetStyle(ControlStyles, Boolean)	Sets a specified ControlStyles flag to either true or false.(Inherited from Control.)
	SetTopLevel(Boolean)	Sets the control as the top-level control.(Inherited from Control.)
	SetVisibleCore(Boolean)	Sets the control to the specified visible state.(Inherited from Form.)
	Show()	Displays the control to the user.(Inherited from Control.)
	Show(IWin32Window^)	Shows the form with the specified owner to the user.(Inherited from Form.)
	ShowDialog()	Shows the form as a modal dialog box.(Inherited from Form.)
	ShowDialog(IWin32Window^)	Shows the form as a modal dialog box with the specified owner.(Inherited from Form.)
	SizeFromClientSize(Size)	Determines the size of the entire control from the height and width of its client area.(Inherited from Control.)
	SuspendLayout()	Temporarily suspends the layout logic for the control.(Inherited from Control.)
	ToString()	Gets a string representing the current instance of the form.(Inherited from Form.)
	Update()	Causes the control to redraw the invalidated regions within its client area.(Inherited from Control.)
	UpdateBounds()	Updates the bounds of the control with the current size and location.(Inherited from Control.)
	UpdateBounds(Int32, Int32, Int32, Int32)	Updates the bounds of the control with the specified size and location.(Inherited from Control.)
	UpdateBounds(Int32, Int32, Int32, Int32, Int32, Int32)	Updates the bounds of the control with the specified size, location, and client size.(Inherited from Control.)
	UpdateDefaultButton()	Updates which button is the default button.(Inherited from Form.)
	UpdateStyles()	Forces the assigned styles to be reapplied to the control.(Inherited from Control.)
	UpdateZOrder()	Updates the control in its parent's z-order.(Inherited from Control.)
	Validate()	Verifies the value of the control losing focus by causing the Validating and Validated events to occur, in that order. (Inherited from ContainerControl.)
	Validate(Boolean)	Verifies the value of the control that is losing focus; conditionally dependent on whether automatic validation is turned on. (Inherited from ContainerControl.)
	ValidateChildren()	Causes all of the child controls within a control that support validation to validate their data. (Inherited from Form.)
	ValidateChildren(ValidationConstraints)	Causes all of the child controls within a control that support validation to validate their data. (Inherited from Form.)
	WndProc(Message%)	Processes Windows messages.(Inherited from Form.)

Events

	Name	Description
	Activated	Occurs when the form is activated in code or by the user.(Inherited from Form.)
	AutoSizeChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the AutoSize property changes.
	AutoValidateChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the AutoValidate property changes.
	BackColorChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the BackColor property changes.
	BackgroundImageChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the BackgroundImage property changes.
	BackgroundImageLayoutChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the BackgroundImageLayout property changes.
	BindingContextChanged	Occurs when the value of the BindingContext property changes.(Inherited from Control.)
	CausesValidationChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the CausesValidation property changes.
	ChangeUICues	Occurs when the focus or keyboard user interface (UI) cues change.(Inherited from Control.)
	Click	Occurs when the control is clicked.(Inherited from Control.)
	ClientSizeChanged	Occurs when the value of the ClientSize property changes. (Inherited from Control.)
	Closed	Occurs when the form is closed. (Inherited from Form.)
	Closing	Occurs when the form is closing.(Inherited from Form.)
	ContextMenuChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the ContextMenu property changes.
	ContextMenuStripChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the ContextMenuStrip property changes.
	ControlAdded	Occurs when a new control is added to the Control::ControlCollection.(Inherited from Control.)
	ControlRemoved	Occurs when a control is removed from the Control::ControlCollection.(Inherited from Control.)
	CursorChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the Cursor property changes.
	Deactivate	Occurs when the form loses focus and is no longer the active form.(Inherited from Form.)
	Disposed	Occurs when the component is disposed by a call to the Dispose method. (Inherited from Component.)
	DockChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the Dock property changes.
	DoubleClick	Occurs when the control is double-clicked.(Inherited from Control.)
	DpiChanged	Occurs when the DPI setting changes on the display device where the form is currently displayed.(Inherited from Form.)
	DpiChangedAfterParent	Occurs when the DPI setting for a control is changed programmatically after the DPI of it's parent control or form has changed.(Inherited from Control.)
	DpiChangedBeforeParent	Occurs when the DPI setting for a control is changed programmatically before a DPI change event for it's parent control or form has occurred.(Inherited from Control.)
	DragDrop	Occurs when a drag-and-drop operation is completed.(Inherited from Control.)
	DragEnter	Occurs when an object is dragged into the control's bounds.(Inherited from Control.)
	DragLeave	Occurs when an object is dragged out of the control's bounds.(Inherited from Control.)
	DragOver	Occurs when an object is dragged over the control's bounds.(Inherited from Control.)
	EnabledChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the Enabled property changes.
	Enter	Occurs when the control is entered.(Inherited from Control.)
	FontChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the Font property changes.
	ForeColorChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the ForeColor property changes.
	FormClosed	Occurs after the form is closed.(Inherited from Form.)
	FormClosing	Occurs before the form is closed.(Inherited from Form.)
	GiveFeedback	Occurs during a drag operation.(Inherited from Control.)
	GotFocus	Occurs when the control receives focus.(Inherited from Control.)
	HandleCreated	Occurs when a handle is created for the control.(Inherited from Control.)
	HandleDestroyed	Occurs when the control's handle is in the process of being destroyed.(Inherited from Control.)
	HelpButtonClicked	Occurs when the Help button is clicked.(Inherited from Form.)
	HelpRequested	Occurs when the user requests help for a control.(Inherited from Control.)
	ImeModeChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the ImeMode property changes.
	InputLanguageChanged	Occurs after the input language of the form has changed.(Inherited from Form.)
	InputLanguageChanging	Occurs when the user attempts to change the input language for the form.(Inherited from Form.)
	Invalidated	Occurs when a control's display requires redrawing.(Inherited from Control.)
	KeyDown	Occurs when a key is pressed while the control has focus.(Inherited from Control.)
	KeyPress	Occurs when a character. space or backspace key is pressed while the control has focus.(Inherited from Control.)
	KeyUp	Occurs when a key is released while the control has focus.(Inherited from Control.)
	Layout	Occurs when a control should reposition its child controls.(Inherited from Control.)
	Leave	Occurs when the input focus leaves the control.(Inherited from Control.)
	Load	Occurs before a form is displayed for the first time.(Inherited from Form.)
	LocationChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the Location property changes.
	LostFocus	Occurs when the control loses focus.(Inherited from Control.)
	MarginChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the Margin property changes.
	MaximizedBoundsChanged	Occurs when the value of the MaximizedBounds property has changed.(Inherited from Form.)
	MaximumSizeChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the MaximumSize property changes.
	MdiChildActivate	Occurs when a multiple-document interface (MDI) child form is activated or closed within an MDI application.(Inherited from Form.)
	MenuComplete	Occurs when the menu of a form loses focus.(Inherited from Form.)
	MenuStart	Occurs when the menu of a form receives focus.(Inherited from Form.)
	MinimumSizeChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the MinimumSize property changes.
	MouseCaptureChanged	Occurs when the control loses mouse capture.(Inherited from Control.)
	MouseClick	Occurs when the control is clicked by the mouse.(Inherited from Control.)
	MouseDoubleClick	Occurs when the control is double clicked by the mouse.(Inherited from Control.)
	MouseDown	Occurs when the mouse pointer is over the control and a mouse button is pressed.(Inherited from Control.)
	MouseEnter	Occurs when the mouse pointer enters the control.(Inherited from Control.)
	MouseHover	Occurs when the mouse pointer rests on the control.(Inherited from Control.)
	MouseLeave	Occurs when the mouse pointer leaves the control.(Inherited from Control.)
	MouseMove	Occurs when the mouse pointer is moved over the control.(Inherited from Control.)
	MouseUp	Occurs when the mouse pointer is over the control and a mouse button is released.(Inherited from Control.)
	MouseWheel	Occurs when the mouse wheel moves while the control has focus.(Inherited from Control.)
	Move	Occurs when the control is moved.(Inherited from Control.)
	PaddingChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the Padding property changes.
	Paint	Occurs when the control is redrawn.(Inherited from Control.)
	ParentChanged	Occurs when the Parent property value changes.(Inherited from Control.)
	PreviewKeyDown	Occurs before the KeyDown event when a key is pressed while focus is on this control.(Inherited from Control.)
	QueryAccessibilityHelp	Occurs when AccessibleObject is providing help to accessibility applications.(Inherited from Control.)
	QueryContinueDrag	Occurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled.(Inherited from Control.)
	RegionChanged	Occurs when the value of the Region property changes.(Inherited from Control.)
	Resize	Occurs when the control is resized.(Inherited from Control.)
	ResizeBegin	Occurs when a form enters resizing mode.(Inherited from Form.)
	ResizeEnd	Occurs when a form exits resizing mode.(Inherited from Form.)
	RightToLeftChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the RightToLeft property changes.
	RightToLeftLayoutChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when value of the RightToLeftLayout property changes.
	Scroll	Occurs when the user or code scrolls through the client area.(Inherited from ScrollableControl.)
	Shown	Occurs whenever the form is first displayed.(Inherited from Form.)
	SizeChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the Size property changes.
	StyleChanged	Occurs when the control style changes.(Inherited from Control.)
	SystemColorsChanged	Occurs when the system colors change.(Inherited from Control.)
	TabIndexChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the TabIndex property changes.(Inherited from Form.)
	TabStopChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the TabStop property changes.
	TextChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the Text property changes.
	Validated	Occurs when the control is finished validating.(Inherited from Control.)
	Validating	Occurs when the control is validating.(Inherited from Control.)
	VisibleChanged	This API supports the product infrastructure and is not intended to be used directly from your code. Occurs when the value of the Visible property changes.

Explicit Interface Implementations

	Name	Description
	IContainerControl::ActivateControl(Control^)	Activates the specified control.(Inherited from ContainerControl.)
	IDropTarget::OnDragDrop(DragEventArgs^)	This API supports the product infrastructure and is not intended to be used directly from your code. Raises the DragDrop event.(Inherited from Control.)
	IDropTarget::OnDragEnter(DragEventArgs^)	This API supports the product infrastructure and is not intended to be used directly from your code. Raises the DragEnter event.(Inherited from Control.)
	IDropTarget::OnDragLeave(EventArgs^)	This API supports the product infrastructure and is not intended to be used directly from your code. Raises the DragLeave event.(Inherited from Control.)
	IDropTarget::OnDragOver(DragEventArgs^)	This API supports the product infrastructure and is not intended to be used directly from your code. Raises the DragOver event.(Inherited from Control.)

Remarks

When you create an instance of the PrintPreviewDialog class, some of the read/write properties are set to initial values. For a list of these values, see the PrintPreviewDialog constructor.

For more information about printing with Windows Forms, see the System.Drawing.Printing namespace overview. If you wish to print from a Windows Presentation Foundation application, see the System.Printing namespace.

Examples

The following code example demonstrates the PrintPreviewDialog setting the Document and UseAntiAlias properties. The example assumes the form contains a TreeView named TreeView1 that contains TreeNode objects. The Tag property of each TreeNode object must be set to a fully qualified document name that can be accessed by the machine running the example. Set each TreeNode::Text property to a string that identifies the file specified by the TreeNode::Tag property. For example, you could set TreeNode1.Tag to "c:\myDocuments\recipe.doc" and TreeNode1.Text to "recipe.doc". The example also assumes the form contains a PrintPreviewDialog named PrintPreviewDialog1 and a button named Button1. To run this example, call the InitializePrintPreviewDialog method in the form's constructor or Load event handler.

C++

   // Declare the dialog.
internal:
   PrintPreviewDialog^ PrintPreviewDialog1;

private:

   // Declare a PrintDocument object named document.
   System::Drawing::Printing::PrintDocument^ document;

   // Initalize the dialog.
   void InitializePrintPreviewDialog()
   {

      // Create a new PrintPreviewDialog using constructor.
      this->PrintPreviewDialog1 = gcnew PrintPreviewDialog;

      //Set the size, location, and name.
      this->PrintPreviewDialog1->ClientSize = System::Drawing::Size( 400, 300 );
      this->PrintPreviewDialog1->Location = System::Drawing::Point( 29, 29 );
      this->PrintPreviewDialog1->Name = "PrintPreviewDialog1";

      // Associate the event-handling method with the 
      // document's PrintPage event.
      this->document->PrintPage += gcnew System::Drawing::Printing::PrintPageEventHandler( this, &Form1::document_PrintPage );

      // Set the minimum size the dialog can be resized to.
      this->PrintPreviewDialog1->MinimumSize = System::Drawing::Size( 375, 250 );

      // Set the UseAntiAlias property to true, which will allow the 
      // operating system to smooth fonts.
      this->PrintPreviewDialog1->UseAntiAlias = true;
   }

   void Button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      if ( TreeView1->SelectedNode != nullptr )
      {
         document->DocumentName = TreeView1->SelectedNode->Tag->ToString();
      }

      // Set the PrintPreviewDialog.Document property to
      // the PrintDocument object selected by the user.
      PrintPreviewDialog1->Document = document;

      // Call the ShowDialog method. This will trigger the document's
      //  PrintPage event.
      PrintPreviewDialog1->ShowDialog();
   }

   void document_PrintPage( Object^ /*sender*/, System::Drawing::Printing::PrintPageEventArgs^ e )
   {

      // Insert code to render the page here.
      // This code will be called when the PrintPreviewDialog.Show 
      // method is called.
      // The following code will render a simple
      // message on the document in the dialog.
      String^ text = "In document_PrintPage method.";
      System::Drawing::Font^ printFont = gcnew System::Drawing::Font( "Arial",35,System::Drawing::FontStyle::Regular );
      e->Graphics->DrawString( text, printFont, System::Drawing::Brushes::Black, 0, 0 );
   }

Version Information

.NET Framework
Available since 1.1

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Deutsch	English	Español	Français
Italiano	日本語	한국어	Português
Pусский	简体中文	繁體中文