RU/outputChatBox - Revision history

Qaisjp: prefer normal note

2019-09-07T08:38:49Z

prefer normal note

← Older revision		Revision as of 08:38, 7 September 2019
Line 1:		Line 1:
	{{RU/Server client function}}		{{RU/Server client function}}
	{{~~Note_box~~\|Не рекомендуется выводить в чат информацию, которая самими чатом (разговором) не является. Для целей отображения вспомогательной информации следует использовать возможности GUI}}		{{Note\|Не рекомендуется выводить в чат информацию, которая самими чатом (разговором) не является. Для целей отображения вспомогательной информации следует использовать возможности GUI}}
	__NOTOC__		__NOTOC__
	Эта функция выводит текстовую строку в окно чата. Можно осуществлять вывод как в чат отдельных игроков, так и всех сразу.		Эта функция выводит текстовую строку в окно чата. Можно осуществлять вывод как в чат отдельных игроков, так и всех сразу.

Strix at 16:32, 17 October 2014

2014-10-17T16:32:30Z

← Older revision		Revision as of 16:32, 17 October 2014
Line 13:		Line 13:
	<section name="Server" class="server" show="true">		<section name="Server" class="server" show="true">
	<syntaxhighlight lang="lua">bool outputChatBox ( string text [, element visibleTo=getRootElement(), int r=231, int g=217, int b=176, bool colorCoded=false ] )</syntaxhighlight>		<syntaxhighlight lang="lua">bool outputChatBox ( string text [, element visibleTo=getRootElement(), int r=231, int g=217, int b=176, bool colorCoded=false ] )</syntaxhighlight>
			{{RU/OOP\|\|[[игрок\|player]]:outputChat}}
	==Обязательные аргументы==		==Обязательные аргументы==
	*'''text:''' Текстовая строка, которая будет отправлена в окно чата.		*'''text:''' Текстовая строка, которая будет отправлена в окно чата.

Wielebny: Default outputChatBox colors are not 255,255,255 but 231,217,176

2012-08-21T10:39:27Z

Default outputChatBox colors are not 255,255,255 but 231,217,176

← Older revision		Revision as of 10:39, 21 August 2012
Line 12:		Line 12:
	==Синтаксис==		==Синтаксис==
	<section name="Server" class="server" show="true">		<section name="Server" class="server" show="true">
	<syntaxhighlight lang="lua">bool outputChatBox ( string text [, element visibleTo=getRootElement(), int r=~~255~~, int g=~~255~~, int b=~~255~~, bool colorCoded=false ] )</syntaxhighlight>		<syntaxhighlight lang="lua">bool outputChatBox ( string text [, element visibleTo=getRootElement(), int r=231, int g=217, int b=176, bool colorCoded=false ] )</syntaxhighlight>

	==Обязательные аргументы==		==Обязательные аргументы==
Line 20:		Line 20:
	{{RU/OptionalArg}}		{{RU/OptionalArg}}
	*'''visibleTo:''' Задает, кому будет виден чат. Все игроки-потомки этого элемента увидят сообщение. См. [[visibility]].		*'''visibleTo:''' Задает, кому будет виден чат. Все игроки-потомки этого элемента увидят сообщение. См. [[visibility]].
	*'''r:''' Целое число - количество красного компонента в цвете текста (0 - 255, по умолчанию ~~255~~).		*'''r:''' Целое число - количество красного компонента в цвете текста (0 - 255, по умолчанию 231).
	*'''g:''' Целое число - количество зеленого компонента в цвете текста (0 - 255, по умолчанию ~~255~~).		*'''g:''' Целое число - количество зеленого компонента в цвете текста (0 - 255, по умолчанию 217).
	*'''b:''' Целое число - количество синего компонента в цвете текста (0 - 255, по умолчанию ~~255~~).		*'''b:''' Целое число - количество синего компонента в цвете текста (0 - 255, по умолчанию 176).
	*'''colorCoded:''' Логическая переменная, которая определяет, будут ли использоваться строковые теги вида '#RRGGBB'.		*'''colorCoded:''' Логическая переменная, которая определяет, будут ли использоваться строковые теги вида '#RRGGBB'.
	'Примечания':		'Примечания':
Line 31:		Line 31:
	</section>		</section>
	<section name="Client" class="client" show="true">		<section name="Client" class="client" show="true">
	<syntaxhighlight lang="lua">bool outputChatBox ( string text [, int r=~~255~~, int g=~~255~~, int b=~~255~~, bool colorCoded=false ] )</syntaxhighlight>		<syntaxhighlight lang="lua">bool outputChatBox ( string text [, int r=231, int g=217, int b=176, bool colorCoded=false ] )</syntaxhighlight>

	==Обязательные аргументы==		==Обязательные аргументы==
