UI Documentation - TonSharp/WAPITIS GitHub Wiki
Компоненты UI призваны упростить создание и работу с элементами пользовательского интерфейса. Примечание: Просьбы по добавлению новый элементов или функционала для уже имеющихся оформлять в разделе Issues на GitHub.
Быстрый доступ:
Дополнительно:
Находится в файле UI.hpp. Это базовый класс для всех создаваемых элементов. Все зависимости указываются в файле UILibs.hpp.
В качестве аргументов принимает текст, дескриптор родительского окна и hInstance приложения.
UI(wstring text, HWND parent, HINSTANCE hInstance)Виртуальный метод, который не содержит логики по умолчанию. Все классы-наследники обязаны его переопределить. В качестве аргументов принимает стиль, позицию и размер.
virtual void Create(DWORD style, Transform pos, Transform size)Проверяет клик ПКМ по элементу для вызова контекстного меню. В качестве аргументов принимает структуру CallbackArgs. Если щелчок был сделан, возвращает true, иначе - false. Для правильной работы вызывается только из функции обработки сообщений.
bool IsContextMenu(CallbackArgs args)Добавляет возможность вертикальной прокрутки контента. В случае вертикального переполнения элемента появляется вертикальная полоса прокрутки (Примечание: Работает не со всеми элементами).
virtual void AddVScroll()Аналог AddVScroll с горизонтальной прокруткой.
virtual void AddHScroll()Устанавливает отображаемый текст элемента.
virtual void SetText(wstring text)Возвращает дескриптор элемента.
HWND Get();Возвращает указатель на дескриптор элемента.
HWND* GetPointer()Является наследником класса UI и служит родителем для всех основных типов кнопок (обычная кнопка, радиокнопка, чекбокс и т.д.).
Аналогично с UI.
Аналогично с UI.
Метод изменения состояния кнопки (нажата или отжата). В качестве аргумента принимает bool. Принимает true для установки кнопки в состояние нажатия, иначе - false.
virtual void SetState(bool state)Метод для изменения состояния переключателя для чекбокса. В качестве аргумента принимает bool. Аналогично SetState.
virtual void SetCheck(bool check)Метод проверяет, выбран ли чекбокс или прочий схожий элемент. Возвращает true, иначе - false.
virtual bool IsChecked()Метод проверяет, была ли нажата кнопка. Возвращает true, если было осуществлено нажатие, иначе - false. В качестве аргумента принимает структуру CallbackArgs.
virtual bool IsClicked(CallbackArgs args)Стандартная кнопка. Методы идентичны ButtonBase.
Поле с флажком. Методы идентичны ButtonBase.
Поле с флажком с тремя состояниями. Методы идентичны ButtonBase.
Поле, в котором может быть выбран только один элемент из данных в группе. Методы идентичны ButtonBase.
Статичный элемент отображения текста. Методы идентичны UI.
Выпадающий список.
Аналогично с UI.
Аналогично с UI.
Если на элементе присутствуют полосы прокрутки, то они не будут скрыты даже в случае, если контент не переполняет элемент.
void DisableNOScroll()Метод добавляет указанную строку в конец списка.
void AddItem(wstring str)Метод добавляет несколько строк в конец списка.
void AddRange(vector<wstring> data)Метод удаляет элемент из списка по его индексу.
void RemoveItemByIndex(int index)Метод удаляет выделенный элемент.
void RemoveSelectedItem()Метод полностью очищает список.
void Clear()Метод возвращает количество элементов в списке.
int GetCount()Метод возвращает индекс выделенного элемента списка.
int GetSelectedIndex()Метод возвращает строку по ее индексу в списке.
wstring GetStringByIndex(int index)Метод возвращает выбранную строку списка.
wstring GetSelectedText()Метод выделяет элемент по его индексу.
void SelectItem(int index)Метод проверяет, был ли изменен выбор элемента. Возвращает true, если был выбран другой элемент, иначе - false.
bool IsSelectChanged(CallbackArgs args)Метод проверяет, был ли сделан двойной щелчок мыши по элементу. Возвращает true, если элемент был нажат два раза, иначе - false.
bool IsDoubleClick(CallbackArgs args)Список, содержащий строки. Функционал повторяет ComboBox, за исключением следующих методов:
Метод удаляет все выделенные элементы списка.
void RemoveSelectedItems()Метод выбирает несколько элементов из списка (от начального индекса до конечного).
void SelectItems(int startIndex, int endIndex)Метод возвращает количество выбранных элементов списка.
int GetSelectedCount()Поле для ввода текста. Конструктор аналогичен с UI.
Метод устанавливает ограничение по длине текста.
void LimitText(int maxCount)Метод делает поле многострочным.
void MultiLine()Метод устанавливает выравнивание текста по левому краю / центру / правому краю.
void LeftAlign()
void CenterAlign()
void RightAligin()Метод устанавливает стиль, при котором все буквы при вводе конвертируются в нижний регистр.
void Lowercase()Метод устанавливает стиль, при котором все буквы при вводе конвертируются в верхний регистр.
void Uppercase()Метод устанавливает стиль, который позволяет вводить только цифры.
void Number()Данный метод устанавливает стиль, который скрывает все символы и отображает вместо них значок звёздочки (*).
void Password()Данный метод устанавливает стиль, при котором поле неактивно и ввод в него запрещен.
void ReadOnly()Данный метод возвращает строку по ее индексу (Примечание: В однострочном поле индекс всегда равен 0).
wstring GetLine(int line)Данный метод возвращает число всех строк поля для ввода (при использовании многострочного поля).
int GetLinesCount()Данный метод определяет, были ли внесены изменения в поле ввода. Возвращает true, если пользователь написал или стёр символ, иначе - false.
bool IsChaged(CallbackArgs args)Этот раздел пока пуст.