FileDialog.HookProc Method

This member overrides CommonDialog.HookProc(IntPtr, Int32, IntPtr, IntPtr), and more complete documentation might be available in that topic.

Defines the common dialog box hook procedure that is overridden to add specific functionality to the file dialog box.

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

[SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)]
protected override IntPtr HookProc(
	IntPtr hWnd,
	int msg,
	IntPtr wparam,
	IntPtr lparam


Type: System.IntPtr

The handle to the dialog box window.

Type: System.Int32

The message received by the dialog box.

Type: System.IntPtr

Additional information about the message.

Type: System.IntPtr

Additional information about the message.

Return Value

Type: System.IntPtr
Returns zero if the default dialog box procedure processes the message; returns a nonzero value if the default dialog box procedure ignores the message.

A hook procedure allows the user to connect or insert other routines into a routine or application for the purpose of debugging or enhancing functionality.

By default, the hook procedure centers the dialog box on the screen in response to a WM_INITDIALOG message.

Notes to Inheritors

When overriding HookProc in a derived class, be sure to call the base class's HookProc method.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
© 2015 Microsoft