Difference between revisions of "LlTextBox"

From Second Life Wiki
Jump to: navigation, search
m
m (forgot to set the parameter name ^_^;)
Line 1: Line 1:
{{LSL_Function/avatar|avatar|sim=*}}{{LSL_Function
+
{{LSL_Function/avatar|avatar|sim=*}}{{LSL_Function/chat|channel}}{{LSL_Function
 
|func_id=335|func_sleep=1.0|func_energy=10.0
 
|func_id=335|func_sleep=1.0|func_energy=10.0
 
|func=llTextBox
 
|func=llTextBox
 
|p1_type=key|p1_name=avatar|p1_desc
 
|p1_type=key|p1_name=avatar|p1_desc
 
|p2_type=string|p2_name=message|p2_desc=Text to display in the message box
 
|p2_type=string|p2_name=message|p2_desc=Text to display in the message box
|p3_type=integer|p3_name=action|p3_desc=Channel to chat on
+
|p3_type=integer|p3_name=channel|p3_desc=Channel to chat on
 
|return_type
 
|return_type
 
|return_text
 
|return_text
|func_desc=Shows a dialog box on '''avatar''''s screen with the text '''message'''. The dialog bog contains a text box for input, any text that is entered is chatted on '''chat_channel''' when the "OK" button is clicked.
+
|func_desc=Shows a dialog box on '''avatar''''s screen with the text '''message'''. The dialog bog contains a text box for input, any text that is entered is [[llSay|said]] on '''channel''' when the "OK" button is clicked.
 
|func_footnote
 
|func_footnote
 
|caveats
 
|caveats

Revision as of 19:53, 23 May 2008

Summary

Function: llTextBox( key avatar, string message, integer channel );

Shows a dialog box on avatar's screen with the text message. The dialog bog contains a text box for input, any text that is entered is said on channel when the "OK" button is clicked.

• key avatar avatar UUID that is in the same region
• string message Text to display in the message box
• integer channel output chat channel, any integer valueChannel to chat on
Channel Constant Description
DEBUG_CHANNEL 0x7FFFFFFF Chat channel reserved for script debugging and error messages, broadcasts to all nearby users.
PUBLIC_CHANNEL 0x0 Chat channel that broadcasts to all nearby users. This channel is sometimes referred to as: open chat, local chat and public chat.
Channel Constant Description
DEBUG_CHANNEL 0x7FFFFFFF Chat channel reserved for script debugging and error messages, broadcasts to all nearby users.
PUBLIC_CHANNEL 0x0 Chat channel that broadcasts to all nearby users. This channel is sometimes referred to as: open chat, local chat and public chat.

Caveats

  • This function causes the script to sleep for 1.0 seconds.
  • Messages sent on channel zero[1] and DEBUG_CHANNEL are throttled to a rate of <200/10sec, per region, per owner/user.
    • Once the rate is exceeded, all following messages on channel zero or DEBUG_CHANNEL will be dropped until the send rate is again below 200/10sec for the previous 10 sec. Dropped messages, despite being dropped still count against the limit.
All Issues ~ Search JIRA for related Bugs

Examples

See Also

Events

•  listen

Functions

•  llDialog
•  llListen
•  llSay
•  llWhisper
•  llShout
•  llRegionSay

Deep Notes

History

Search JIRA for related Issues

Footnotes

  1. ^ Channel zero is also known as: PUBLIC_CHANNEL, open chat, local chat and public chat

Signature

function void llTextBox( key avatar, string message, integer channel );