Line 38:		Line 38:
	==Дополнительные аргументы==		==Дополнительные аргументы==
	{{RU/OptionalArg}}		{{RU/OptionalArg}}
	*'''r:''' Целое число - количество красного компонента в цвете текста (0 - 255, по умолчанию ~~255~~).		*'''r:''' Целое число - количество красного компонента в цвете текста (0 - 255, по умолчанию 231).
	*'''g:''' Целое число - количество зеленого компонента в цвете текста (0 - 255, по умолчанию ~~255~~).		*'''g:''' Целое число - количество зеленого компонента в цвете текста (0 - 255, по умолчанию 217).
	*'''b:''' Целое число - количество синего компонента в цвете текста (0 - 255, по умолчанию ~~255~~).		*'''b:''' Целое число - количество синего компонента в цвете текста (0 - 255, по умолчанию 176).
	*'''colorCoded:''' Логическая переменная, которая определяет, будут ли использоваться строковые теги вида '#RRGGBB'.		*'''colorCoded:''' Логическая переменная, которая определяет, будут ли использоваться строковые теги вида '#RRGGBB'.
	</section>		</section>

Miki785: Added link to Czech translation.

2012-06-16T17:02:36Z

Added link to Czech translation.

← Older revision		Revision as of 17:02, 16 June 2012
Line 101:		Line 101:
	==Смотрите также==		==Смотрите также==
	{{Server functions}}		{{Server functions}}
			[[cs:outputChatBox]]
	[[en:outputChatBox]]		[[en:outputChatBox]]

Damage22 at 19:56, 8 July 2010

2010-07-08T19:56:35Z

← Older revision		Revision as of 19:56, 8 July 2010
Line 89:		Line 89:
	</syntaxhighlight>		</syntaxhighlight>

	'''Пример 5:''' ~~Этот пример позволяет~~.		'''Пример 5:''' Отправляем приветствие игроку, зашедшему на сервер.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function onJoin()		function onJoin()

Damage22 at 19:55, 8 July 2010

2010-07-08T19:55:49Z

← Older revision		Revision as of 19:55, 8 July 2010
Line 36:		Line 36:
	*'''text:''' Текстовая строка, которая будет отправлена в окно чата.		*'''text:''' Текстовая строка, которая будет отправлена в окно чата.

	==~~Optional Arguments~~==		==Дополнительные аргументы==
	{{RU/OptionalArg}}		{{RU/OptionalArg}}
	*'''r:''' Целое число - количество красного компонента в цвете текста (0 - 255, по умолчанию 255).		*'''r:''' Целое число - количество красного компонента в цвете текста (0 - 255, по умолчанию 255).

Damage22 at 19:55, 8 July 2010

2010-07-08T19:55:35Z

← Older revision		Revision as of 19:55, 8 July 2010
Line 24:		Line 24:
	*'''b:''' Целое число - количество синего компонента в цвете текста (0 - 255, по умолчанию 255).		*'''b:''' Целое число - количество синего компонента в цвете текста (0 - 255, по умолчанию 255).
	*'''colorCoded:''' Логическая переменная, которая определяет, будут ли использоваться строковые теги вида '#RRGGBB'.		*'''colorCoded:''' Логическая переменная, которая определяет, будут ли использоваться строковые теги вида '#RRGGBB'.
	Note: '''visibleTo''' can also be a Team object, in this case, the text will be visible to all the players of that team. Also the #RRGGBB format must contain capital letters a-f is not acceptable but A-F is.
	'Примечания':		'Примечания':
	Если указан один из цветовых компонентов, то обязательно указывать и остальные.		Если указан один из цветовых компонентов, то обязательно указывать и остальные.

Damage22: Created page with '{{RU/Server client function}} {{Note_box|Не рекомендуется выводить в чат информацию, которая самими чатом (разговор…'

2010-07-08T19:55:06Z

Created page with '{{RU/Server client function}} {{Note_box|Не рекомендуется выводить в чат информацию, которая самими чатом (разговор…'

New page

{{RU/Server client function}}
{{Note_box|Не рекомендуется выводить в чат информацию, которая самими чатом (разговором) не является. Для целей отображения вспомогательной информации следует использовать возможности GUI}}
__NOTOC__
Эта функция выводит текстовую строку в окно чата. Можно осуществлять вывод как в чат отдельных игроков, так и всех сразу.

Дополнительно можно использовать строки с цветовыми кодами, передавая параметр ''colorCoded'' равным 'true'. Пример:
<syntaxhighlight lang="lua">
outputChatBox ( "#FF0000Hello #00FF00World", getRootElement(), 255, 255, 255, true )
</syntaxhighlight>
Это будет отображено в чате, как: '''<span style='color:red;'>Hello</span> <span style='color:green'>World</span> '''

