Fabervox: Created page with "NOTOC {{RU/Client function}} Эта функция позволяет создавать GUI кнопки. NOTOC {{RU/Client function}} Image:Gui-edit.png|frame|П..."

2015-12-21T14:12:53Z

Created page with "__NOTOC__ {{RU/Client function}} Эта функция позволяет создавать GUI кнопки. __NOTOC__ {{RU/Client function}} Image:Gui-edit.png|frame|П..."

New page

__NOTOC__
{{RU/Client function}}
Эта функция позволяет создавать GUI кнопки.
__NOTOC__
{{RU/Client function}}
[[Image:Gui-edit.png|frame|Пример редактируемого поля.]]
<table><tr><td valign=top height=80>

Эта функция необходима для создания нового редактируемого поля. Оно является текстовым полем для ввода пользователем текста. При этом она однострочная, если вы хотите получить больше одной строки, используйте [[RU/guiCreateMemo|guiCreateMemo]].

</td></tr></table>

==Синтаксис==
<syntaxhighlight lang="lua">
element guiCreateEdit ( float x, float y, float width, float height, string text, bool relative, [element parent = nil] )
</syntaxhighlight>

===Обязательные аргументы===
[[Image:Button.png|thumb|Пример кнопки.]]
*'''x:''' Позиция редактируемого поля по оси X на экране игрока. Зависит от аргумента ''relative''.
*'''y:''' Позиция редактируемого поля по оси Y на экране игрока. Зависит от аргумента ''relative''.
*'''width:''' Ширина редактируемого поля. Зависит от аргумента ''relative''.
*'''height:''' Высота редактируемого поля. Зависит от аргумента ''relative''.
*'''text:''' Первоначальный текст в поле.
*'''relative:''' Определяет, относительны ли позиция и размер. Если указано ''true'', то значения аргументов ''x, y, width'' и ''height'' должны быть между 0 и 1, относительны к размеру родителя.

===Необязательные аргументы===
{{RU/OptionalArg}}
*'''parent:''' Родитель, к которому прикреплено редактируемое поле. Если значение аргумента ''relative'' – ''true'', размеры и позиция будут относительны к родителю. Если ''relative'' – ''false'', позиция поля будет количеством пикселей от позиции родителя. Если родитель не был указан, родителем станет сам экран – соответственно позиция и размеры будут относительны ему.

===Возвращает===
Возвращает элемент типа ''gui-edit'' созданного поля, в случае удачного создания, ''false'' в противном случае.

==Примеры==
Этот пример создает редактируемое поле рядом с кнопкой "вывод". Когда кнопка будет нажата, это приведет к выводу сообщения из редактируемого поля в чат.
<syntaxhighlight lang="lua">
--создает кнопку
button = guiCreateButton( 0.7, 0.1, 0.2, 0.1, "вывод", true )
--создает редактируемое поле и присваивает переменной editBox
editBox = guiCreateEdit( 0.3, 0.1, 0.4, 0.1, "", true )
guiEditSetMaxLength ( editBox, 128 ) --устанавливает максимальную длинну поля в 128 символов

--создает функцию для вывода сообщения в чат
function outputEditBox ()
local text = guiGetText ( editBox )--получаем текст из редактируемого поля
outputChatBox ( text ) -- выводит текст
end
addEventHandler ( "onClientGUIClick", button, outputEditBox )

</syntaxhighlight>

Этот пример, создает редактируемое поле и устанавливает фокус ввода, без необходимости игроку нажимать на него:
<syntaxhighlight lang="lua">
local editBox = guiCreateEdit( 0.3, 0.1, 0.4, 0.1, "", true )
guiBringToFront( editBox )
guiEditSetCaretIndex( editBox, 1 )
</syntaxhighlight>

==Смотрите также==
{{RU/GUI_functions}}
[[en:guiCreateEdit]]

RU/guiCreateEdit - Revision history

Fabervox: Created page with "__NOTOC__ {{RU/Client function}} Эта функция позволяет создавать GUI кнопки. __NOTOC__ {{RU/Client function}} Image:Gui-edit.png|frame|П..."

Fabervox: Created page with "NOTOC {{RU/Client function}} Эта функция позволяет создавать GUI кнопки. NOTOC {{RU/Client function}} Image:Gui-edit.png|frame|П..."