Properties for DataWindow controls

You can set properties of a DataWindow control in the window or user object painter or in code.

**Table 7-2: Properties of DataWindow controls**
DataWindow property	Datatype	Description
Border	Boolean	Specifies whether the control has a border. Values are: True – Control has a border. False – Control does not have a border.
BorderStyle	BorderStyle (enumerated)	Specifies the border style of the control. Values are: StyleBox! StyleLowered! StyleRaised! StyleShadowBox!
BringToTop	Boolean	Specifies whether PowerBuilder moves the control to the top of the front-to-back order.
ClassDefinition	PowerObject	An object of type PowerObject containing information about the class definition of the object or control.
ControlMenu	Boolean	Specifies whether the Control Menu box displays in the control title bar. Values are: True – Control Menu box displays in the control title bar. False – Control Menu box does not display in the control title bar.
DataObject	String	Specifies the name of the DataWindow object or Report object associated with the control.
DragAuto	Boolean	Specifies whether PowerBuilder puts the control automatically into Drag Mode. DragAuto has these boolean values: True – When the control is clicked, the control is automatically in Drag Mode. False – When the control is clicked, the control is not automatically in Drag Mode. You have to manually put the control into Drag Mode by using the Drag function.
DragIcon	String	Specifies the name of the stock icon or the file containing the icon you want to display when the user drags the control (the ICO file). The default icon is a box the size of the control. When the user drags the control, the icon displays when the control is over an area in which the control can be dropped (a valid drop area). When the control is over an area that is not a valid drop area, the No-Drop icon displays.
Enabled	Boolean	Specifies whether the control is enabled (can be selected). Values are: True – Control is enabled. False – Control is not enabled.
Height	Integer	Specifies the height of the DataWindow control, in PowerBuilder units.
HScrollBar	Boolean	Specifies whether a horizontal scroll bar displays in the control when all the data cannot be displayed at one time. Values are: True – Horizontal scroll bar is displayed. False – Horizontal scroll bar is not displayed.
HSplitScroll	Boolean	Specifies whether the split bar displays in the control. Values are: True – Split bar is displayed. False – Split bar is not displayed.
Icon	String	Specifies the name of the ICO file that contains the icon that displays when the DataWindow control is minimized.
LiveScroll	Boolean	Scrolls the rows in the DataWindow control while the user is moving the scroll box.
MaxBox	Boolean	Specifies whether a Maximize Box displays in the DataWindow control title bar. Values are: True – Maximize Box displays. False – Maximize Box does not display.
MinBox	Boolean	Specifies whether a Minimize Box displays in the DataWindow control title bar. Values are: True – Minimize Box displays. False – Minimize Box does not display.
Object	DWObject	Used for the direct manipulation of controls within a DataWindow object from a script. These controls could be, for example, columns or text controls. For information, see Chapter 4, “Accessing Data in Code” and Chapter 5, “Accessing DataWindow Object Properties in Code.”
Resizable	Boolean	Specifies whether the DataWindow control is resizeable. Values are: True – DataWindow is resizeable. False – DataWindow is not resizeable.
RightToLeft	Boolean	Specifies that characters should be displayed in right-to-left order. The application must be running on a Hebrew or Arabic version of PowerBuilder under an operating system that supports right-to-left display. Values are: True – Characters display in right-to-left order. False – Characters display in left-to-right order.
TabOrder	Integer	Specifies the tab value of the DataWindow control within the window or user object. (0 means the user cannot tab to the control.)
Tag	String	Specifies the tag value assigned to the DataWindow control.
Title	String	Specifies the text that displays in the DataWindow control title bar.
TitleBar	Boolean	Specifies whether a title bar displays in the DataWindow control. The user can move the DataWindow control only if it has a title bar. Values are: True – Title bar is displayed in control. False – No title bar is displayed in control.
Visible	Boolean	Specifies whether the DataWindow control is visible. Values are: True – Control is visible. False – Control is not visible.
VScrollBar	Boolean	Specifies whether a vertical scroll bar displays in the control when not all the data can be displayed at one time. Values are: True – Vertical scroll bar is displayed. False – Vertical scroll bar is not displayed.
Width	Integer	Specifies the width of the DataWindow control, in PowerBuilder units.
X	Integer	Specifies the X position (the distance from the left edge of the window), in PowerBuilder units.
Y	Integer	Specifies the Y position (the distance from the top edge of the window), in PowerBuilder units.