305

wndclass.hbrBackground = hBrush;

Главное отличие между битовыми образами и остальными ресурсами в их практической важности и может быть легко выражено так: битовые образы являются объектами GDI. Хороший стиль составления программ рекомендует, что битовые образы должны быть удалены из программы, если в них отпадает нужда, или если программа завершается. В программе RESOURC2 это происходит по завершении работы функции WinMain:

DeleteObject((HGDIOBJ) hBrush);

DeleteObject((HGDIOBJ) hBitmap);

Символьные строки

Наличие ресурса для символьных строк может вначале показаться странным. Тем более, что не было никаких проблем при использовании привычных символьных строк, определенных в качестве переменных непосредственно в теле исходного текста нашей программы.

Ресурсы-символьные строки предназначены главным образом для облегчения перевода вашей программы на другие языки. Как будет рассказано в следующих двух главах, меню и окна диалога также являются частью описания ресурсов. Если вместо непосредственного использования строк в исходном тексте вашей программы, вы используете ресурсы-символьные строки, то весь текст вашей программы, окажется в одном файле — файле описания ресурсов. Если текст в файле описания ресурсов переводится, то все, что вам нужно сделать для иноязычной версии вашей программы, это перекомпоновать программу и добавить переведенные ресурсы в файл с расширением .EXE. Этот способ намного безопасней, чем возня с исходными кодами вашей программы. (Конечно, можно определить все символьные строки в качестве макросов и хранить их в заголовочном файле. Такой способ также позволяет избежать изменения исходного кода программы при переводе на другие языки.)

Использование ресурсов-символьных строк

Ресурсы-символьные строки определяются в описании ресурсов с помощью ключевого слова STRINGTABLE:

STRINGTABLE

{

id1, "character string 1"

id2, "character string 2"

[определения остальных строк]

}

В описании ресурсов может содержаться только одна таблица строк. Максимальный размер каждой строки — 255 символов. В строке не может быть управляющих символов языка С, за исключением \t (табуляция). Однако, символьные строки могут содержать восьмеричные константы:

Эти управляющие символы распознаются функциями DrawText и MessageBox.

Вы можете использовать функцию LoadString для копирования строки из ресурса в буфер в сегменте данных вашей программы:

LoadString(hInstance, id, szBuffer, iMaxLength);

Параметр id соответствует идентификатору, который предшествует каждой строке в файле описания ресурсов; szBuffer — это указатель на символьный массив, в который заносится символьная строка; iMaxLength — это максимальное число передаваемых в szBuffer символов. Идентификаторы строк, которые предшествуют каждой строке, обычно являются идентификаторами макроопределений, которые задаются в заголовочном файле. Многие программисты, программирующие под Windows, для идентификаторов строк используют префикс IDS_. Иногда, при выводе на экран имени файла или другой информации, она должна быть помещена в строку. В этом случае вы помещаете в строку символы форматирования языка С и используете эту строку в качестве форматирующей в функциях sprintf или wsprintf.

Использование ресурсов-строк в функции MessageBox

Давайте рассмотрим пример программы, в которой для вывода на экран трех сообщений об ошибках в окне сообщений используются три символьные строки. В заголовочном файле, который мы назовем PROGRAM.H, для этих сообщений определяются три идентификатора:

306

Файл описания ресурсов выглядит следующим образом:

Файл с исходным кодом на С также включает этот заголовочный файл и определяет функцию для вывода на экран окна сообщений. (Предполагается, что szAppName — это глобальная переменная, в которой содержится имя программы, а hInst — это глобальная переменная, в которой содержится описатель экземпляра вашей программы.)

#include "program.h"

[другие строки программы]

OkMessage(HWND hwnd, int iErrorNumber, char *szFileName)

{

char szFormat[40]; char szBuffer[60];

LoadString(hInst, iErrorNumber, szFormat, 40);

sprintf(szBuffer, szFormat, szFileName);

return MessageBox(hwnd, szBuffer, szAppName, MB_OK | MB_ICONEXCLAMATION);

}

Для вывода на экран окна сообщений с сообщением "File not found." программа вызывает функцию:

OkMessage(hwnd, IDS_FILENOTFOUND, szFileName);

Ресурсы, определяемые пользователем

Ресурсы, определяемые пользователем (user-defined resourse) удобны для включения самых разнообразных данных в ваш файл с расширением .EXE и получения доступа в программе к этим данным. Данные могут содержаться в любом выбранном вами формате — текстовом или бинарном. При загрузке данных в оперативную память возвращаемым значением функций Windows, которые используются для доступа к определяемым пользователем ресурсам, является указатель на данные. С этими данными вы можете делать все, что угодно. Вы вероятно решите, что этот способ хранения и доступа к разнообразным данным удобнее, чем альтернативный, при котором данные хранятся в других файлах и доступ к ним осуществляется через функции файлового ввода.

Например, предположим, что у вас есть файл PROGHELP.TXT, в котором содержится текст "подсказок" для вашей программы. Такой файл не должен быть в чистом виде ASCII-файлом: в нем также могут содержаться бинарные данные, например, указатели, которые могли бы помочь при ссылках на различные части этого файла. Следующим образом опишите ссылку на этот файл в вашем файле описания ресурсов:

helptext TEXT proghelp.txt

