| **Navigation:**  [[introduction.htm|Language Reference]] > 8 - Controls > Control Declarations >====== STRING (declare a string control) ====== | [[spin  declare a spinning list control .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[tab  declare a page of a sheet control .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**STRING(**//text//**)** ,**AT( )** [,**USE( )**] [,**LAYOUT( )]** [,**DISABLE**] [,**FONT( )**] [,**FULL**] [,**SCROLL**] [,**HIDE**]

|  | [,**TRN**] [,**DROPID( )**] [,**COLOR( )**] [,**ANGLE( )**] [,**SKIP**] |||
|  | [,| **LEFT**| ] | [,| **PAGENO                                               **| ] | [,**EXTEND( )**] |
|  | | **RIGHT**| | | **CNT( )**[,** RESET( ) **/** PAGE **] [, **TALLY( )** ]| |  |
|  | | **CENTER**| | | **SUM( )**[,** RESET( ) **/** PAGE **] [, **TALLY( )** ]| |  |
|  | | **DECIMAL**| | | **AVE( )**[,** RESET( ) **/** PAGE **] [, **TALLY( )** ]| |  |
|  |  | | **MIN( )**[,** RESET( ) **/** PAGE **] [, **TALLY( )** ]| |  |
|  |  | | **MAX( )**[,** RESET( ) **/** PAGE **] [, **TALLY( )** ]| |  |

{{blk2blue.jpg|blk2blue.jpg}}

| **STRING** | Places the //text// on the WINDOW, TOOLBAR, or REPORT. |
| //text// | A string constant containing the text to display, or a display picture token to format the variable specified in the USE attribute (PROP:Text). |
| **AT** | Specifies the initial size and location of the control (PROP:AT). If omitted, default values are selected by the runtime library. |
| **USE** | A field equate label to reference the control in executable code, or a variable whose contents are displayed in the format of the picture token declared instead of string text (PROP:USE). |
| **LAYOUT** | Specifies the control's left-to-right or right-to-left display orientation (PROP:LAYOUT) |
| **DISABLE** | Specifies the control appears dimmed when the WINDOW or APPLICATION opens (PROP:DISABLE). |
| **FONT** | Specifies the font used to display the text (PROP:FONT). |
| **FULL** | Specifies the control expands to occupy the entire size of the WINDOW or REPORT band for any missing AT attribute width or height parameter (PROP:FULL). |
| **SCROLL** | Specifies the control scrolls with the window (PROP:SCROLL). Not valid in a REPORT. |
| **HIDE** | Specifies the control does not appear when the WINDOW or APPLICATION is first opened (PROP:HIDE). UNHIDE must be used to display it. |
| **TRN** | Specifies the text or USE variable characters transparently display over the background (PROP:TRN). |
| **DROPID** | Specifies the control may serve as a drop target for drag-and-drop actions (PROP:DROPID). Not valid in a REPORT. |
| **SKIP** | Specifies not to print the control if the content is blank, and to move all following controls in the band upward to "fill in" the blank (PROP:SKIP). Valid only in a REPORT. |
| **LEFT** | Specifies that the text is left justified within the area specified by the AT attribute (PROP:LEFT). |
| **RIGHT** | Specifies that the text is right justified within the area specified by the AT attribute (PROP:RIGHT). |
| **CENTER** | Specifies that the text is centered within the area specified by the AT attribute (PROP:CENTER). |
| **DECIMAL** | Specifies that the text is aligned on the decimal point within the area specified by the AT attribute (PROP:DECIMAL). |
| **COLOR** | Specifies a background color for the control (PROP:COLOR). |
| **ANGLE** | Specifies displaying or prinitng the control at a specified angle measured counter-clockwise from the horizontal or the report's orientation (PROP:ANGLE). |
| **PAGENO** | Specifies the current page number is printed in the format of the picture token declared instead of string text (PROP:PAGENO). Valid only in a REPORT. |
| **CNT** | Specifies the number of details printed is printed in the format of the picture token declared instead of string text (PROP:CNT). Valid only in a REPORT. |
| **SUM** | Specifies the sum of the USE variable is printed in the format of the picture token declared instead of string text (PROP:SUM). Valid only in a REPORT. |
| **AVE** | Specifies the average value of the USE variable is printed in the format of the picture token declared instead of string text (PROP:AVE). Valid only in a REPORT. |
| **MIN** | Specifies the mimimum value of the USE variable is printed in the format of the picture token declared instead of string text (PROP:MIN). Valid only in a REPORT. |
| **MAX** | Specifies the maximum value of the USE variable is printed in the format of the picture token declared instead of string text (PROP:MAX). Valid only in a REPORT. |
| **RESET** | Specifies the CNT, SUM, AVE, MIN, or MAX is reset when the specified group break occurs (PROP:RESET). Valid only in a REPORT. |
| **PAGE** | Specifies the CNT, SUM, AVE, MIN, or MAX is reset to zero when the page break occurs (PROP:PAGE). Valid only in a REPORT. |
| **TALLY** | Specifies when to calculate the CNT, SUM, AVE, MIN, or MAX (PROP:TALLY). Valid only in a REPORT. |
| **EXTEND** | Specifies special document formatting information. This information contains a valid string of attributes that are assigned to a designated REPORT control for a given document type. Valid only in a REPORT. |

The **STRING** control places the //text// on the WINDOW, TOOLBAR, or REPORT at the position and size specified by its AT attribute. It is valid in Clarion Win32 WINDOWs, and also for REPORT structures in both Clarion Win32 and Clarion#.

If the //text// parameter is a picture token instead of a string constant, the contents of the variable named in the USE attribute are formatted to that display picture, at the position and size specified by the AT attribute. This makes the STRING with a USE variable a "display-only" control for the variable. The data displayed in the STRING is automatically refreshed every time through the ACCEPT loop, whether the AUTO attribute is present or not.

There is a difference between ampersand (&) use in STRING and PROMPT controls. An ampersand in a STRING displays as part of the //text//, while an ampersand in a PROMPT defines the prompt's "hot" letter.

A STRING with the TRN attribute displays or prints characters transparently, without obliterating the background. This means only the pixels required to create each character are written to screen. This allows the STRING to be placed directly on top of an IMAGE without destroying the background picture.

This control cannot receive input focus.

**Events Generated:**

| EVENT:Drop | A successful drag-and-drop to the control. |

**Example:**

**MDIChild WINDOW('Child One'),AT(0,0,320,200),MDI,MAX,HVSCROLL**

**          STRING('String Constant'),AT(10,0,20,20),USE(?S1)**

**          STRING(@S30),AT(10,20,20,20),USE(StringVar1)**

**          STRING(@S30),AT(10,20,20,20),USE(StringVar2),CURSOR(CURSOR:Wait)**

**          STRING(@S30),AT(10,20,20,20),USE(StringVar3),FONT('Arial',12)**

**         END**

**CustRpt REPORT,AT(1000,1000,6500,9000),THOUS**

**Break1   BREAK(Pre:Key1)**

**          HEADER,AT(0,0,6500,1000)**

**           STRING('Group Head'),AT(3000,500,1500,500),FONT('Arial',18)**

**          END**

**Detail    DETAIL,AT(0,0,6500,1000)**

**           STRING(@N$11.2),AT(6000,1500,500,500),USE(Pre:F1)**

**          END**

**          FOOTER,AT(0,0,6500,1000)**

**           STRING('Group Total:'),AT(5500,500,1500,500)**

**           STRING(@N$11.2),AT(6000,500,500,500),USE(Pre:F1),SUM,RESET(Pre:Key1)**

**          END**

**         END**

**        END**