3.1.2.1.1.7 fci (Fixed Command Keyboard Customization Action)

  • Article

The fci element specifies the command that will be executed for the keyboard shortcut specified in the enclosing keymap element. This element must reference either an identifying name or index by using the fciName or fciIndex attribute, respectively. If both attributes are specified, fciName takes precedence for determining the command to execute. When writing a document, fciName will be used if a name can be determined for the command. If a name cannot be determined, fciIndex will be used instead.

For a list of public fixed command names and corresponding indices available in Word, refer to Fixed Commands (§3.1.2.1.2, Fixed Commands).

[Example: Consider the following key mapping fragment:

    <wne:keymap wne:kcmPrimary="0342">
       <wne:fci wne:fciName="Bold" />
    </wne:keymap>

In this example, the WordprocessingML assigns the Bold fixed command to the keyboard shortcut mapping to KCM 0342 (Ctrl-Shift-B).

Alternately, the same effect can be achieved using the fciIndex instead of fciName:

   <wne:keymap wne:kcmPrimary="0342">
    <wne:fci wne:fciIndex="002D" />
 </wne:keymap>

end example]

Parent Elements

keymap (§3.1.2.1.1.8, keymap)

Attributes

Description

fciIndex (Index of fixed command)

Specifies numeric identifier for a fixed command.

For a list of public fixed command names and their indices available in Word, refer to Fixed Commands (§3.1.2.1.2, Fixed Commands).

The possible values for this attribute are defined by the ST_ShortHexNumber simple type (§3.1.2.3.4, ST_ShortHexNumber).

fciName (Fixed command name)

Specifies friendly identifier for a fixed command.

For a list of public fixed command names available in Word, refer to Fixed Commands (§3.1.2.1.2, Fixed Commands).

The possible values for this attribute are defined by the ST_String simple type (§3.1.2.3.5, ST_String).

swArg (Fixed command argument)

Specifies an optional numeric argument for a fixed command, as specified in the Word 97-2003 Binary File Format (.doc) Structure Specification ("[MS-DOC] section 2.9.36; CidFci") book.

The possible values for this attribute are defined by the ST_ShortHexNumber simple type (§3.1.2.3.4, ST_ShortHexNumber).

The following XML Schema fragment defines the contents of this element:

 <complexType name="CT_Fci">
   <attribute name="fciName" type="ST_String"/>
   <attribute name="fciIndex" type="ST_ShortHexNumber"/>
   <attribute name="swArg" type="ST_ShortHexNumber"/>
 </complexType>