Difference between revisions of "LlTextBox"

From Second Life Wiki
Jump to: navigation, search
m
Line 10: Line 10:
 
|func_footnote
 
|func_footnote
 
|caveats
 
|caveats
|examples
+
|examples=<lsl>integer listener;
 +
 
 +
default
 +
{
 +
    touch_start(integer total_number)
 +
    {
 +
        integer channel = (integer)llFrand(-999.0)*-1;
 +
        listener = llListen(channel,"","","");
 +
        llTextBox(llDetectedKey(0),"Write something here...",channel);
 +
    }
 +
   
 +
    listen(integer channel, string name, key id, string message)
 +
    {
 +
        llSay(0,"You wrote: " + message);
 +
        llListenRemove(listener);
 +
    }
 +
}</lsl>
 
|spec
 
|spec
 
|constants
 
|constants

Revision as of 06:42, 24 May 2008

Summary

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

Shows a dialog box on avatar's screen with the text message. It 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 value
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

<lsl>integer listener;

default {

   touch_start(integer total_number)
   {
       integer channel = (integer)llFrand(-999.0)*-1;
       listener = llListen(channel,"","","");
       llTextBox(llDetectedKey(0),"Write something here...",channel);
   }
   
   listen(integer channel, string name, key id, string message)
   {
       llSay(0,"You wrote: " + message);
       llListenRemove(listener);
   }
}</lsl>

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 );