Clarion Community Help

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
| **Navigation:**  [[templates.htm|Templates]] > [[tlrcontents.htm|Template Language Reference]] > Complete Alpha Listing >====== #SUSPEND (begin conditional source) {{c6h0068.jpg|C6H0068.jpg}} ====== | [[ sheet  declare a group of  tab controls .htm|{{btn_prev_n.gif|Previous page}}]][[tlrcontents.htm|{{btn_home_n.gif|Return to chapter overview}}]][[ system  template registration and load .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**#SUSPEND**(<;//section//>)

{{blk2blue.jpg|blk2blue.jpg}}

| **#SUSPEND** | Identifiy the start of a conditionally generated source section |
| //section// | A name that identifies a specific #SUSPEND section |

The **#SUSPEND **statement marks the start of a section of source that is generated only if a non-conditional source line or a #RELEASE statement is encountered. (i.e., a line of code without "#?" or a #RELEASE must be encountered for the code between #SUSPEND and #RESUME to be generated). This allows empty unnecessary "boiler-plate" code to be easily removed from the generated source. The end of the section must be delimited by a matching #RESUME statement.

These #SUSPEND sections may be nested within each other to as many levels as necessary. A #RELEASE encountered in an inner nested section commits source generation for all the outer nested levels in which it is contained, also. The //section// parameter is used to distinguish between other nested #SUSPEND statements.

A #EMBED that contains source to generate performs an implied #RELEASE. Any generated source output also performs an implied #RELEASE. Therefore, an explicit #RELEASE statement is not always necessary. The #? statement defines an individual conditional source line that does not perform the implied #RELEASE.

**Example:**

**ACCEPT**

**#SUSPEND                       #!Begin suspended generation**

**  #?CASE SELECTED()**

**  #FOR(%ScreenField)**

**   ****#SUSPEND**

**  #?OF %ScreenField**

**    #EMBED(%ScreenSetups,'Control selected code'),%ScreenField**

**                               #!Implied #RELEASE from the #EMBED of both nested sections**

**    #RESUME**

**  END**

**#RESUME                        #!End suspended generation**

**#SUSPEND****                       #!Begin suspended generation**

**  #?CASE EVENT()**

** ****#SUSPEND**

**  #?OF EVENT:AlertKey**

**   ****#SUSPEND**

**    #?CASE KEYCODE()**

**      #FOR %HotKey**

**        #RELEASE               #!Explicit #RELEASE**

**    #?OF %HotKey**

**      #EMBED(%HotKeyProc,'Hot Key code'),%HotKey**

**      #ENDFOR**

**    #?END**

**    #RESUME**

**  #?END**

**#RESUME                        #!End suspended generation**

**END**

**See Also:     **[[ release  commit conditional source generation .htm|#RELEASE]] ,[[ resume  delimit conditional source .htm|#RESUME]] ,[[    conditional source line .htm|#?]] ,[[ query  conditionally generate source .htm|#QUERY]]