Pliki tekstowe wiadomości

Komunikaty są definiowane w pliku tekstowym wiadomości. Kompilator komunikatów przypisuje liczby do każdego komunikatu i generuje plik dołączania C/C++, którego aplikacja może używać do uzyskiwania dostępu do komunikatu przy użyciu stałej symbolicznej.

Ogólna składnia instrukcji w pliku tekstowym wiadomości jest następująca:

= wartości słowa kluczowego

Spacje wokół znaku równości są ignorowane, a wartość jest rozdzielana odstępem (w tym podziałami wierszy) z następnej pary słowa kluczowego/wartości. Wielkość liter jest ignorowana podczas porównywania nazw słów kluczowych. Wartość części może być stałą liczbową całkowitą przy użyciu składni języka C/C++, nazwy symbolu zgodnej z regułami identyfikatorów języka C/C++ lub nazwy pliku z 8 znakami lub mniejszą liczbą znaków, bez krosek.

Aby uzyskać przykładowy plik komunikatu, zobacz przykładowy plik tekstowy wiadomości.

Komentarze

Wiersze komentarza są dozwolone w pliku tekstowym wiadomości. Średnik (;) rozpoczyna komentarz kończący się na końcu wiersza. Wykonaj średnik ze wskaźnikiem komentarza jednowierszowego języka C/C++ (//), aby plik nagłówkowy wygenerowany przez kompilator komunikatów skompilował w aplikacji.

;// This is a single-line comment.

W przypadku komentarza bloku rozpocznij każdy wiersz średnikiem, a następnie umieść wskaźnik komentarza otwartego bloku C/C++ (/*) po średniku w pierwszym wierszu i wskaźnik komentarza zamknięcia bloku (*/) po średniku w ostatnim wierszu.

;/* This is a block comment.
;   It spans multiple lines.
;*/

Sekcja nagłówka

Plik tekstowy wiadomości zawiera nagłówek, który definiuje nazwy i identyfikatory języka do użycia przez definicje komunikatów w treści pliku. Nagłówek zawiera zero lub więcej z poniższych instrukcji.

Definicje komunikatów

Plik tekstowy wiadomości zawiera zero lub więcej definicji komunikatów zgodnie z sekcją nagłówka. W poniższej tabeli opisano instrukcje definicji komunikatów. Instrukcja MessageId oznacza początek definicji komunikatu. Instrukcje Ważność i Funkcja są opcjonalne.

Jeśli definicja wiadomości zawiera tekst komunikatu dla więcej niż jednego języka, każdy język wymaga własnej instrukcji Language, tekstu wiadomości i zakończenia nowego wiersza z kropką. Na przykład:

MessageId=0x1
Severity=Error
Facility=Runtime
SymbolicName=MSG_BAD_COMMAND
Language=English
You have chosen an incorrect command.
.

Language=Japanese
<Japanese message string goes here>
.

Możesz określić następujące sekwencje ucieczki do formatowania tekstu wiadomości do użycia przez podgląd zdarzeń lub aplikację. Znak procentu (%) rozpoczyna wszystkie sekwencje ucieczki. Każdy inny znak po znaku procentu jest wyświetlany bez znaku procentu.

% n[!format_specifier!]

Opisuje wstawkę. Każde wstawianie jest wpisem w tablicy Argumenty w funkcji FormatMessage. Wartość n może być liczbą z zakresu od 1 do 99. Specyfikator formatu jest opcjonalny. Jeśli nie określono żadnej wartości, wartość domyślna to !s!. Aby uzyskać informacje o specyfikatorze formatu, zobacz wsprintf.

Specyfikator formatu może używać * dla precyzji lub szerokości. Po określeniu używają one wstawień numerowanych n+1 i n+2.

%0

Kończy wiersz tekstowy wiadomości bez końcowego znaku nowego wiersza. Może to służyć do kompilowania długiego wiersza lub kończenia komunikatu monitu bez końcowego znaku nowego wiersza.

%.

Generuje jeden okres. Może to służyć do wyświetlania kropki na początku wiersza, który w przeciwnym razie zakończy tekst wiadomości.

%!

Generuje pojedynczy wykrzyknik. Służy do określania wykrzyknika bezpośrednio po wstawieniu.

%%

Generuje znak jednego procentu.

%n

Generuje twardy podział wiersza, gdy występuje na końcu wiersza. Może to być używane z FormatMessage, aby upewnić się, że komunikat pasuje do określonej szerokości.

%b

Generuje znak spacji. Może to służyć do zapewnienia odpowiedniej liczby spacji końcowych w wierszu.

%r

Generuje powrót twardego karetki bez końcowego znaku nowego wiersza.