2.4.1.10 Expression Box Control

Article
10/13/2020

The expression box control is a read-only control that displays the result of an XPath evaluation. The following table describes the symbols for an expression box control.

Symbol	Description
SIMPLE_EXPRESSION_BOX	An expression box is a control that displays the value of an XPath expression. It is constantly disabled.
EXPRESSIONBOX_WITH_CONDITIONAL_FORMATTING	Similar to SIMPLE_EXPRESSION_BOX, with text formatting and conditional formatting.
EXPRESSIONBOX_WITH_DATA_FORMATTING	Similar to SIMPLE_EXPRESSION_BOX, with the result formatted as a type of data.
EXPRESSIONBOX_WITH_DATA_FORMATTING_AND_CONDITIONAL_FORMATTING	Similar to EXPRESSIONBOX_WITH_CONDITIONAL_FORMATTING and EXPRESSIONBOX_WITH_DATA_FORMATTING.

SIMPLE_EXPRESSION_BOX:

 <span class="xdExpressionBox xdDataBindingUI (xdBehavior_Formatting)?" title="ANY_STRING" (tabIndex="-1")? xd:xctname="ExpressionBox" xd:CtrlId="CONTROL_ID" xd:disableEditing="yes" (xd:binding="EXPRESSION_BOX_XPATH1")? style="EXPRESSION_BOX_STYLE">
     CHECK_FOR_GETDOM_BEGIN1
     <xsl:value-of select="EXPRESSION_BOX_XPATH1" />
     CHECK_FOR_GETDOM_END1
 </span>

EXPRESSIONBOX_WITH_CONDITIONAL_FORMATTING:

 <span class="xdExpressionBox xdDataBindingUI" title="ANY_STRING" (tabIndex="-1")? xd:xctname="ExpressionBox" xd:CtrlId="CONTROL_ID" xd:disableEditing="yes" (xd:binding="EXPRESSION_BOX_XPATH1")?>
     CHECK_FOR_GETDOM_BEGIN1
     <xsl:attribute name="style">EXPRESSION_BOX_STYLE
        <xsl:choose>
              (<xsl:when test="BOOLEAN_XPATH_EXPRESSIONX">LEAF_CONTROL_CONDITIONAL_FORMATTING_CAPTION</xsl:when>)+
         </xsl:choose>
     </xsl:attribute>
     <xsl:value-of select="EXPRESSION_BOX_XPATH1" />
     CHECK_FOR_GETDOM_END1
 </span>

EXPRESSION_BOX_WITH_DATA_FORMATTING:

 <span class="xdExpressionBox xdDataBindingUI( xdBehavior_Formatting)?" title="ANY_STRING" (tabIndex="-1")? xd:xctname="ExpressionBox" xd:CtrlId="CONTROL_ID" xd:disableEditing="yes" (xd:binding="EXPRESSION_BOX_XPATH1")? xd:datafmt="DATA_FMT_CTRL_EXPBOX1" DATA_FMT2_ATTRIBUTE_EXPRESSION_BOX1 (xd:num="")? style="EXPRESSION_BOX_STYLE">
     CHECK_FOR_GETDOM_BEGIN1
     (<xsl:attribute name="xd:num">
         <xsl:value-of select="EXPRESSION_BOX_XPATH1" />
     </xsl:attribute>)?
     <xsl:choose>
         DATA_FMT2_FUNCTION_EXPRESSION_BOX1
         <xsl:when test="function-available(‘xdFormatting:formatString’)">
             <xsl:value-of select="xdFormatting:formatString(EXPRESSION_BOX_XPATH1, DATA_FMT_CTRL_EXPBOX1)" />
         </xsl:when>
         <xsl:otherwise>
             <xsl:value-of select="EXPRESSION_BOX_XPATH1" />
         </xsl:otherwise>
     </xsl:choose>
     CHECK_FOR_GETDOM_END1
 </span>

