PrintPreviewDialog.KeyPreview Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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.

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

[BrowsableAttribute(false)]
public bool KeyPreview { get; set; }

Property Value

Type: System.Boolean

true if the form will receive all key events; false if the currently selected control on the form receives key events. The default is false.

This property is not relevant for this class.

When this property is set to true, the form will receive all KeyPress, KeyDown, and KeyUp events. After the form's event handlers have completed processing the keystroke, the keystroke is then assigned to the control with focus.

You can use this property to process all keystrokes in your application and either handle the keystroke or call the appropriate control to handle the keystroke. For example, when an application uses function keys, you might want to process the keystrokes at the form level rather than writing code for each control that might receive keystroke events.

System_CAPS_noteNote

If a form has no visible or enabled controls, it automatically receives all keyboard events.

.NET Framework
Available since 1.1
Return to top
Show: