Unit 'Controls' Package
[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] [#lcl]

TControl.Width

The horizontal size for the control.

Declaration

Source position: controls.pp line 1779

published property TControl.Width : Integer
  read FWidth
  write SetWidth;

Description

Width is an Integer property with the horizontal size for the control in pixels.

Setting a negative value in Width is not allowed, and the property defaults to 0 (zero). At design-time, setting Width to a value not in the range 0..9999 causes an ELayoutException to be raised (and handled in the IDE).

Setting a new value for the property causes SetBounds and ChangeBounds to be called. This ensures that the new value is is the range allowed in Constraints, and that the control is aligned on its Parent using the Anchors for the control.

A value assigned to Width is ignored when AutoSize is set to True; the control is automatically adjusted to the size needed for its aligned content.

Values in Top, Left, Width, and Height are used to calculate the display area for the control in GetClientRect. They determine the clipping rectangle used when the control is drawn on its Parent.

See also

TControl.Height

  

The vertical size for the control.

TControl.Left

  

The client coordinate with the left edge for the control.

TControl.Top

  

The client coordinate for the top edge of the control.

TControl.Parent

  

The control within which the control is shown.

TControl.GetClientRect

  

Gets the value for the ClientRect property.

TControl.SetBounds

  

Sets the bounds (Left, Top, Width, Height) of the control.

TControl.ChangeBounds

  

Sets the bounds (left, top, height, width) and optionally the BaseBounds of the control.



CT Web help

CodeTyphon Studio