лекции / Shchupak_Yu._Win32_API_Razrabotka_prilozheniy_dlya_Windows

После окончания проектирования шаблона диалога порядок обхода элемен тов управления не всегда получается удобным для пользователя. Среда Visual Studio позволяет легко изменить эту последовательность.

Работая с редактором диалоговых окон, вызовите подменю Layout, а в нем вы берите команду Tab order. Выполняя эту команду, редактор диалоговых окон раз мещает номера на элементах управления, показывая порядок обхода, первоначаль но соответствующий порядку добавления элементов управления.

Для изменения порядка обхода последовательно щелкните на каждом эле менте управления в задаваемом вами порядке. Например, вид шаблона диалога IDD_SHAPE_PARAM из приложения DlgDemo3 после выполнения указанной проце дуры показан на рис. 7.22.

Перейдем теперь к рассмотрению элементов управления Edit box и List box.

Окно редактирования

Окно редактирования (Edit box), которое также часто называют текстовым полем ввода, представляет собой прямоугольное окно, в котором пользователь может вводить текст с клавиатуры. Элемент управления Edit box реализован на базе пре допределенного оконного класса EDIT.

На практике используются различные окна редактирования в самом широком спектре: от небольшого однострочного поля ввода до многострочного элемента управления с автоматическим переносом строк, как в программе Microsoft Notepad.

Когда окно редактирования имеет фокус ввода, пользователь может наби рать текст, перемещать курсор, удалять символы, выбирать группы символов, используя либо мышь, либо клавишу Shift и клавиши стрелки, удалять или ко пировать выбранный текст в буфер обмена Windows, вставлять текст из буфера обмена.

Элемент управления Edit box размещается на форме диалога так же, как и дру гие элементы управления. Затем нужно вызвать окно свойств Edit Properties и на вкладке General в поле ID указать идентификатор элемента управления. На вклад ке Styles, показанной на рис. 7.23, можно задать дополнительные свойства окна редактирования.

Рис. 7.23. Вкладка Styles в окне свойств окна редактирования

По умолчанию окно редактирования является однострочным, с автоматичес кой горизонтальной прокруткой (свойство Auto HScroll), с объемной рамкой (свой ство Border) и выравниванием текста по левой границе окна (Left). Открыв комби нированный список Align text, можно выбрать другой режим выравнивания текста (Centered или Right).

Если установить флажок Multiline, то окно редактирования будет работать

вмногострочном режиме. При этом станут доступными для использования оп ции Horizontal scroll, Vertical scroll, Auto VScroll.

Установленный флажок Number разрешает вводить в окно редактирования толь ко цифры. Если же создаваемое окно редактирования предназначено для ввода пароля, то надо установить флажок Password, и тогда вместо вводимых символов

вполе будут отображаться символы звездочки.

Флажок No hide selection заставляет элемент управления всегда показывать выделенную подстроку, даже если окно редактирования теряет фокус. Флажок OEM convert задает режим работы, при котором вводимый текст преобразуется из набора символов Windows в набор символов OEM, а затем — обратно. Это обеспечивает пра вильное преобразование символов при использовании функции CharToOem.

Флажок Want return используется для многострочного окна редактирования. Если он установлен, то нажатие клавиши Enter приводит к вводу символа возвра та каретки. Если флажок сброшен, то нажатие клавиши Enter воспринимается как щелчок на кнопке, которая отмечена в диалоговом окне в качестве выбранной по умолчанию. В этом случае для ввода символа возврата каретки применяется ком бинация клавиш Ctrl+Enter.

Взаимоисключающие флажки Uppercase и Lowercase преобразуют вводимые символы. В первом случае происходит конвертирование в символы верхнего ре гистра, а во втором — в символы нижнего регистра.

Флажок Read-only создает окно редактирования, которое предназначено только для чтения и не дает возможности пользователю вводить или редактировать текст.

Для каждого элемента управления Edit box система резервирует в области па мяти приложения буфер размером 32 Кбайт для хранения введенного текста.

Посылка сообщений окну редактирования

Для выполнения различных операций по редактированию текста приложение может отправлять сообщения элементу hwndEdit с помощью вызова следующей функции:

SendMessage(hwndEdit, код_сообщения, wParam, lParam);

В параметре hwndEdit указывается дескриптор элемента управления.

Win32 API содержит специальную функцию SendDlgItemMessage для отправки сообщений элементам управления, обращение к которой выглядит так:

SendDlgItemMessage(hDlg, nIDD, код_сообщения, wParam, lParam);

где hDlg — дескриптор родительского диалогового окна, nIDD — идентификатор элемента управления. Иногда проще будет использовать эту функцию, а не SendMessage, так как в данном случае не требуется получать дескриптор элемента управления. По результатам выполнения обе функции равнозначны.

В табл. 7.6 описаны некоторые коды сообщений для работы с окном редакти рования.

Таблица 7.6. Операции с окном редактирования через коды сообщений

сом lpString. Параметр nMaxCount задает максимальное количество символов, ко пируемых в буфер lpString. При успешном завершении функция возвращает чис ло символов, прочитанных в буфер, без учета завершающего нуль символа. При возникновении ошибки функция возвращает нулевое значение.

Функция SetDlgItemText, имеющая такие же параметры, осуществляет обрат ную операцию записи текстовой строки, на которую указывает lpString, в элемент управления ctrlID.

Функция GetDlgItemInt с прототипом

UINT GetDlgItemInt(HWND hDlg, int ctrlID, BOOL* lpTranslated, BOOL bSigned);

предназначена для извлечения текстового изображения десятичного числа из эле мента управления ctrlID и преобразования его к целочисленному значению. Если изображению числа предшествуют пробелы, то они отбрасываются. В процессе преобразования функция сканирует текстовую строку символ за символом и, если очередной символ оказывается не цифрой, то прекращает преобразование.

