Reference. Reference for the DocBook DTD

[Prev] [Next]


KeyCap

Name

KeyCap---Text printed on a physical key on a computer keyboard, not necessarily the same thing as a KeyCode

Synopsis

Content Model
  (#PCDATA | Link | OLink | ULink | Action | Application
  | ClassName | Command | ComputerOutput | Database | Email
  | EnVar | ErrorCode | ErrorName | ErrorType | Filename
  | Function | GUIButton | GUIIcon | GUILabel | GUIMenu
  | GUIMenuItem | GUISubmenu | Hardware | Interface
  | InterfaceDefinition | KeyCap | KeyCode | KeyCombo
  | KeySym | Literal | Markup | MediaLabel | MenuChoice
  | MouseButton | MsgText | Option | Optional | Parameter
  | Prompt | Property | Replaceable | ReturnValue | SGMLTag
  | StructField | StructName | Symbol | SystemItem | Token
  | Type | UserInput | Anchor | Comment | Subscript
  | Superscript
  | InlineGraphic)+

Attributes

This element has common and Role attributes.

Name Value(s) Type Default Value
MoreInfo (RefEntry|None)   None

Tag Minimization

Both the start- and end-tags are required for this element.

Description

Text printed on a physical key on a computer keyboard, not necessarily the same thing as a KeyCode. It may contain members of cptr.char.mix, and has common and MoreInfo attributes.

Parents

These elements contain KeyCap: Action, Application, Attribution, BiblioMisc, BridgeHead, Citation, CiteTitle, Command, Comment, ComputerOutput, Database, Emphasis, Filename, ForeignPhrase, FuncParams, FuncSynopsisInfo, Function, GlossSee, GlossSeeAlso, GlossTerm, Hardware, Interface, InterfaceDefinition, KeyCap, KeyCombo, LineAnnotation, Link, Literal, LiteralLayout, LoTentry, Member, MsgAud, OLink, Option, Optional, Para, Parameter, Phrase, Primary, PrimaryIE, ProductName, ProgramListing, Property, Quote, RefDescriptor, RefEntryTitle, RefName, RefPurpose, Screen, ScreenInfo, Secondary, SecondaryIE, See, SeeAlso, SeeAlsoIE, SeeIE, Seg, SegTitle, Shortcut, SimPara, Subtitle, Synopsis, SystemItem, Term, Tertiary, TertiaryIE, Title, TitleAbbrev, ToCback, ToCentry, ToCfront, Trademark, ULink, UserInput, and entry.

Children

KeyCap contains these elements: Action, Anchor, Application, ClassName, Command, Comment, ComputerOutput, Database, Email, EnVar, ErrorCode, ErrorName, ErrorType, Filename, Function, GUIButton, GUIIcon, GUILabel, GUIMenu, GUIMenuItem, GUISubmenu, Hardware, InlineGraphic, Interface, InterfaceDefinition, KeyCap, KeyCode, KeyCombo, KeySym, Link, Literal, Markup, MediaLabel, MenuChoice, MouseButton, MsgText, OLink, Option, Optional, #PCDATA, Parameter, Prompt, Property, Replaceable, ReturnValue, SGMLTag, StructField, StructName, Subscript, Superscript, Symbol, SystemItem, Token, Type, ULink, and UserInput.

In some contexts, some of these elements may be invalid due to exclusions in parent elements.

Attributes

MoreInfo

Indicates whether the element's content has an associated RefEntry.

Examples

<PARA>
Key terminology is tricky.  The KeyCap <KEYCAP>R</KEYCAP>
on your keyboard stands for both <TOKEN>R</TOKEN> and 
<TOKEN>r</TOKEN>.  A KeyCode is a computer's internal 
numeric representation of that point of input; the KeyCode 
for that <KEYCAP>R</KEYCAP> key could be <KEYCODE>36</KEYCODE> 
for all you know.  And a KeySym, or key symbol name, is not
necessarily the same thing as a Keycap.  For example, the Keysym for
the <KEYCAP>R</KEYCAP> key might be <KEYSYM>h</KEYSYM>.            
</PARA>


[Prev] keyaction.attrib
[Next] KeyCode
[Reference Home] [Davenport Group Home]