Borland C++ для Windows (стр. 6 из 6)

2) Создайте и выполните приложение.

3) Создайте элемент меню прикладного окна, вызывающий однострочный или многострочный элемент редактирования.

9.3. Немного английского

to edit - редактировать

GetLine - to get a line - получить строку

GetLineLength - to get a line length - получить длину строки

10. Приложение. Классы библиотеки OWL.

10.1. Иерархия классов библиотеки OWL, используемых в пособии

10.2. Класс TApplication

Производный от класса TModule. Используется для порождения класса для объекта-приложения Windows.

Класс TApplication содержит 7 членов-данных и 35 членов-функций, из которых в данном пособии используются:

10.2.1. Член-данное:

TFrameWindow *MainWindow; - - public

Указатель на главное окно приложения.

10.2.2. Член-функции:

virtual void InitApplication(); - - protected

Выполняет любую инициализацию, необходимую только для первого экземпляра приложения. По умолчанию InitApplication ниего не выполняет.

virtual void InitInstance(); - - - protected

Выпоняется для каждого экземпляра приложения. InitInstance вызывает InitMainWindow, а затем создает и высвечивает на экране главное окно путем вызова соответственно TWindow::Create и TWindow::Show.

virtual int Run(); - - - public

Инициализирует экземпляр приложения, вызывая InitApplication для первого экземпляра и InitInstance для всех остальных. Если инициализация прошла успешно, Run вызывает MessageLoop и запускает приложение.

virtual void InitMainWindow(); - - protected

По умолчанию InitMainWindow создает обобщенный объект - главное окно с именем приложения в качестве заголовка. Для создания требуемого главного окна необходимо переопределить InitMainWindow, не забыв сделать ссылку в MainWindow на созданное главное окно (класса TFrameWindow).

TAplication( const far*name=0); - - public

Этот конструктор создает объект класса TApplication.

name - указатель на имя приложения.

Этот конструктор используется в теле функции OwlMain.

10.3. Класс TFrameWindow

Производный от TWindow. Управляет поведением главного окна посредством управления клавиатурой и обработкой команд меню.

Класс TFrameWindow содержит 4 член-данных и 25 член-функций, из которых в данном пособии используются:

10.3.1. Член-функции:

virtual BOOL AssignMenu(TResId menuId); - - public

Устанавливает Attr.Menu равным аргументу menuId и удаляет предыдущее меню окна

void SetupWindow(); - - - protected

Вызывает TWindow::SetupWindow() для создания окон в списке потомков. SetupWindow() выполняет начальную подготовку пользовательского окна, если оно существует, связывает меню рамки с ресурсом меню.

TFrameWindow(TWindow *parent, const char far *title=0, TWindow *clientWnd=0, BOOL shrinkToClient=FALSE, TModule *module=0); - - public

Создает объект-окно с окном предком, на которое указыывает parent. Устанавливает позиции и поля размеров структуры Attr равными стандартным значениям.

title - имя заголовка создаваемого окна.

10.4. Класс TWindow

Производный от классов TEventHandler и TStreamableBase. Обеспечивает специфическое поведение окон.

Класс TWindow содержит 12 член-данных и 175 член-функций, из котрых в данном пособии используются:

10.4.1. Член-данные:

TWindowAttr Attr; - - - public

Сохраняет структуру TWindowAttr, содержащую атрибуты создания окна.

TWindow *parent; - - - public

Указывает на интерфейсный объект, служащий окном-предком для данного интерфейсного объекта.

char far *title; - - - public

Указываетна заголовок окна.

10.4.2. Член-функции:

TWindow(TWindow *parent, const char far *title=0, TModule *module=0); public

Конструктор класса TWindow. Добавляет this к списку окон-потомков parent, если this не 0.

Также устанавливает заголовок окна title и инициализирует атрибуты создания окна.

virtual BOOL CanClose(); - - - public

Возвращает TRUE, если ассоциированный интерфейсный элемент может быть закрыт. Иначе возвращает FALSE.

inline TApplicacion*GetApplication(); - - public

Получает указатель на объект TApplication, связанный с this.

int MessageBox(const far*text, const char far* caption=0, UINT type=MB_OK); public

Создет и выводит окно сообщений, содержащее сообщение text, заголовок caption и пиктограммы или кнопки type.

Тип type может содержать комбинации констант MB_XXX: IDABORT, IDCANCEL, IDIGNORE, IDNO, IDOK, IDRETRY, IDYES.

virtual void Paint(TDC& dc, BOOL erase, TRect& rect); - public

