2.3.9 ST_QID (Qualified Control ID)

Specifies a control identifier that is qualified by an XML namespace prefix. The prefix determines which namespace to which the control belongs.

If the namespace is equal to the Custom UI namespace, the qualified identifier references the application's built-in control set.

For example, consider the following XML fragment:

 <customUI xmlns="http://schemas.microsoft.com/office/2006/01/customui"
     xmlns:mso="http://schemas.microsoft.com/office/2006/01/customui">
   <ribbon>
     <tabs>
       <tab   idQ="mso:TabHome" visible="false" />
     </tabs>
   </ribbon>
 </customUI>

In this example the mso namespace prefix is set to the Custom UI namespace, so names qualified with mso refer to built-in controls. Thus, the use of the idQ attribute on the tab element is equivalent to using the idMso attribute, as follows:

 <tab idMso="TabHome" visible="false" />

If the prefix is set to any other value, qualified identifiers reference controls in a unique custom namespace. If multiple Custom UI documents refer to controls in the same namespace, they can share common containers.

For example, consider the following XML fragment:

 <customUI 
     xmlns="http://schemas.microsoft.com/office/2006/01/customui"
     xmlns:ex="http://www.example.com">
   <ribbon>
     <tabs>
      <tab   idQ="ex:OtherTab" label="Shared Tab">
         <group   id="MyGroup" label="My Group">
           …
         </group>
       </tab>
     </tabs>
   </ribbon>
 </customUI>

In this case, ex is an XML namespace prefix for the namespace http://www.example.com. This XML fragment refers to a tab in that namespace with an identifier of "OtherTab". If that tab cannot be found, it is created. A new group belonging to this file is added to the tab.

This simple type's contents are a restriction of the XML schema QName datatype.

This simple type also specifies the following restrictions:

§ This simple type's contents have a minimum length of 1 character.

§ This simple type's contents have a maximum length of 1024 characters.

Referenced By

box@idQ (section 2.2.1); box@insertAfterQ (section 2.2.1); box@insertBeforeQ (section 2.2.1); button@idQ (section 2.2.2); button@idQ (section 2.2.3); button@idQ (section 2.2.4); button@insertAfterQ (section 2.2.2); button@insertAfterQ (section 2.2.3); button@insertAfterQ (section 2.2.4); button@insertBeforeQ (section 2.2.2); button@insertBeforeQ (section 2.2.3); button@insertBeforeQ (section 2.2.4); buttonGroup@idQ (section 2.2.5); buttonGroup@insertAfterQ (section 2.2.5); buttonGroup@insertBeforeQ (section 2.2.5); checkBox@idQ (section 2.2.6); checkBox@insertAfterQ (section 2.2.6); checkBox@insertBeforeQ (section 2.2.6); comboBox@idQ (section 2.2.7); comboBox@insertAfterQ (section 2.2.7); comboBox@insertBeforeQ (section 2.2.7); control@idQ (section 2.2.12); control@idQ (section 2.2.13); control@idQ (section 2.2.11); control@insertAfterQ (section 2.2.12); control@insertAfterQ (section 2.2.13); control@insertAfterQ (section 2.2.11); control@insertBeforeQ (section 2.2.12); control@insertBeforeQ (section 2.2.13); control@insertBeforeQ (section 2.2.11); dropDown@idQ (section 2.2.17); dropDown@insertAfterQ (section 2.2.17); dropDown@insertBeforeQ (section 2.2.17); dynamicMenu@idQ (section 2.2.19); dynamicMenu@idQ (section 2.2.18); dynamicMenu@insertAfterQ (section 2.2.19); dynamicMenu@insertAfterQ (section 2.2.18); dynamicMenu@insertBeforeQ (section 2.2.19); dynamicMenu@insertBeforeQ (section 2.2.18); editBox@idQ (section 2.2.20); editBox@insertAfterQ (section 2.2.20); editBox@insertBeforeQ (section 2.2.20); gallery@idQ (section 2.2.21); gallery@idQ (section 2.2.22); gallery@insertAfterQ (section 2.2.21); gallery@insertAfterQ (section 2.2.22); gallery@insertBeforeQ (section 2.2.21); gallery@insertBeforeQ (section 2.2.22); group@idQ (section 2.2.23); group@insertAfterQ (section 2.2.23); group@insertBeforeQ (section 2.2.23); labelControl@idQ (section 2.2.25); labelControl@insertAfterQ (section 2.2.25); labelControl@insertBeforeQ (section 2.2.25); menu@idQ (section 2.2.28); menu@idQ (section 2.2.26); menu@idQ (section 2.2.27); menu@insertAfterQ (section 2.2.28); menu@insertAfterQ (section 2.2.26); menu@insertAfterQ (section 2.2.27); menu@insertBeforeQ (section 2.2.28); menu@insertBeforeQ (section 2.2.26); menu@insertBeforeQ (section 2.2.27); menuSeparator@idQ (section 2.2.30); menuSeparator@insertAfterQ (section 2.2.30); menuSeparator@insertBeforeQ (section 2.2.30); separator@idQ (section 2.2.34); separator@insertAfterQ (section 2.2.34); separator@insertBeforeQ (section 2.2.34); splitButton@idQ (section 2.2.38); splitButton@idQ (section 2.2.36); splitButton@idQ (section 2.2.37); splitButton@insertAfterQ (section 2.2.38); splitButton@insertAfterQ (section 2.2.36); splitButton@insertAfterQ (section 2.2.37); splitButton@insertBeforeQ (section 2.2.38); splitButton@insertBeforeQ (section 2.2.36); splitButton@insertBeforeQ (section 2.2.37); tab@idQ (section 2.2.39); tab@insertAfterQ (section 2.2.39); tab@insertBeforeQ (section 2.2.39); toggleButton@idQ (section 2.2.43); toggleButton@idQ (section 2.2.42); toggleButton@idQ (section 2.2.44); toggleButton@insertAfterQ (section 2.2.43); toggleButton@insertAfterQ (section 2.2.42); toggleButton@insertAfterQ (section 2.2.44); toggleButton@insertBeforeQ (section 2.2.43); toggleButton@insertBeforeQ (section 2.2.42); toggleButton@insertBeforeQ (section 2.2.44)

The following XML schema fragment defines the contents of this simple type:

 <xsd:simpleType name="ST_QID">
    <xsd:restriction base="xsd:QName">
    <xsd:minLength value="1"/>
    <xsd:maxLength value="1024"/>
    </xsd:restriction>
 </xsd:simpleType>