2.4.1.21.10 Picture Button Control

  • Article

The picture button control is an unbound control that displays an image and executes actions (submit, query, new, and refresh), rules, or custom code when clicked.

Symbol

Description

PICTURE_BUTTON_RULES_AND_CUSTOM_CODE_WITH_CONDITIONAL_FORMATTING

The picture button executes rules (1) and custom code when clicked, and supports conditional formatting.

PICTURE_BUTTON_UPDATE_FORM_WITH_CONDITIONAL_FORMATTING

The picture button updates the form content when clicked, and supports conditional formatting.

PICTURE_BUTTON_ACTION_WITH_CONDITIONAL_FORMATTING

The picture button executes actions (submit, query, new, and refresh) when clicked, and supports conditional formatting.

PICTURE_BUTTON_ACTION_TYPE: "submit" or "query" or "new" or "refresh".

PICTURE_BUTTON_HIDE_IN_PRINT_VIEW: "true" or "false".

PICTURE_BUTTON_IMAGE: The value MUST be an image resource file, as specified in section 2.1, contained in the form template, and MUST conform to the specifications of a value for the SRC attribute of an IMG element, as specified in [HTML] section 13.2.

PICTURE_BUTTON_PRIMARY_IMAGE:

 res://infopath.exe/picbuttonplaceholder.png | PICTURE_BUTTON_IMAGE

PICTURE_BUTTON_STYLE: Semicolon-delimited list of (STYLE_WIDTH, STYLE_HEIGHT, BORDER-RIGHT: medium none; BORDER-TOP: medium none; BORDER-LEFT: medium none; BORDER-BOTTOM: medium none, STYLE_BACKGROUND_COLOR?, STYLE_MARGIN?, STYLE_DIRECTION?)

PICTURE_BUTTON_IMAGE_STYLE: Semicolon-delimited list of (WIDTH: 100%, STYLE_HEIGHT, POSITION: (static|relative)).

The yield of STYLE_HEIGHT in the PICTURE_BUTTON_STYLE production MUST be the same as the yield of STYLE_HEIGHT in the PICTURE_BUTTON_IMAGE_STYLE production.

