STRINGTABLE Statement

The STRINGTABLE statement defines one or more string resources for an application. String resources are null-terminated ASCII strings that can be loaded, when needed, from the executable file, using the WinLoadString function.

Note: The ASCII strings can include no more than 256 characters, including the NULL termination character.

The STRINGTABLE statement has the form:

 ─STRINGTABLE─┬────────────┬┬───────────┬───
                └─loadoption─┘└─memoption─┘


 ────BEGIN───string-definitions───END───

String-definitions

      ┌─────────────────────────────────┐
      │                                 │
                                       │
  ─────integer─────string─────────────┴──

loadoption (LOADOPTION)

An optional keyword specifying when the resource is to be loaded. It must be one of:

PRELOAD

Resource is loaded immediately.
LOADONCALL
Resource is loaded when called.
The default is LOADONCALL.

See Resource Load and Memory Options for a description of LOADOPTION.

memoption (MEMOPTION)
Consists of the following keyword or keywords, specifying whether the resource is fixed or movable and whether it is discardable:

FIXED

Resource remains at a fixed memory location.
MOVEABLE
Resource can be moved if necessary to compact memory.
DISCARDABLE
Resource can be discarded if no longer needed.
The default is MOVEABLE and DISCARDABLE.

See Resource Load and Memory Options for a description of MEMOPTION.

string (PCH)
A string, enclosed in double quotation marks. To insert a double-quote character (") in the text, use two double-quote characters ("").

Note: A string may be defined on more than one line if each line begins and ends with a double-quote. If newline characters are desired after each line, there should be a double-quote at the beginning of the first line and at the end of the last line only. The string may contain any ASCII characters. Because (\) is interpreted as an escape character, use (\\) to generate a (\).

The following escape sequences may be used:

Escape

Sequence
Name
\t
Horizontal tab
\a
Bell (alert)
\nnn
ASCII character (octal)
\xdd
ASCII character (hexadecimal).
The sequences \ddd and \xdd allow any character in the ASCII character set to be inserted in the character string. Thus, the horizontal tab could be entered as \X09, \011 or \t.

Example

#define IDS_STRING1  1#define IDS_STRING2  2
#define IDS_STRING3  3

STRINGTABLE
BEGIN
  IDS_STRING1, "The first two strings in this table are identical."
  IDS_STRING2, "The first two strings "
               "in this table are identical."
  IDS_STRING3, "This string will contain a newline character
                before it continues on this line."
END

---

[Back: Template Format]
[Next: Templates, Control Data, and Presentation Parameters]