Елемент управління «Поле введення» призначений для введення текстового рядка або числа з клавіатури в графічному інтерфейсі. Введене значення передається в контролер в відповідне поле структури RemoteXY. Поле введення підтримує введення довільного тексту, введення цілого числа, введення дійсного числа.
структура даних
Для довільного тексту
Введена текстовий рядок UTF8 закінчується нулем, під рядок виділено x байт
Для дійсного числа
Введене значення числа
Для цілого числа
Введене значення числа
Елемент управління «Поле введення» дозволяє ввести довільну текстову інформацію або числову інформацію з екрану графічного інтерфейсу. Поле введення підтримує три режими роботи: введення тексту, введення цілого числа, введення дійсного числа з плаваючою крапкою.
Під час введення тексту кількість байт, що виділяються під рядок задається у властивостях елементу. Використовується кодування UTF8, з чим потрібно враховувати, що під деякі символи виділяється по 2 байта на символ.
При введенні дійсного числа необхідно вказати кількість розрядів після коми, що відображаються в поле введення.
Підтримка типу значення, що вводиться так само здійснюється на етапі введення значення шляхом надання користувачу відповідної клавіатури для введення. Поле введення може містити кнопку очищення введеного значення. Підтримується центрування введеного тексту вліво, вправо і по центру.
властивості елемента
Ім'я змінної в структурі RemoteXY за правилами мови C ++
Колір поля введення
Тип даних, що вводяться
Визначає тип даних, що вводяться. Доступні значення: текстовий рядок, дійсне число, ціле число.
Кількість байт, що виділяються під рядок. Система автоматично додасть 1 байт для завершального нуля. Властивість задається тільки для текстового рядка. Необхідно враховувати, що в кодуванні UTF8 деякі символи займають 2 байти.
Кількість знаків після коми, що відображаються в поле введення. Властивість задається тільки для дійсних чисел.
Горизонтальне вирівнювання введеного тексту. Доступні значення: зліва, центр, праворуч.
Ознака відображення фону поля введення.
Ознака відображення кнопки очищення поля введення.
Приклади програмування Arduino IDE
Для перевірки введеного в поле введення тексту на відповідність певному рядку, можна використовувати наступний код:
if (strcmp (RemoteXY.edit_1, "OK") == 0) <
// TODO entered "OK"
Приклад, як перетворити введений рядок в числовий тип даних, в разі якщо для введення даних використовується довільний текст:
Для цілого числа:
int value = atoi (RemoteXY.edit_1);
Для дійсного числа:
float value = atof (RemoteXY.edit_1);