2.2.7.3.1 button Element

The button XML element contains information on a button control in the UI that SHOULD be displayed on the client computer.

 <xs:element name="button">
   <xs:complexType>
     <xs:sequence />
     <xs:attribute name="stringID"
       type="xs:integer"
       use="optional"
      />
     <xs:attribute name="resourceDll"
       type="xs:string"
       use="optional"
      />
     <xs:attribute name="buttonID"
       use="required"
     >
       <xs:simpleType>
         <xs:restriction
           base="xs:string"
         >
           <xs:pattern
             value="IDOK|IDCANCEL|\s*(\-|\+)?[0-9]+\s*"
            />
         </xs:restriction>
       </xs:simpleType>
     </xs:attribute>
   </xs:complexType>
 </xs:element>

Attributes

Name

Type

Description

stringID

xs:integer

This attribute MUST be present if the value of the buttonID attribute is neither "IDOK" nor "IDCANCEL". If present, the value of this attribute MUST be the key of a string resource in the resource file specified by the resourceDll attribute. If the resourceDll attribute is not specified, stringID MUST be the key of a string resource in the default resource file.

String resources that are present in the default resource file are specified in section 2.2.6.

resourceDll

xs:string

The value of this optional attribute, if present, is the driver-file name of a resource file on the client system, which contains the string resources used in this message. If no value is specified, the default resource file MUST be used.

buttonID

xs:string

The value of this attribute MUST be a string representation of an integer, or one of the following case-sensitive strings:

"IDOK" The button SHOULD correspond to OK button behavior in the dialog.

"IDCANCEL" The button SHOULD correspond to Cancel button behavior in the dialog.

If the attribute value is "IDOK" or "IDCANCEL", the stringID and resourceDll values MUST be ignored.