This chapter describes the message macros and explains how to use the macros with your VxD. Message macros let you create text strings for display by your VxD that can easily be translated without requiring recompilation of the VxD. Message macros make the job of localizing your VxD for foreign-language markets easier.
You declare messages by using the message declaration macros. These macros specify the data segment in which the messages are to be defined as well as define the actual message text and the message identifiers used to uniquely identify messages.
You typically place message declaration macros in one or more include files, called message declaration files. To access the messages from your VxD source files, you include the message declaration files directly into your VxD sources. Including the files does not cause the assembler to generate code for the message text. Instead, the assembler assigns unique integer values to the message identifiers. You can then use the message identifiers, in conjunction with the message usage macros, to identify the specific message to process or display.
For each language you intend to support, you must create a unique message declaration file or set of files. The order of the message declarations and names of the message identifiers must be exactly the same from language to language. The VxD relies on the declaration order to locate the appropriate messages.
Share with your friends: |