Имена helptext (имя ресурса) и TEXT (тип ресурса) в этом выражении могут быть любыми. Слово TEXT написано прописными буквами просто, чтобы сделать его похожим на слова ICON, CURSOR и BITMAP. То, что мы здесь делаем, является созданием ресурса вашего собственного типа, который называется TEXT.

В процессе инициализации программы (например, при обработке сообщения WM_CREATE), можно получить описатель этого ресурса:

hResource = LoadResource(hInstance, FindResource(hInstance, "TEXT", "helptext"));

Переменная hResource определяется как имеющая тип HGLOBAL. Несмотря на свое имя, функция LoadResource фактически не загружает сразу ресурс в оперативную память. Используемые вместе, так как это было показано, функции LoadResource и FindResource по существу эквивалентны функциям LoadIcon и LoadCursor. Фактически,

функции LoadIcon и LoadCursor используют функции LoadResource и FindResource.

308

RegisterClassEx(&wndclass);

hInst = hInstance;

hwnd = CreateWindow(szAppName, szCaption, WS_OVERLAPPEDWINDOW | WS_CLIPCHILDREN, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT,

NULL, NULL, hInstance, NULL);

ShowWindow(hwnd, iCmdShow);

UpdateWindow(hwnd);

while(GetMessage(&msg, NULL, 0, 0))

{

TranslateMessage(&msg);

DispatchMessage(&msg);

}

return msg.wParam;

}

LRESULT CALLBACK WndProc(HWND hwnd, UINT iMsg, WPARAM wParam, LPARAM lParam)

switch(iMsg)

{

case WM_CREATE :

hdc = GetDC(hwnd); GetTextMetrics(hdc, &tm); cxChar = tm.tmAveCharWidth;

cyChar = tm.tmHeight + tm.tmExternalLeading; ReleaseDC(hwnd, hdc);

xScroll = GetSystemMetrics(SM_CXVSCROLL);

hScroll = CreateWindow("scrollbar", NULL, WS_CHILD | WS_VISIBLE | SBS_VERT, 0, 0, 0, 0,

hwnd,(HMENU) 1, hInst, NULL); LoadString(hInst, IDS_POEMRES, szPoemRes, sizeof(szPoemRes));

hResource = LoadResource(hInst,

FindResource(hInst, szPoemRes, "TEXT"));

pText =(char *) LockResource(hResource);

309

iNumLines = 0;

while(*pText != '\\' && *pText != '\0')

{

if(*pText == '\n') iNumLines ++;

pText = AnsiNext(pText);

}

*pText = '\0';

SetScrollRange(hScroll, SB_CTL, 0, iNumLines, FALSE);

SetScrollPos (hScroll, SB_CTL, 0, FALSE);

return 0;

case WM_SIZE :

MoveWindow(hScroll, LOWORD(lParam) - xScroll, 0,

xScroll, cyClient = HIWORD(lParam), TRUE);

SetFocus(hwnd); return 0;

case WM_SETFOCUS : SetFocus(hScroll); return 0;

case WM_VSCROLL : switch(wParam)

{

case SB_TOP : iPosition = 0; break;

case SB_BOTTOM :

iPosition = iNumLines; break;

case SB_LINEUP : iPosition -= 1; break;

case SB_LINEDOWN : iPosition += 1; break;

case SB_PAGEUP :

iPosition -= cyClient / cyChar; break;

case SB_PAGEDOWN :

iPosition += cyClient / cyChar; break;

case SB_THUMBPOSITION : iPosition = LOWORD(lParam); break;

}

iPosition = max(0, min(iPosition, iNumLines));

if(iPosition != GetScrollPos(hScroll, SB_CTL))

{

SetScrollPos(hScroll, SB_CTL, iPosition, TRUE);

InvalidateRect(hwnd, NULL, TRUE);

}

return 0;

case WM_PAINT :

hdc = BeginPaint(hwnd, &ps);

pText =(char *) LockResource(hResource);

GetClientRect(hwnd, &rect);

310

rect.left += cxChar;

rect.top += cyChar *(1 - iPosition);

DrawText(hdc, pText, -1, &rect, DT_EXTERNALLEADING);

EndPaint(hwnd, &ps); return 0;

case WM_DESTROY : FreeResource(hResource); PostQuitMessage(0); return 0;

}

return DefWindowProc(hwnd, iMsg, wParam, lParam);

}

POEPOEM.RC

/*----------------------------

POEPOEM.RC resource script

----------------------------*/

#include "poepoem.h"

STRINGTABLE

{

IDS_APPNAME, "poepoem"

IDS_CAPTION, """Annabel Lee"" by Edgar Allen Poe"

IDS_POEMRES, "AnnabelLee"

}

POEPOEM.ICO

POEPOEM.H

/*-----------------------

POEPOEM.H header file

-----------------------*/

#define IDS_APPNAME 0 #define IDS_CAPTION 1 #define IDS_POEMRES 2

POEPOEM.ASC

It was many and many a year ago, In a kingdom by the sea,

That a maiden there lived whom you may know

By the name of Annabel Lee;

And this maiden she lived with no other thought Than to love and be loved by me. I was a child and she was a child

In this kingdom by the sea,

But we loved with a love that was more than love -I and my Annabel Lee -- With a love that the winged seraphs of Heaven Coveted her and me.

And this was the reason that, long ago,

In this kingdom by the sea,

A wind blew out of a cloud, chilling

My beautiful Annabel Lee;

So that her highborn kinsmen came And bore her away from me, To shut her up in a sepulchre

In this kingdom by the sea.