Вызывается базовыми классами при реагировании(отклике) на сообщение WM_PAINT.

Paint вызывается с помощью EvPaint и автоматически запрашивается системой Windows для повторного вывода содержимого окна.

dc является контекстом отображения рисования, передаваемым функциям рисования тек ста и графического вывода.

Заданная ссылка на структуру TRect представляет собой ограничивающий прямоугольник области, требующей перерисовки.

erase показывает, нужно ли стирать фон.

10.5. Класс TDC

Является корневым классом для вспомогательных классов контекстов устройств GDI. Класс TDC содержит 8 член-данных и 149 член-функций, из которых в данном пособии используются:

10.5.1. Член-функции:

inline BOOL Ellipse(int x1, int y1, int x2, int y2); - - public

inline BOOL Ellipse(const TPoint& p1, const TPoint& p2);

Рисует и заполняет эллипс в данном контексте, используя выбранные объекты - перо и кисть. Центр эллипса - центр ограничивающего прямоугольника.

Возвращает TRUE, если вызов успешный, иначе - FALSE.

inline BOOL Rectangle(int x1, int y1, int x2, int y2); - - public

inline BOOL Rectangle(const TPoint& point, const TSize& size);

inline BOOL Rectangle(const TRect& rect);

Рисует и заполняет прямоугольник заданного размера в данном контексте с использованием текущего пера и кисти.

Возвращает TRUE при успешном завершении и FALSE в противном случае.

void SelectObject(const TPen& pen); - - public

Выбирает заданное перо в заданном контексте устройства. Выбранный ранее объект сохраняется в соответствующем элементе данных.

inline virtual TColor SetTextColor(TColor color); - - public

Устанавливает текущий цвет текста в данном контексте в заданное значение color. Цвет текста определяет цвет, используемый в TDC::TextOut.

inline virtual BOOL TextOut(int x, int y, const char far* string, int count=-1); public

inline virtual BOOL TextOut(const TPoint& point, const char far* string, int count=-1);

Рисует до count символов заданной, заканчивающейся нулем, строки string в данном контексте устройства. Если count=-1(по умолчнию), рисуется вся строка. Аргументы x,y задают логические координаты опорной точки, которая используется для выравнивания первого символа.

10.6. Класс TScrollBar

Объекты типа TScrollBar представляют самостоятельные вертикальные и горизонтальные линейки прокрутки. Большинство член-функций TScrollBar управляют позицией и диапазоном перемещения бегунка линейки прокрутки.

Класс TScrollBar содержит 2 член-данных и 18 член-функций, из которых в даном пособии используются:

10.6.1. Член-функции:

TScrollBar(TWindow* parent, int id, int x, int y, int w, int h, BOOL isHScrollBar, TModule* module=0); - - - public

Создает и инициализирует объект типа TScrollBar в заданном окне с идентификатором id, в позиции x,y и размерами w,h. Если isHScrollBar равен TRUE, то создается горизонтальная линейка прокрутки, иначе - вертикальная.

inline virtual int GetPosition(); - - public

Возвращает текущую позицию бегунка линейки прокрутки.

inline virtual void SetRange(int min, int max); - - public

Устанавливает линейку прокрутки в диапазоне от min до max.

10.7. Класс TEdit

Класс TEdit используется при создании объекта “панель редактирования”. TEdit является производным от класса TStatic, который в свою очередь порожден от класса TControl.

Существует две разновидности панели редактирования - однострочная и многострочная. Являясь интерфейсным элементом, панель редактирования позволяет ввести текст и редактировать его.

Член-функции класса TEdit обрабатывают текст панели редактирования.

Класс TEdit содержит 1 член-данное и 52 член-функции, из которых в данном пособии используются:

TEdit(TWindow *parent, int id, const char far *text, int x, int y, int w, int h, UINT textlen, BOOL multiline=FALSE, TModule *module=0); - - public

Конструирует панель редактирования в окне parent, задавая идентификатор панели id, местоположение x,y и размеры панели w,h, длину вводимого текста textlen. Аргумент multiline задает вид панели редактирования(однострочная или многострочная).

BOOL GetLine(char far* str, int strSize, int lineNumber); - public

Получает текстовую строку с номером lineNumber из панели редактирования и возвращает ее в строке str, заканчивающейся нулем.

strSize задает количество получаемых символов.

int GetLineLength(int lineNumber); - - public

Возвращает количество символов в строке, заданной номером lineNumber.

inline int GetNumLines(); - - - public

Возвращает количество строк, введенных в многострочную панель редактирования. Возвращает нуль, если текст отсутствует.