SftBox.HorizontalExtent Property
Defines the current horizontal scrolling extent.
Deprecated - Provided for compatibility with earlier versions only - Use Items.HorizontalExtent instead
Syntax
Get
| VB.NET | Extent = object.HorizontalExtent As Integer |
| VB | Extent = object.HorizontalExtent As Long |
| C#.NET | int Extent = object.HorizontalExtent; |
| VC++ | long Extent = object->HorizontalExtent;
long Extent = object->GetHorizontalExtent(); |
| C | HRESULT object->get_HorizontalExtent(long* Extent); |
Put
| VB.NET | object.HorizontalExtent = Extent As Integer |
| VB | object.HorizontalExtent = Extent As Long |
| C#.NET | int object.HorizontalExtent = Extent; |
| VC++ | long object->HorizontalExtent = Extent;
void object->PutHorizontalExtent(long Extent); |
| C | HRESULT object->put_HorizontalExtent(long Extent); |
object
A SftBox object.
Extent
Defines the horizontal scrolling extent. If this value is 0 (or less than the width of the control), horizontal scrolling is disabled. The units used are pixels.
Comments
Deprecated - Provided for compatibility with earlier versions only - Use Items.HorizontalExtent instead
The HorizontalExtent property defines the current horizontal scrolling extent.
The displayable area of the drop down portion can be wider than the window width. If the displayable area is wider, the control can be scrolled horizontally if it has a horizontal scroll bar (see Scrollbars property). The width of the displayable area can be set by the application using the Items.RecalcHorizontalExtent method or the Items.HorizontalExtent property. For performance reasons, the optimal width is not automatically calculated when adding items to a control.
The width Extent set using this property must be equal to or greater than the combined column widths plus the width returned by the Columns.OverheadWidth property.
If the width set is smaller than the actual drop down portion width, the drop down portion cannot be scrolled horizontally. The horizontal scroll bar will be disabled or hidden, based on the Scrollbars property.
By default, the control does not handle horizontal scrolling, even if the Scrollbars property defines scroll bars to be available. To start horizontal scrolling, an application has to use the Items.RecalcHorizontalExtent method or the Items.HorizontalExtent property. They indicate to the control that horizontal scrolling support is desired and allows it to determine the horizontal scrolling extent.
The control doesn't automatically update the horizontal extent when items are added or deleted or other methods or properties are used, which may invalidate the horizontal extent. The Items.RecalcHorizontalExtent method or Items.HorizontalExtent property have to be used again to recalculate or redefine the extent.
This property is not available at design-time.
See Also SftBox Object | Object Hierarchy
On
Off