PopupControl Class

public class PopupControl : Form, IDisposable

public PopupControl()

protected virtual bool AutoClose { get; set; }

Property Value

bool:

true if the popup should be closed when system events occur; otherwise, false.

protected override CreateParams CreateParams { get; }

Property Value

CreateParams:

A CreateParams that contains the required creation parameters when the handle to the control is created.

public bool DropShadowEnabled { get; set; }

Property Value

bool:

true if a drop-shadow is enabled; otherwise, false. The default value is true.

Remarks

Even when true, a drop-shadow will not be shown if the system does not support drop-shadow.

protected override void Dispose(bool disposing)

Parameter	Type	Description
disposing	bool	true to release both managed and unmanaged resources; false to release only unmanaged resources.

public virtual void HidePopup()

public void NegotiateLocation(Rectangle exclusionBounds, Corner exclusionCorner, Orientation orientation, int offset)

Parameter	Type	Description
exclusionBounds	Rectangle	The bounds over which the object may not be displayed.
exclusionCorner	Corner	The corner of the exclusion bounds at which to place the popup.
orientation	Orientation	Whether the popup should extend horizontally or vertically from the corner.
offset	int	The amount to offset from the exclusion bounds.

public void NegotiateLocation(Rectangle exclusionBounds, int offset)

Parameter	Type	Description
exclusionBounds	Rectangle	The bounds over which the object may not be displayed.
offset	int	The amount to offset from the exclusion bounds.

Remarks

This method defaults to extending the popup vertically from the lower left corner.

protected virtual void OnDisplayed(EventArgs e)

Parameter	Type	Description
e	EventArgs	The event data.

protected virtual void OnDisplaying(EventArgs e)

Parameter	Type	Description
e	EventArgs	The event data.

protected override void OnHandleCreated(EventArgs e)

Parameter	Type	Description
e	EventArgs	An EventArgs that contains the event data.

protected virtual void OnHidden(EventArgs e)

Parameter	Type	Description
e	EventArgs	The event data.

protected virtual void OnHiding(EventArgs e)

Parameter	Type	Description
e	EventArgs	The event data.

protected override void OnVisibleChanged(EventArgs e)

Parameter	Type	Description
e	EventArgs	The EventArgs that contains the event data.

protected override bool ProcessCmdKey(ref Message m, Keys keyData)

Parameter	Type	Description
m	Message
keyData	Keys	One of the Keys values that represents the key to process.

Returns

bool:

true if the keystroke was processed and consumed by the control; otherwise, false to allow further processing.

protected override void SetBoundsCore(int x, int y, int width, int height, BoundsSpecified specified)

Parameter	Type	Description
x	int	The new Left property value of the control.
y	int	The new Top property value of the control.
width	int	The new Width property value of the control.
height	int	The new Height property value of the control.
specified	BoundsSpecified	A bitwise combination of the BoundsSpecified values.

protected override void SetVisibleCore(bool visible)

Parameter	Type	Description
visible	bool

public virtual void ShowPopup(Control? owner, bool activate)

Parameter	Type	Description
owner	Control	The Control that is the owner of the popup.
activate	bool	Whether the form should be activated after being displayed.

protected override void WndProc(ref Message m)

Parameter	Type	Description
m	Message	The Windows Message to process.

public event EventHandler? Displayed

Event Type

EventHandler

public event EventHandler? Displaying

Event Type

EventHandler

public event EventHandler? Hidden

Event Type

EventHandler

public event EventHandler? Hiding

Event Type

EventHandler