StringGadget3D

StringGadget3D()

Синтаксис

Result = StringGadget3D(#Gadget3D , x , y , Width , Height , Content$ [, Flags])

Описание

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

Параметры

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

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

Content$ Начальное текстовое содержимое этого StringGadget3D. Этот Гаджет принимает только одну строку текста. Чтобы получить многострочный ввод, используйте функцию EditorGadget3D().
Flags (дополн.)
Этот параметр может быть комбинацией следующих значение (с помощью оператора '|'):
  #PB_String3D_Numeric    : Принимаются только (положительные) целые числа.
  #PB_String3D_Password   : Режим пароля, отображающий только '*' вместо обычных символов.
  #PB_String3D_ReadOnly   : Режим только для чтения. Текст не может быть введен.

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

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

Комментарии

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

Следующие события поддерживаются через EventType3D():
#PB_EventType3D_Change : Текст был изменен пользователем. #PB_EventType3D_Focus : StringGadget3D получил фокус. #PB_EventType3D_LostFocus : StringGadget3D потерял фокус.
Вы можете добавить 'Всплывающую мини-подсказку' к этому 3D-Гаджету с помощью функции GadgetToolTip3D().

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

Все

<- SpinGadget3D() - Gadget3D Index - TextGadget3D() ->

#Gadget3D	Номер для идентификации нового 3D-Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
x, y, Width, Height	Позиция и размеры нового 3D-Гаджета.
Content$	Начальное текстовое содержимое этого StringGadget3D. Этот Гаджет принимает только одну строку текста. Чтобы получить многострочный ввод, используйте функцию EditorGadget3D().
Flags (дополн.)	Этот параметр может быть комбинацией следующих значение (с помощью оператора '\|'): #PB_String3D_Numeric : Принимаются только (положительные) целые числа. #PB_String3D_Password : Режим пароля, отображающий только '*' вместо обычных символов. #PB_String3D_ReadOnly : Режим только для чтения. Текст не может быть введен.