Параметру lpTranslated обычно передается адрес переменной типа BOOL, в кото рую записывается значение, свидетельствующее об успешности завершения функ ции. Значение TRUE используется в случае успешного преобразования. Если вас эта информация не интересует, то можно передать данному параметру значение NULL.

Если параметр bSigned равен TRUE, то функция будет учитывать наличие знака «минус» перед числом и возвращать значение типа int, несмотря на определение в прототипе функции возвращаемого типа UINT. Пробел между минусом и первой цифрой числа не допускается.

Функция GetDlgItemInt возвращает нулевое значение, если транслируемое значение превышает INT_MAX (2147483647) для знакового числа или UINT_MAX (4294967295) для беззнакового числа.

Пример использования функций GetDlgItemText и SetDlgItemText приведен в ли стинге 7.4.

Список

Список (List box) представляет собой прямоугольное окно, в котором отображает ся набор элементов, из которых пользователь может делать выбор.

Элементы списка могут быть представлены строками, растровыми образами или комбинацией текста и изображения. Если размеры окна не позволяют пока зать все элементы списка, то List box создает полосу прокрутки. Типичный пример использования списка — список файлов в диалоговом окне Open, вызываемом по команде File Open в среде Visual Studio.

Различают списки с единичным выбором, в которых пользователь может выб рать только один пункт списка, и списки с множественным выбором, допускаю щие выбор более одного пункта списка. Windows показывает выбранный элемент

всписке, инвертируя цвет текста и цвет фона для символов.

Всписке с единичным выбором пользователь может выбрать пункт списка щелчком мыши или нажатием клавиши пробела после получения списком фоку са ввода. Клавиши управления курсором перемещают как курсор, так и текущую выборку. В списке с множественным выбором первый щелчок на пункте выбира ет его, а следующий щелчок отменяет предыдущую операцию.

Программа может добавлять или удалять элементы в списке, отсылая сообще ния оконной процедуре списка. Когда пользователь выбирает или отменяет вы

Затем для получения конкретного элемента списка в приложении можно исполь зовать сообщение LB_GETTEXT.

Флажок Multi-column позволяет создавать многостолбцовый список, который может прокручиваться по горизонтали. Но для этого должен быть установлен флажок Horizontal scroll. Для установки ширины столбцов используется сообще ние LB_SETCOLUMNWIDTH.

Флажок No redraw определяет список, окно которого не получает сообщений WM_PAINT при внесении изменений. Этот стиль может быть в любой момент отме нен посылкой сообщения WM_SETREDRAW.

Флажок Disable no scroll заставляет отображать в списке вертикальную полосу прокрутки, даже если список не содержит необходимого количества элементов. При этом полоса прокрутки недоступна до тех пор, пока не появится достаточное количество элементов. По умолчанию полоса прокрутки скрыта, если список со держит столько элементов, что все они отображаются в окне.

Посылка сообщений списку

Для выполнения различных операций со списком приложение может отправлять сообщения элементу hwndList, вызывая функцию

SendMessage(hwndList, код_сообщения, wParam, lParam);

или равнозначную ей функцию

SendDlgItemMessage(hDlg, IDC_LIST, код_сообщения, wParam, lParam);

где IDC_LIST — идентификатор элемента управления.

Результаты выполнения этих функций для некоторых кодов сообщений опи сываются в табл. 7.8.

Таблица 7.8. Операции со списком через коды сообщений

первоначальной формы диалога примерно вдвое и разместите на ней элементы управления в соответствии с рис. 7.25.

Ширину окна списка, возможно, придется изменить. Это выяснится на этапе тестирования программы. В окне списка должны быть полностью видны первые два поля каждой записи, но не должно попадать начало третьего поля.

Позже, при разработке приложения MyNotebook2, мы покажем, как можно ре гулировать программным способом размеры и размещение элементов управле ния в зависимости от метрик используемого шрифта.

Для элементов управления должны быть установлены следующие атрибуты:

Включите в приложение ресурс диалогового окна IDD_ADD_REC с заголовком Ввод записи. Свойства диалогового окна оставьте по умолчанию. Поместите на фор му диалога IDD_ADD_REC четыре надписи и четыре окна редактирования. Разме щение элементов управления должно соответствовать рис. 7.26.

Рис. 7.26. Форма диалога IDD_ADD_REC

Для элементов управления установите следующие атрибуты:

Осталось написать код. Добавьте к проекту файл MyNotebook1.cpp, текст кото рого приведен в листинге 7.4.

Листинг 7.4. Проект MyNotebook1

//////////////////////////////////////////////////////////////////////

// MyNotebook1.cpp #include <windows.h> #include <fstream> using namespace std;

#include "KWnd.h" #include "resource.h"

#define N1 21 #define N2 81

#define TOTAL_SIZE (3*N1 + N2)

fstream fdat;

struct SubStr { char name[N1]; char phone[N1];

char birthday[N1]; char address[N2];

};

union Data { SubStr ss;

char line[TOTAL_SIZE];

};

class ListItem {

char buf[TOTAL_SIZE]; public:

ListItem() { Clear(); }

//Очистка данных (заполнение строки line пробелами) void Clear() { memset(dat.line, ' ', TOTAL_SIZE); }

//Замена в строке line всех нулевых байтов, кроме последнего,

//символом 'пробел'

void DoOneString() { int count = 0;

for (int i = TOTAL_SIZE - 1; i > 0; --i) if (!dat.line[i])

if (!count) count++; else dat.line[i] = ' ';

}

const char* GetBirthday() { memcpy(buf, dat.ss.birthday, N1);