PICTURE_BUTTON_ACTION_STYLE: Semicolon-delimited list of (BEHAVIOR: url(#default#ActionButton) url(#default#PictureButton), PICTURE_BUTTON_STYLE).

PICTURE_BUTTON_CONDITIONAL_FORMATTING_STYLE: Semicolon-delimited list of (STYLE_BACKGROUND_COLOR?, STYLE_CAPTION).

PICTURE_BUTTON_CONDITIONAL_FORMATTING:

 (<xsl:attribute name="style">PICTURE_BUTTON_STYLE<xsl:choose>
         (<xsl:when test="BOOLEAN_XPATH_EXPRESSION">STYLE_DISPLAY_NONE; STYLE_CAPTION</xsl:when>|
         <xsl:when test="BOOLEAN_XPATH_EXPRESSION">STYLE_CAPTION</xsl:when>|
         <xsl:when test="BOOLEAN_XPATH_EXPRESSION">PICTURE_BUTTON_CONDITIONAL_FORMATTING_STYLE</xsl:when>)+
     </xsl:choose>
 </xsl:attribute>)?
 (<xsl:choose>
     (<xsl:when test="BOOLEAN_XPATH_EXPRESSION"/>|
     <xsl:when test="BOOLEAN_XPATH_EXPRESSION">
         <xsl:attribute name="disabled">true</xsl:attribute>
     </xsl:when>)+
 </xsl:choose>)?

PICTURE_BUTTON_ACTION_CONDITIONAL_FORMATTING:

 (<xsl:attribute name="style">PICTURE_BUTTON_ACTION_STYLE<xsl:choose>
         (<xsl:when test="BOOLEAN_XPATH_EXPRESSION">STYLE_DISPLAY_NONE; STYLE_CAPTION</xsl:when>|
         <xsl:when test="BOOLEAN_XPATH_EXPRESSION">STYLE_CAPTION</xsl:when>|
         <xsl:when test="BOOLEAN_XPATH_EXPRESSION">PICTURE_BUTTON_CONDITIONAL_FORMATTING_STYLE</xsl:when>)+
     </xsl:choose>
 </xsl:attribute>)?
 (<xsl:choose>
     (<xsl:when test="BOOLEAN_XPATH_EXPRESSION"/>|
     <xsl:when test="BOOLEAN_XPATH_EXPRESSION">
         <xsl:attribute name="disabled">true</xsl:attribute>
     </xsl:when>)+
 </xsl:choose>)?

PICTURE_BUTTON_UPDATE_FORM_CONDITIONAL_FORMATTING:

 <xsl:attribute name="style">PICTURE_BUTTON_ACTION_STYLE<xsl:choose>
         <xsl:when test="not(xdEnvironment:IsBrowser())">STYLE_DISPLAY_NONE</xsl:when>
         (<xsl:when test="BOOLEAN_XPATH_EXPRESSION">STYLE_DISPLAY_NONE; STYLE_CAPTION</xsl:when>|
         <xsl:when test="BOOLEAN_XPATH_EXPRESSION">STYLE_CAPTION</xsl:when>|
         <xsl:when test="BOOLEAN_XPATH_EXPRESSION">PICTURE_BUTTON_CONDITIONAL_FORMATTING_STYLE</xsl:when>)*
     </xsl:choose>
 </xsl:attribute>
 (<xsl:choose>
     <xsl:when test="not(xdEnvironment:IsBrowser())"/>
     (<xsl:when test="BOOLEAN_XPATH_EXPRESSION"/>|
     <xsl:when test="BOOLEAN_XPATH_EXPRESSION">
         <xsl:attribute name="disabled">true</xsl:attribute>
     </xsl:when>)+
 </xsl:choose>)?

PICTURE_BUTTON_RULES_AND_CUSTOM_CODE_WITH_CONDITIONAL_FORMATTING:

 <button class="xdPictureButton" contentEditable="false" style="PICTURE_BUTTON_STYLE" xd:CtrlId="CONTROL_ID" xd:xctname="PictureButton" xd:HideInPrintView="PICTURE_BUTTON_HIDE_IN_PRINT_VIEW" (xd:auxDom="AUX_DOM_SOURCE_NAME")? (tabIndex="TAB_INDEX")? (xd:postbackModel="BUTTON_POSTBACKMODEL")? (accessKey="SINGLE_CHARACTER")?>
     PICTURE_BUTTON_CONDITIONAL_FORMATTING
     <img style="PICTURE_BUTTON_IMAGE_STYLE" title="ANY_STRING1" alt="ANY_STRING1" src="PICTURE_BUTTON_PRIMARY_IMAGE" xd:HoverSRC="PICTURE_BUTTON_IMAGE" (Linked="true")?/>
 </button>

PICTURE_BUTTON_UPDATE_FORM_WITH_CONDITIONAL_FORMATTING:

 <button class="xdPictureButton" contentEditable="false" style="PICTURE_BUTTON_ACTION_STYLE" xd:CtrlId="CONTROL_ID" xd:xctname="PictureButton" xd:HideInPrintView="PICTURE_BUTTON_HIDE_IN_PRINT_VIEW" xd:action="updateForm" (xd:auxDom="AUX_DOM_SOURCE_NAME")? (tabIndex="TAB_INDEX")? (xd:postbackModel="BUTTON_POSTBACKMODEL")? (accessKey="SINGLE_CHARACTER")?>
     PICTURE_BUTTON_UPDATE_FORM_CONDITIONAL_FORMATTING
     <img style="PICTURE_BUTTON_IMAGE_STYLE" title="ANY_STRING1" alt="ANY_STRING1" src="PICTURE_BUTTON_PRIMARY_IMAGE" xd:HoverSRC="PICTURE_BUTTON_IMAGE" (Linked="true")?/>
 </button>

PICTURE_BUTTON_ACTION_WITH_CONDITIONAL_FORMATTING:

 <button class="xdPictureButton" contentEditable="false" style="PICTURE_BUTTON_ACTION_STYLE" xd:CtrlId="CONTROL_ID" xd:xctname="PictureButton" xd:HideInPrintView="PICTURE_BUTTON_HIDE_IN_PRINT_VIEW" (xd:action="BUTTON_ACTION_TYPE")? (xd:auxDom="AUX_DOM_SOURCE_NAME")? (tabIndex="TAB_INDEX")? (xd:postbackModel="BUTTON_POSTBACKMODEL")? (accessKey="SINGLE_CHARACTER")?>
     PICTURE_BUTTON_ACTION_CONDITIONAL_FORMATTING 
     <img style="PICTURE_BUTTON_IMAGE_STYLE" title="ANY_STRING1" alt="ANY_STRING1" src="PICTURE_BUTTON_PRIMARY_IMAGE" xd:HoverSRC="PICTURE_BUTTON_IMAGE" (Linked="true")?/>
 </button>

The following table lists control-specific attributes used by the picture button control.

Attribute

Section

xd:action

2.4.2.1

xd:auxDom

2.4.2.4

xd:CtrlId

2.4.2.10

xd:HideInPrintView

2.4.2.37.5

xd:HoverSRC

2.4.2.37.6

xd:postbackModel

2.4.2.29

xd:xctname

2.4.2.35