PureBasic

StringGadget()

Синтаксис

Result = StringGadget(#Gadget , x , y , Width , Height , Content$ [, Flags])

Описание


Создает Гаджет "Строка Ввода" (String Gadget) в текущем списке Гаджетов (GadgetList). Это позволяет пользователю вводить одну строку текста.

Параметры

#Gadget Номер для идентификации нового Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
x, y, Width, Height Позиция и размеры нового Гаджета.
Content$ Начальное текстовое содержимое этого StringGadget. Этот Гаджет принимает только одну строку текста. Чтобы получить многострочный ввод, используйте функцию EditorGadget().
Flags (дополн.) Флаги, позволяющие изменить поведение Гаджета. Этот параметр может быть комбинацией следующих значение (с помощью оператора '|'): 
  #PB_String_Numeric    : Принимаются только (положительные) целые числа.
  #PB_String_Password   : Режим пароля, отображающий только '*' вместо обычных символов.
  #PB_String_ReadOnly   : Режим только для чтения. Текст не может быть введен.
  #PB_String_LowerCase  : Все символы автоматически преобразуются в нижний регистр.
  #PB_String_UpperCase  : Все символы автоматически преобразуются в верхний регистр.
  #PB_String_BorderLess : Вокруг Гаджета не будут отображаться границы.

Возвращаемое значение

Возвращает не нулевое значение в случае успешного создания Гаджета, в противном случае возвращает ноль. Если в качестве параметра #Gadget использовалось значение #PB_Any, то в случае успеха, возвращаемым значением будет сгенерированный Номер Гаджета.

Комментарии

Содержимое можно изменить с помощью функции SetGadgetText() и получить с помощью функции GetGadgetText().

Через EventType() поддерживаются следующие события: 
  #PB_EventType_Change    : Текст был изменен пользователем.
  #PB_EventType_Focus     : StringGadget получил фокус.
  #PB_EventType_LostFocus : StringGadget потерял фокус.
Для работы с этим Гаджетом можно использовать следующие функции:

- Функции SetGadgetColor() и GetGadgetColor() со следующими значениями для параметра 'ColorType': 
  #PB_Gadget_FrontColor: Цвет текста
  #PB_Gadget_BackColor : Цвет фона
- GetGadgetAttribute() со следующим атрибутом: 
  #PB_String_MaximumLength: Возвращает максимальное количество символов, которое может быть введено.
- SetGadgetAttribute() со следующим атрибутом: 
  #PB_String_MaximumLength: Задаёт максимальное количество символов, которое можно ввести.
Вы можете добавить 'Всплывающую мини-подсказку' к этому Гаджету с помощью функции GadgetToolTip().

Пример

; Показывает возможные флаги StringGadget в действии...
If OpenWindow(0, 0, 0, 322, 205, "Флаги StringGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    StringGadget(0, 8, 10, 306, 20, "Нормальный StringGadget...")
    StringGadget(1, 8, 35, 306, 20, "1234567", #PB_String_Numeric)
    StringGadget(2, 8, 60, 306, 20, "StringGadget Только для чтения", #PB_String_ReadOnly)
    StringGadget(3, 8, 85, 306, 20, "Нижний регистр...", #PB_String_LowerCase)
    StringGadget(4, 8, 110, 306, 20, "Верхний регистр...", #PB_String_UpperCase)
    StringGadget(5, 8, 140, 306, 20, "StringGadget без границ", #PB_String_BorderLess)
    StringGadget(6, 8, 170, 306, 20, "Режим Password", #PB_String_Password)
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
EndIf


См. также

GetGadgetText(), SetGadgetText(), GetGadgetColor(), SetGadgetColor(), EditorGadget()

Поддерживаемые OS

Все

<- SplitterGadget() - Оглавление Gadget - TextGadget()->