TextGadget

TextGadget()

Синтаксис

Result = TextGadget(#Gadget , x , y , Width , Height , Text$ [, Flags])

Описание

Создаёт Гаджет "Текст" (Text Gadget) в текущем списке Гаджетов (GadgetList). TextGadget - это простейшая текстовая область для отображения текста, но НЕ для ввода и редактирование текста.

Параметры

#Gadget Номер для идентификации нового Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.

x, y, Width, Height Позиция и размеры нового Гаджета.

Text$ Текст, который требуется вывести на экран.
Flags (дополн.)
Флаги, позволяющие изменить поведение Гаджета. Этот параметр может быть комбинацией следующих значение (с помощью оператора '|'):
  #PB_Text_Center : Текст центрируется в Гаджете.
  #PB_Text_Right  : Текст выравнивается по правому краю.
  #PB_Text_Border : Вокруг Гаджета будет нарисована обтекаемая граница.

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

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

Комментарии

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

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

Примечание: GadgetToolTip() работает только в Linux.

Пример

If OpenWindow(0, 0, 0, 270, 160, "Гаджет Текст", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
TextGadget(0, 10, 10, 250, 20, "Стандартный TextGadget (Лево)")
TextGadget(1, 10, 70, 250, 20, "TextGadget (Центр)", #PB_Text_Center)
TextGadget(2, 10, 40, 250, 20, "TextGadget (Право)", #PB_Text_Right)
TextGadget(3, 10, 100, 250, 20, "TextGadget с Границей", #PB_Text_Border)
TextGadget(4, 10, 130, 250, 20, "TextGadget Центр + Граница", #PB_Text_Center | #PB_Text_Border)
Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
EndIf

См. также

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

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

Все

<- StringGadget() - Оглавление Gadget - TrackBarGadget()->

#Gadget	Номер для идентификации нового Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
x, y, Width, Height	Позиция и размеры нового Гаджета.
Text$	Текст, который требуется вывести на экран.
Flags (дополн.)	Флаги, позволяющие изменить поведение Гаджета. Этот параметр может быть комбинацией следующих значение (с помощью оператора '\|'): #PB_Text_Center : Текст центрируется в Гаджете. #PB_Text_Right : Текст выравнивается по правому краю. #PB_Text_Border : Вокруг Гаджета будет нарисована обтекаемая граница.