==Синтаксис==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">bool outputChatBox ( string text [, element visibleTo=getRootElement(), int r=255, int g=255, int b=255, bool colorCoded=false ] )</syntaxhighlight>

==Обязательные аргументы==
*'''text:''' Текстовая строка, которая будет отправлена в окно чата.

==Дополнительные аргументы==
{{RU/OptionalArg}}
*'''visibleTo:''' Задает, кому будет виден чат. Все игроки-потомки этого элемента увидят сообщение. См. [[visibility]].
*'''r:''' Целое число - количество красного компонента в цвете текста (0 - 255, по умолчанию 255).
*'''g:''' Целое число - количество зеленого компонента в цвете текста (0 - 255, по умолчанию 255).
*'''b:''' Целое число - количество синего компонента в цвете текста (0 - 255, по умолчанию 255).
*'''colorCoded:''' Логическая переменная, которая определяет, будут ли использоваться строковые теги вида '#RRGGBB'.
Note: '''visibleTo''' can also be a Team object, in this case, the text will be visible to all the players of that team. Also the #RRGGBB format must contain capital letters a-f is not acceptable but A-F is.
'Примечания':
Если указан один из цветовых компонентов, то обязательно указывать и остальные.
'''visibleTo''' может быть объектом типа Team, тогда текст будет показан всем игрокам этой команды.
Формат #RRGGBB допускает в записи шестнадцатеричных чисел ''только'' заглавные буквы A-F.

</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">bool outputChatBox ( string text [, int r=255, int g=255, int b=255, bool colorCoded=false ] )</syntaxhighlight>

==Обязательные аргументы==
*'''text:''' Текстовая строка, которая будет отправлена в окно чата.

==Optional Arguments==
{{RU/OptionalArg}}
*'''r:''' Целое число - количество красного компонента в цвете текста (0 - 255, по умолчанию 255).
*'''g:''' Целое число - количество зеленого компонента в цвете текста (0 - 255, по умолчанию 255).
*'''b:''' Целое число - количество синего компонента в цвете текста (0 - 255, по умолчанию 255).
*'''colorCoded:''' Логическая переменная, которая определяет, будут ли использоваться строковые теги вида '#RRGGBB'.
</section>

==Вывод==
Возвращает ''true'', если сообщение было успешно отправлено. Возвращает ''false'', если были переданы некорректные аргументы.

==Пример==
<section name="Server" class="server" show="true">
'''Пример 1:''' Вывод сообщения всем пользователям.
<syntaxhighlight lang="lua">
x = 5
y = 10
-- Отображает сообщение
outputChatBox ( "I have " .. x .. " apples and " .. y .. " oranges." )
</syntaxhighlight>

'''Пример 2:''' В этом пример происходит вывод простого цветного текста "Красный Белый", где слово "Красный" красного цвета, а "Белый" - белого.
<syntaxhighlight lang="lua">
outputChatBox ( "Красный #FFFFFFБелый", getRootElement(), 255, 0, 0, true )
</syntaxhighlight>

'''Пример 3:''' Этот пример позволяет игрокам писать в чат текстом того же цвета, что и их ник.
<syntaxhighlight lang="lua">
function colouredChat ( message, theType )
if theType == 0 then --если это обычный чат, а не /me или командный
cancelEvent() --останавливаем встроенный в МТА вывод сообщения
message = string.gsub(message, "#%x%x%x%x%x%x", "") --убираем любые шестнадцатеричные метки с помощью функции string.gsub из lua
local r,g,b = getPlayerNametagColor ( source ) --выясняем, какого цвета ник игрока
local chatterName = getPlayerName ( source ) --выясняем имя
--выводим сообщение в чат, при этом ник игрока будет написан его цветом, а остальной текст белым
outputChatBox ( chatterName..":#FFFFFF "..message, getRootElement(), r, g, b, true )
end
end
</syntaxhighlight>

'''Пример 4:''' Пишем сообщение в чат игроку под ником ''someguy''.
<syntaxhighlight lang="lua">
-- Ищем игрока с именем 'someguy'
myPlayer = getPlayerFromNick ( "someguy" )
-- Если игрок с таким именем найден, то ...
if ( myPlayer ~= false ) then
x = 5
y = 10
-- отправляем ему в чат сообщение
outputChatBox ( "I have " .. x .. " apples and " .. y .. " oranges.", myPlayer )
end
</syntaxhighlight>

'''Пример 5:''' Этот пример позволяет.
<syntaxhighlight lang="lua">
function onJoin()
outputChatBox ("Добро пожаловать на сервер!", source)
end

addEventHandler("onPlayerJoin",getRootElement(),onJoin)
</syntaxhighlight>
</section>

==Смотрите также==
{{Server functions}}
[[en:outputChatBox]]