EXPRESSION_BOX_WITH_DATA_FORMATTING_AND_CONDITIONAL_FORMATTING:

 <span class="xdExpressionBox xdDataBindingUI( xdBehavior_Formatting)?" title="ANY_STRING" (tabIndex="-1")? xd:xctname="ExpressionBox" xd:CtrlId="CONTROL_ID" xd:disableEditing="yes" (xd:binding="EXPRESSION_BOX_XPATH1")? xd:datafmt="DATA_FMT_CTRL_EXPBOX1" DATA_FMT2_ATTRIBUTE_EXPRESSION_BOX1 (xd:num="")?>
     CHECK_FOR_GETDOM_BEGIN1
     <xsl:attribute name="style">EXPRESSION_BOX_STYLE
        <xsl:choose>
              (<xsl:when test="BOOLEAN_XPATH_EXPRESSIONx">LEAF_CONTROL_CONDITIONAL_FORMATTING_CAPTION</xsl:when>)+
         </xsl:choose>
     </xsl:attribute>
     (<xsl:attribute name="xd:num">
         <xsl:value-of select="EXPRESSION_BOX_XPATH1" />
     </xsl:attribute>)?
     <xsl:choose>
         DATA_FMT2_FUNCTION_EXPRESSION_BOX1
         <xsl:when test="function-available(‘xdFormatting:formatString’)">
             <xsl:value-of select="xdFormatting:formatString(EXPRESSION_BOX_XPATH1, DATA_FMT_CTRL_EXPBOX1)" />
         </xsl:when>
         <xsl:otherwise>
             <xsl:value-of select="EXPRESSION_BOX_XPATH1" />
         </xsl:otherwise>
     </xsl:choose>
     CHECK_FOR_GETDOM_END1
 </span>

EXPRESSION_BOX_XPATH: LEAF_XPATH or STRING_XPATH_EXPRESSION.

EXPRESSION_BOX_OVERFLOW_Y: OVERFLOW-Y: auto.

EXPRESSION_BOX_OVERFLOW_X: OVERFLOW-X: auto or OVERFLOW-X: visible.

EXPRESSION_BOX_STYLE: Semicolon-delimited list of (STYLE_WIDTH?, STYLE_BACKGROUND_COLOR?, STYLE_BORDER?, STYLE_PADDING?, STYLE_VERTICAL_ALIGN?, EXPRESSION_BOX_OVERFLOW_Y?, EXPRESSION_BOX_OVERFLOW_X?, STYLE_FONT?, STYLE_MARGIN?, STYLE_HEIGHT?, STYLE_TEXT_DECORATION?, STYLE_WRAP?, STYLE_COLOR?, STYLE_DIRECTION?, STYLE_TEXT_ALIGN?)

DATA_FMT2_ATTRIBUTE_EXPRESSION_BOX:

 (xd:datafmt2="DATA_FMT21")?

DATA_FMT2_FUNCTION_EXPRESSION_BOX:

 (<xsl:when test="function-available('xdFormatting:formatString2')">
     <xsl:value-of select="xdFormatting:formatString2(LEAF_XPATH1, DATA_FMT_CTRL_EXPBOX1, 'DATA_FMT21')" />
 </xsl:when>)?

DATA_FMT2_ATTRIBUTE_EXPRESSION_BOX and DATA_FMT2_FUNCTION_EXPRESSION_BOX symbols appear in pairs in the EBNF rules. Subscripts are used to mark the pairs.

If the yield of DATA_FMT2_ATTRIBUTE_EXPRESSION_BOX in one production is empty, the yield of the pairing DATA_FMT2_FUNCTION_EXPRESSION_BOX MUST be empty.

If the yield of DATA_FMT2_FUNCTION_EXPRESSION_BOX in one production is empty, the yield of the pairing DATA_FMT2_ATTRIBUTE_EXPRESSION_BOX MUST be empty.

The following table lists control-specific attributes used by the expression box control.

Attribute	Section
xd:binding	2.4.2.6
xd:CtrlId	2.4.2.10
xd:datafmt	2.4.2.11
xd:datafmt2	2.4.2.37.4
xd:disableEditing	2.4.2.12
xd:num	2.4.2.26
xd:xctname	2.4.2.35

2.4.1.10 Expression Box Control

Additional resources