SftBoxDropDown.OptimalWidth Property	Softel vdm, Inc.

Defines whether the drop down portion is optimally sized in width.

Syntax       

	Get
		VB.NET	Boolean = object.OptimalWidth  As Boolean
		VB	Boolean = object.OptimalWidth  As Boolean
		C#.NET	bool Boolean = object.OptimalWidth;
		VC++	VARIANT_BOOL Boolean = object->OptimalWidth; VARIANT_BOOL Boolean = object->GetOptimalWidth();
		C	HRESULT object->get_OptimalWidth(VARIANT_BOOL* Boolean);
		Delphi	Boolean := object.OptimalWidth   : WordBool;
	Put
		VB.NET	object.OptimalWidth = Boolean  As Boolean
		VB	object.OptimalWidth = Boolean  As Boolean
		C#.NET	bool object.OptimalWidth = Boolean;
		VC++	VARIANT_BOOL object->OptimalWidth = Boolean; void object->PutOptimalWidth(VARIANT_BOOL Boolean);
		C	HRESULT object->put_OptimalWidth(VARIANT_BOOL Boolean);
		Delphi	object.OptimalWidth := Boolean   : WordBool;

object

A SftBoxDropDown object.

Boolean

Defines whether the drop down portion is optimally sized in width.

Boolean	Description
True	The drop down portion is optimally sized in width.
False	The drop down portion is not resized.

Comments

The OptimalWidth property defines whether the drop down portion is optimally sized in width.

The OptimalWidth property overrides the DropDown.Width, DropDown.WidthPix and DropDown.WidthPercent properties. When the drop down portion becomes visible, it is optimally sized in width so all data can be displayed without being horizontally clipped. It accomplishes this by displaying as much of the data as possible by using the defined horizontal extent (see Items.HorizontalExtent).

The OptimalWidth property will increase the size of the drop down portion based on its defined width (see DropDown.Width, DropDown.WidthPercent and DropDown.WidthPix) to accommodate as much data as possible, but will not decrease it.

The OptimalWidth property requires the use of the Items.RecalcHorizontalExtent method after all data has been added to determine the horizontal extent.