DropDown(Control,Control,Control,EventHandler,Rectangle,Size,Point,Boolean,Boolean,Boolean,Boolean,DropDownPosition) Method

Static method that creates and displays a dropdown window

Syntax

Visual Basic

'Declaration
 
Public Overloads Shared Sub DropDown( _
   ByVal owner As Control, _
   ByVal dropdownControl As Control, _
   ByVal editControl As Control, _
   ByVal closeUpHandler As EventHandler, _
   ByVal exclusionArea As Rectangle, _
   ByVal dropDownSize As Size, _
   ByVal location As Point, _
   ByVal alignRight As Boolean, _
   ByVal clearExisting As Boolean, _
   ByVal autoCloseUp As Boolean, _
   ByVal ignoreClicksInExclusionArea As Boolean, _
   ByVal dropDownPosition As DropDownPosition _
) 

C#

public static void DropDown( 
   Control owner,
   Control dropdownControl,
   Control editControl,
   EventHandler closeUpHandler,
   Rectangle exclusionArea,
   Size dropDownSize,
   Point location,
   bool alignRight,
   bool clearExisting,
   bool autoCloseUp,
   bool ignoreClicksInExclusionArea,
   DropDownPosition dropDownPosition
)

Parameters

owner

The control that owns the dropdown

dropdownControl

The control that will be placed on the dropdown form to take up its entire client area.

editControl

An optional edit control. Clicking on this edit window with the mouse will not cause the dropdown to closeup.

closeUpHandler

The method will be called after the dropdown closes up.

exclusionArea

This rect (in screen coordinates) will not be obscured by the dropdown.

dropDownSize

The requested size of the dropdown.

location

Where to try to place the dropdown (in screen coordinates) .

alignRight

If true wil attempt to place the dropdown's upper right corner at the location point.

clearExisting

If any currently dropped down windows should be closed.

autoCloseUp

If dropdown should be automatically closed when mouse is clicked outside of dropdown.

ignoreClicksInExclusionArea

If false then clicks inside the exclusion area should automatically close the dropdown.

dropDownPosition

Determines where to place the dropdown with respect to the exclusion rect.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2