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 >====== #WHERE (define #CODE embed point availability) {{c6h0068.jpg|C6H0068.jpg}} ====== | [[ validate  validate prompt input .htm|{{btn_prev_n.gif|Previous page}}]][[tlrcontents.htm|{{btn_home_n.gif|Return to chapter overview}}]][[ windows  default window structures .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**#WHERE(** //embeds //**)**

{{blk2blue.jpg|blk2blue.jpg}}

| **#WHERE** | Limits the availability of a #CODE to only those specific embedded source code points where the generated code would be appropriate. |
| //embeds// | A comma-delimited list of #EMBED //identifiers// that specifies the embedded source code points that may use the #CODE to generate source code. |

The **#WHERE** statement limits the availability of a #CODE to only those #EMBED embedded source code points where the generated code would be appropriate. A single #CODE may contain multiple #WHERE statements to explicitly define all the valid #EMBED embedded source code points. All the #WHERE statements in a #CODE are evaluated to determine which embedded source code points have been specifically enabled.

The //embeds// list must contain individual #EMBED //identifiers// delimited by commas. It may also contain ranges of embed points in the form //FirstIdentifier..LastIdentifier//, also delimited by commas. The //embeds// list may contain both types in a "mix and match" manner to define all suitable embedded source code points.

**Example:**

**#CODE(ChangeProperty,'Change control property')**

** ****#WHERE****(%AfterWindowOpening..%CustomRoutines)  #!Appropriate everywhere after window open**

**  #PROMPT('Control to change',CONTROL),%MyField,REQ**

**  #PROMPT('Property to change',@S20),%MyProperty,REQ**

**  #PROMPT('New Value',@S20),%MyValue,REQ**

**%MyField{%MyProperty} = '%'MyValue**

**See Also:     **[[ embed  define embedded source point .htm|#EMBED]] ,#[[ code  define a code template .htm|#CODE]] ,#[[ restrict  define section use constraints .htm|#RESTRICT]]