PureBasic

EditorGadget()

Синтаксис

Result = EditorGadget(#Gadget , x , y , Width , Height [, Flags])

Описание


Создает Гаджет "Редактор" (Editor Gadget) в текущем списке Гаджетов (GadgetList).

Параметры

#Gadget Номер для идентификации нового Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
x, y, Width, Height Позиция и размеры нового Гаджета.
Flags (дополн.) Флаги, позволяющие изменить поведение Гаджета. Этот параметр может быть одним из следующих значений: 
  #PB_Editor_ReadOnly: Запрещает пользователю редактировать текст в Гаджете.
  #PB_Editor_WordWrap: Слишком длинные строки для отображения на экране будут автоматически прокручиваться.

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

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

Комментарии

Вы можете добавить 'Всплывающую мини-подсказку' к этому Гаджету с помощью функции GadgetToolTip().

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

- AddGadgetItem(): Добавляет строку текста в EditorGadget.
- CountGadgetItems(): Возвращает количество строк в EditorGadget.
- GetGadgetItemText(): Возвращает текст указанной строки EditorGadget.
- GetGadgetText(): Возвращает текстовое содержимое EditorGadget. Обратите внимание на то, что несколько строк текста разделяются символами "Chr (13) + Chr (10)" в Windows и "Chr (10)" в Linux и OS X.
- RemoveGadgetItem(): Удаляет указанную строку в EditorGadget.
- ClearGadgetItems(): Удаляет весь текст в EditorGadget.
- SetGadgetItemText(): Изменяет текст указанной строки в EditorGadget.
- SetGadgetText(): Заменяет весь текст в EditorGadget на другой.
- SetGadgetAttribute(): Со следующим атрибутом: 
  #PB_Editor_ReadOnly: Устанавливает состояние "только для чтения" (0 -  "редактируемое", 1 - "только для чтения").
  #PB_Editor_WordWrap: Устанавливает состояние "автоматическое прокручивание строк"
- GetGadgetAttribute(): Со следующим атрибутом: 
  #PB_Editor_ReadOnly: Возвращает состояние "только для чтения" (0 - "редактируемое", 1 - "только для чтения").
  #PB_Editor_WordWrap: Возвращает состояние "автоматическое прокручивание строк"

Этот Гаджет поддерживает функции SetGadgetColor() и GetGadgetColor() со следующими значениями для параметра 'ColorType': 
  #PB_Gadget_BackColor      : Цвет фона (не поддерживается в MacOSX).
  #PB_Gadget_FrontColor     : Цвет текста.

Пример

If OpenWindow(0, 0, 0, 322, 150, "Гаджет Редактор", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    EditorGadget(0, 8, 8, 306, 133)
    For a = 0 To 5
        AddGadgetItem(0, a, "Строка "+Str(a))
    Next
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
EndIf


См. также

AddGadgetItem(), RemoveGadgetItem(), CountGadgetItems(), ClearGadgetItems(), GetGadgetText(), SetGadgetText(), GetGadgetItemText(), SetGadgetItemText(), GetGadgetAttribute(), SetGadgetAttribute(), GetGadgetColor(), SetGadgetColor(), StringGadget()

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

Все

<- DisableGadget() - Оглавление Gadget - ExplorerComboGadget()->