PL/outputChatBox
Funkcja ta umożliwia wyświetlenie na czacie dowolnego ciągu znaków, mniejszego niż 128. Istnieje również możliwość zdefiniowania, dla kogo ta wiadomość ma być widoczna.
Przy korzystaniu z funkcji możemy dodatkowo ustalić, czy ma ona odczytywać zapis heksadecymedalny ('#RRGGBB'), dzięki któremu jesteśmy w stanie dowolnie pokolorować nasz tekst. Przykładowo:
outputChatBox ( "#FF0000Hello #00FF00World", getRootElement(), 255, 255, 255, true )
zostanie wyświetlone jako: Hello World
Składnia (syntax)
bool outputChatBox ( string text [, element visibleTo=getRootElement(), int r=231, int g=217, int b=176, bool colorCoded=false ] )
OOP Syntax Help! I don't understand this!
- Method: player:outputChat(...)
Wymagane argumenty
- text: Ciąg znaków, który zostanie wyświetlony na czacie. Jeżeli jednak jego długość przekroczy 128 znaków, wiadomość nie zostanie wysłana.
Opcjonalne argumenty
UWAGA: Kiedy korzystasz z opcjonalnych argumentów, musisz uzupełnić wszystkie argumenty przed tym, którego chcesz użyć. Aby uzyskać więcej informacji na ten temat, zajrzyj tutaj.
- visibleTo: Dzięki temu argumentowi, możesz zdecydować komu wyświetli się dana wiadomość (więcej informacji tutaj). Domyślnie false.
- r: Wartość koloru czerwonego w tekście. Domyślnie 231.
- g: Wartość koloru zielonego w tekście. Domyślnie 217.
- b: Wartość koloru niebieskiego w tekście. Domyślnie 176.
- colorCoded: Boolean decydujący o tym, czy tagi '#RRGGBB' mają być używane. Domyślnie false.
ⓘ Pamiętaj, że tagi '#RRGGBB' mogą składać się tylko z wielkich liter, więc małe litery nie będą akceptowane. Domyślna wartość RGB w tym przypadku to '#E7D9B0'.
bool outputChatBox ( string text [, int r=231, int g=217, int b=176, bool colorCoded=false ] )
Wymagane argumenty
- text: Ciąg znaków, który zostanie wyświetlony na czacie. Jeżeli jednak jego długość przekroczy 128 znaków, wiadomość nie zostanie wysłana.
Opcjonalne argumenty
UWAGA: Kiedy korzystasz z opcjonalnych argumentów, musisz uzupełnić wszystkie argumenty przed tym, którego chcesz użyć. Aby uzyskać więcej informacji na ten temat, zajrzyj tutaj.
- r: Wartość koloru czerwonego w tekście. Domyślnie 231.
- g: Wartość koloru zielonego w tekście. Domyślnie 217.
- b: Wartość koloru niebieskiego w tekście. Domyślnie 176.
- colorCoded: Boolean decydujący o tym, czy tagi '#RRGGBB' mają być używane. Domyślnie false.
ⓘ Pamiętaj, że tagi '#RRGGBB' mogą składać się tylko z wielkich liter, więc małe litery nie będą akceptowane. Domyślna wartość RGB w tym przypadku to '#E7D9B0'.
Wynik
Zwraca true jeśli wiadomość została pomyślnie wyświetlona. Zwraca false, jeżeli któryś z argumentów został nieprawidłowo wypełniony.
Przykłady
Przykład nr 1: Ten przykład wyświetla wiadomość wszystkim graczom na serwerze, przy czym nazwy kolorów mają swoje barwy.
outputChatBox ( "Czerwony #00FF00Zielony #0000FFNiebieski", getRootElement(), 255, 0, 0, true )
Przykład nr 2: Ten przykład wyświetla wiadomość graczowi o nicku "ktostam".
gracz = getPlayerFromName ( "ktostam" ) -- szukamy gracza o nicku "ktostam" if gracz then -- jeżeli go znaleźliśmy, kontynuujemy... outputChatBox ( "Cześć ktosiu!", gracz ) -- ...i wyświetlamy mu wiadomość end
Przykład nr 3: Ten przykład wyświetla wiadomość powitalną graczowi wchodzącemu na serwer.
function graczWchodziNaSerwer() outputChatBox ( "Witaj na serwerze!", source, 255, 0, 0 ) end addEventHandler ( "onPlayerJoin", root, graczWchodziNaSerwer )
Autor: GabWas, utworzono: 23:32 19 Lip 2016 (CEST)
Author: GabWas, created: 21:32 19 Jul 2016 (UTC)