Использование элементов управления 1С

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

Общие сведения

Существует два класса для работы с полями ввода: CMaskEdit и CBtnEdit. При этом CBtnEdit является наследником CMaskEdit и только немного расширяет функционал CMaskEdit: добавляет отображение кнопки выбора («педальки») и генерацию событий при ее нажатии.

Создание элемента управления

В нашем классе, наследнике CWnd, определяем переменную типа CBtnEdit (или CMaskEdit, далее будем рассматривать только CBtnEdit):
CBtnEdit EditTest;

Для хранения значения, которое будет меняться этим элементом определяем еще одну переменную класса типа CDate, CNumeric или CString:

CNumeric m_TestNumeric;

В функции OnCreate для CWnd или OnInitialUpdate для CView выполняем создание окна – элемента управления:

RECT rect = {10, 10, 100, 100}; EditTest.Create (WS_CHILD | WS_VISIBLE, rect, this, 120, "TYPE=\"NUMERIC\",LEN=10");

Как можно видеть, используется стандартная для CWnd функция Create, которая принимает в качестве параметров стиль создаваемого окна, прямоугольник, определяющий, положение и размеры окна, ссылку на родительское окно, идентификатор элемента управления и текст окна. Отличия для одинэсных элементов только в использовании параметра «текст окна». Этот параметр определяет тип и другие параметры создаваемого элемента управления. Строка задается в формате: «ИМЯ_ПАРАМЕТРА1=ЗНАЧЕНИЕ_ПАРАМЕТРА1,ИМЯ_ПАРАМЕТРА2=ЗНАЧЕНИЕ_ПАРАМЕТРА2,...» Доступные параметры (которые удалось пока реконструировать):

• TYPE. Строковый параметр (значения должны заключаться в кавычки). Может принимать значения: DATE, NUMERIC, NUM (синоним NUMERIC?), MASK.
• MASK. Строковый параметр. Используется, если TYPE – DATE или MASK. Определяем маску ввода. Обнаруженные примеры масок: “DD.MM.CCYY”, “DD.MM.YY” (для дат), "99:99:99”, “UUU” (для типа MASK). Вероятно, для задания маски можно использовать правила в стандартной документации.
• LEN. Числовой параметр. Длина содержимого поля.
• PREC. Числовой параметр. Точность поля (для числовых полей).
• SEP. Булевый параметр (принимает значения 1 или 0). Признак разделителя триад (для числовых полей).
• POSONLY. Булевый параметр. Назначение пока не совсем ясно.

Запись и чтение значений

Для записи и чтения данных из элементов 1С применяется стандартный MFC-механизм обмена данными с элементами CWnd. Поэтому в своем классе мы должны определить функцию DoDataExchange, в котором мы должны разместить код обмена данными:

void COurSuperView::DoDataExchange(CDataExchange* pDX) { DDX_MaskText (pDX, 120, m_TestNumeric); CScrollView::DoDataExchange(pDX); }

Как можно видеть, применяется функция DDX_MaskText?, экспортируемая из br32.dll. Данная функция будет читать/записывать данные в элемент управления в зависимости от текущего этапа обмена данными.

Для начальной инициализации элемента управления (после создания элемента управления и инициализации соответствующей переменной CNumeric) мы должны вызвать функцию UpdateData (FALSE). Для получения данных из элемента управления мы должны вызвать UpdateData (TRUE).

События, генерируемые элементом управления

Элемент управления генерирует события при помощи отправки сообщений WM_COMMAND родительскому окну. При этом вся информация о событии передается в параметре wParam: в LOWORD (wParam) – идентификатор элемента (с которым он был создан), в HIWORD (wParam) – код события. Расшифрованные события:

• 0x700 – вызывается при нажатии на кнопку выбора (педальку)

Есть и другие события (в частности, получение/потеря фокуса), клик мышкой по элементу и другие.

Для обработки событий можно использовать функцию класса OnCommand:
BOOL COurSuperView::OnCommand(WPARAM wParam, LPARAM lParam) { UINT nCommand = LOWORD (wParam); UINT nNotify = HIWORD (wParam); if (nCommand == 120 && nNotify == 0x700) { OnButtonClick (); } return CScrollView::OnCommand(wParam, lParam); }

или можно отредактировать карту сообщений класса.

Использование календаря и калькулятора для «выбора» значения через педальку

Итак, у нас есть возможность отловить событие нажатия на кнопку выбора. Почему бы при поступлении этого события не отобразить календарь или калькулятор, как это обычно делает 1С? Рассмотрим, как это можно сделать.

Выбор даты

Для выбора даты используем класс CCalendar:
void COurSuperView::OnButtonClick() { UpdateData (TRUE); // прочитаем данные из элемента CCalendar Calendar; Calendar.GetDate (&EditTest, date, date); // произведем выбор даты UpdateData (FALSE); // запишем новую дату в элемент }

Выбор числа

Для выбора числа используем класс CCalculator:
void COurSuperView::OnButtonClick() { UpdateData (TRUE); // прочитаем данные из элемента CCalculator calc; calc.GetNumber (&EditTest, m_TestNumeric, 10, 2); // произведем выбор числа UpdateData (FALSE); // запишем новое число в элемент }

Для нормальной работы класса CCalculator необходимо добавить в определение класса CCalculator переменную
BYTE buffer [3000];
При отсутствии этой переменной 1С падает при конструировании класса CCalculator.

Ввод данных ссылочных типов

Рассматриваемый элемент управления 1С не предоставляет возможности выбирать элементы справочников, документы и т.п. Поэтому остается реализовать эту возможность самостоятельно:

• Используем элемент в режиме работы со строкой текста.
• При нажатии на кнопку выбора создаем контекст нужного справочника при помощи класса CBLContext.
• При помощи метода Выбрать получаем ссылку на элемент справочника.
• Запоминаем ссылку в переменной нашего класса.
• Строковое представление элемента записываем в элемент управления.