User Tools

Site Tools


region_control_properties.htm
Navigation:  Window and Report Control Properties >====== Region Control Properties ====== Previous pageReturn to chapter overviewNext page

NoteBox.jpg

The Property View presents you with two ways to viewing a control's properties.

At the top of the Property View, press the categorized button categorized.jpg to view a control's properties by category (the deafult).

Or press the alphabetical button alphabetical.jpg to view a control's properties in alphabetical order.

This help documents displays the properties in the categorical view.

Color

Enter a valid color equate in the BorderColor or FillColor fields, or press the ellipsis (…) button to select a color from the Color dialog. The Window Designer adds the COLOR attribute to your control declaration.

See ..\LIBSRC\EQUATES.CLW for a list of valid color equates. See Windows Design Issues in the User's Guide for a discussion on using color to enhance your application.

Design

Locked “Freezes” the control so that subsequent data dictionary changes are not applied. You can override the #Freeze attribute for all controls or for individual controls. See Application Options.
Suppress TransparencySTBut.jpg Allows the proper display of special static parent controls when populated “on top of” multiple tab controls. This property is set to TRUE by default, and ensures a proper display regardless of Visual Styles used. No effect on runtime window.
Tab Index Determines the index in the TAB order that this control will follow. The first tab in the order is index zero (0).To change the TabIndex property immediately while in the Designer, use the Show tab order interface (i.e. on the right-click menu).If you set the TabIndex property using the property page, the z-order is not updated until you save and exit the Window Designer.

Extra

Bevel Gives a three dimensional look to the control. The control appears raised, depressed, or both. The Window Designer adds the BEVEL attribute to your control declaration. Fine tune the bevel with the following prompts:
Outer A positive value makes the control appear raised above the plane of the window. The higher the value, the further the box is raised. A negative value makes the control appear depressed below the plane of the window. The bevel effect begins at the outer border of the box.
Inner A positive value makes the control appear raised above the plane of the window. The higher the value, the further the box is raised. A negative value makes the control appear depressed below the plane of the window. The bevel effect begins immediately inside the outer bevel.
Style An integer constant or constant expression that specifies fine control of the bevel, overriding the signs of the outer and inner parameters (PROP:BevelStyle).
Drag ID To specify the type of Drag operations this control will generate, type up to 16 signatures, separated by commas. The DRAGID attribute specifies the REGION control can serve as a drag-and-drop host. DRAGID works in conjunction with the DROPID attribute.
Drop ID To specify the type of Drag operations this control will accept, type up to 16 signatures, separated by commas. The Window Designer adds the DROPID attribute to the control, which indicates the control is a valid target for the drag and drop operations identified by the signatures.

General

Layout Indicates the orientation of the control. Left to Right maintains the original layout specified in the Window Designer. Right to Left essentially “flips” the controls' display as a mirror image of the layout specified in the Window Designer. Default field navigation moves from right to left. The setting in the Application Frame will cascade its setting to all child windows and controls that have the default setting active.
Use This defines the USE attribute for the control. Type a field equate label to reference the control in executable code.

Help

Cursor The CURSOR attribute lets you specify an alternate shape for the cursor when the user passes the cursor over the control. The drop-down list provides standard cursor choices such as I-Beam and Crosshair. To select an external cursor file (whose extension must be .CUR), choose Select File from the drop-down list, then pick the file using the standard file dialog.

Mode

Disable Disables or 'grays-out' the control when your program initially displays it. The Window Designer places the DISABLE attribute on the control. Use the ENABLE statement to allow the user access to the control.
Hide Makes the control invisible at the time Windows would initially display it. Windows actually creates the control–it just doesn't display it on screen. The Window Designer places the HIDE attribute on the control. Use the UNHIDE statement to display the control.
Scroll Specifies whether the control should move with the window when the user scrolls the window. By default (False) the control does not move with the window. Set the Scroll property to False to create a control that stays fixed when the user scrolls the window. The Window Designer places the SCROLL attribute on the control when checked.

Options:

Immediate To generate a message event each time the mouse moves over the region, check the Immediate box. This adds the IMM attribute to the control. You are responsible for the code that executes upon notification of the event.

Position

Lets you set the location and size of the control.

The Position tab lets you specify the AT attribute. Filling in the attribute manually is optional–you may set the position and size visually by dragging with the mouse in the Window Designer.

To set the location of the control's Top Left Corner, set an X (horizontal) and Y (vertical) coordinate in Dialog units. The coordinate is relative to the top left corner of the structure containing it, that is, the window or the report band.

To set the control's size, choose from the following options for Width and Height.

Default The Clarion runtime library determines the size of the control based on the applicable font and picture token.
Full The control is the full height or width of the window or report.
Value Lets you set a precise width or height in Dialog units on a window, or in thousandths of inch, points, or millimeters on a report.

Quick Links

Embeds Accesses the Embedded Source dialog for points surrounding the event handling for this control only.
region_control_properties.htm.txt · Last modified: 2021/04/15 15:57 (external edit)