Latest revision as of 09:24, 4 March 2011

Description

Displays a multi-lined text which can contain several HTML-tags. This should be put in a GuiScrollCtrl to avoid text being clipped and not being displayed.

GuiMLTextCtrl is also used for displaying hints when moving the mouse over a GuiControl.

Variables

allowcolorchars - boolean

allowedtags - string

alpha - float

deniedsound - string

disallowedtags - string

maxchars - integer

parsetags - boolean

syntaxhighlighting - boolean

text - string

wordwrap - boolean

[v6] plaintext - string

Functions

addtext(str, bool) - adds text, second parameter specifies if it should automatically reflow; reflowing also updates width, height and line count, but if you plan to call addtext() several times then it's better to not let it reflow immediatelly because it can be slow on large text

getcursorline() - returns integer

getline(int) - returns string

getlinecount() - returns integer

getlines() - returns object - array of lines

gettext() - returns string

reflow()

scrolltobottom()

scrolltotag(int)

scrolltotop()

setlines(obj)

settext(str)

Events

onCursorLineChanged(line) - the cursor has been moved to another line

onSelectedTag(tagid) - an image inside the control has been clicked (<img src=imagefile id=tagid>-tag)

onURL(url) - an url has been clicked (<a href=url>-tag)

onReflow(newwidth,newheight) - the size of the displayed text has been changed

Tags

The text of multi-line text controls can contain a few HTML-tags and Torque-tags, you can use both of those tag types to define colors and fonts or to include images. The Torque-tags (previously added for compatibility) will be disabled in some time in the future, so it's recommended to use plain HTML tags. Currently following tags are available:

HTML:

<a href=url> text </a> - when the user clicks on 'text' then a 
  web browser is opened for the specified url (actually it is just 
  calling controlname.onURL(url) and the script needs to call openurl(url) then)
<b> text </b> - draws text with bold font
<body bgcolor=colorname or #rrggbb background=imagename> - sets the background color or image
<br> - line break
<center> text </center> - centers the contained text
<font face=fontname size=textsize color=colorname or #rrggbb> text </font>
  - draws text with a special font, size and color; you only
  need to define one of those 3 attributes
<h1> text </h1> .. <h6> text <h6> - draws text as a head line (with bigger fonts)
<hr> - draws a horizontal line
<i> text </i> - draws text with italic font
<ignorelinebreaks> </ignorelinebreaks> - go into normal HTML mode where
  you need to insert <br> to do a linebreak
<img src=filename id=integer> - an image is displayed, you 
  can also specify a tagid if you want to get onSelectTag-events
  for this image
<p align=left/center/right> text </p> - sets the alignment of the 
  contained text
<span style="width=100; height=100;" id=integer> </span> - for 
  displaying a subpage, you can also specifiy an id for 
  onSelectTag-events; instead of <span> you can also use <div> tags
<ul type="disc" or "square" or "circle"><li>item</li><li></li></ol> - displays a list, each item is indented
<ol><li>item</li></ol> - like <ul>, but is numerating each list item

Torque:

<a:url> text </a> - when the user clicks on 'text' then 
  a web browser is opened for the specified url
<bitmap:filename> - an image is displayed
<color:rrggbb> - sets the color of the text (hexadecimal value)
<lmargin:pixels> - sets the left margin for the text
<lmargin%:percent> - sets the size of the left margin depending 
  on the width of the whole control
<linkcolor:rrggbb> - sets the color of links (the <a>-tag)
<linkcolorhl:rrggbb> - sets the highlighted color, when
  the user moves the mouse over a link
<just:left/center/right> - sets the alignment of the following text
<rmargin:pixels> - sets the right margin for the text
<rmargin%:percent> - sets the size of the right margin depending 
  on the width of the whole control
<sbreak> - line break
<spush> - switches to a new style (like <font>)
<spop> - switches back to the last saved style (like </font>)
<tab:tab1,tab2,..> - sets the position of where tabulators should
  be displayed if you have text like 'Apple \t Egg \t Chicken'
<tag:id> - inserts an invisible tag which can be used
  for the scrollToTag(id) function (beside image-tags)

text

..

text

- draws text as a head line (with bigger fonts)

- draws a horizontal line

text - draws text with italic font <ignorelinebreaks> </ignorelinebreaks> - go into normal HTML mode where

 you need to insert 
 to do a linebreak

<img src=filename id=integer> - an image is displayed, you

 can also specify a tagid if you want to get onSelectTag-events
 for this image

text

- sets the alignment of the

 contained text

- for

 displaying a subpage, you can also specifiy an id for

onSelectTag-events; instead of you can also use

Example

new GuiMLTextCtrl("Test_MultiLineText") {
  profile = GuiBlueMLTextProfile;
  x = 10;
  y = 10;
  width = 160;
  height = 60;
  text = "<font size=24><i>Multiline-<br>Text</i></font>";
}

Creation/Dev/Script/Client/GuiMLTextCtrl: Difference between revisions

Latest revision as of 09:24, 4 March 2011

Contents

Description

Variables

Functions

Events

Tags

text

Example

@@ Line 1: / Line 1: @@
-'''http://www.antiunixmad.com/'''
+[[Category:Scripting Reference]]
+Inherits [[Creation/Dev/Script/Client/GuiControl|GuiControl]].
-'''[[Viper]]'s [[Graal]] Issues.'''
+=Description=
-Hello everyone, as of late, many people have been attacking me on the issues and matters, trying to lie about things, bend the truth, and downright spin to make me and others of my cause look bad, in this text document i will discuss and lay to rest the issues that matter.
+[[Image:Guicontrol_multiline.png]]
-I have been involved [[Graal]] for over three years now, and i used to really like [[Graal]] and its admins alot, then slowly after about a year [[Graal]] and its admins went in a bad downward spiral, i still stuck with [[Graal]] in hopes [[Graal]] would pull itself out of this hole and [[Unixmad]] would go back to the right path, this however did not happen, instead [[Unixmad]] and even [[Stefan]] went fouler and lower than i could have imageined, First with fireing [[Pachuka]] and [[Fuitad]], two of the BEST [[Graal]] admins ever in my view for no other reason than disagreeing with his future plans, then if just fireing them was not bad enough, he threatend to sue them and kill they're families, this was so wrong and bad [[Fuitad]] even said he would punch [[Unixmad]] in the face for saying that if he met him in real life, but that was just the beginning of the downward spiral [[Unixmad]] foolishly invoked onto [[Graal]], he then blatantly STOLE a domain name [[Graal]].net from Owl Shimy which costed over 30$ US Dollars, and never gave it back to him and never paid him for the cost of the domain, he also threatend to sue Owl Shimy and kill his family although it was [[Unixmad]] which stole the domain from Owl Shimy, then around [[Graal]]1.3.1 he blocked off [[GServer]]s officially and threatend to sue anyone that ran the former [[GServer]]s, although they were released as "Freeware" and actually used to encourage people to use the [[GServer]]s, this was a blatant attempt to monopolise , threaten, and intemidate that players that actually helped [[Graal]] and supported him, he then made claims he copyrighted "[[Graal]]" and would contact so called "Lawres" about anyone that used the name "[[Graal]]" or had "[[Graal]] Files" on there websites, although [[Graal]] was distributed as "Freeware" or "Shareware" and had no official software copyrights related to it, and that the name "[[Graal]]" was actually the name of a holy sacred golden cup used in some religion, and in that he has commited blasphemy against whatever religion has the so called "Holy [[Graal]]", then later on [[Unixmad]] fired SuperNick, because of his country and his origion and called him an American Asian slut, this was the first sign of racism on the part of [[Unixmad]], towards [[Graal]]1.4.1 [[Unixmad]] was secretly unwrapping his sadistic plans, he then started claiming credit and claiming to own the copyrights to [[Graal]], although [[Unixmad]] has done nothing but host some stupid weak as servers, and yet [[Stefan]] Knorr has done all the real work for [[Graal]], and was the one to make ZeldaOnline , [[Graal]]Online in the first place and has written every bit of codeing for the [[Graal]] Client , [[GServer]], RC, ect, yet [[Unixmad]] the worthless pile of trash that he is steals all credit for [[Graal]], then in February 2001, [[Unixmad]] and Antago release [[Graal]]2001 and the start of the "Pay to Play" system, now i have no problem with the fact that it is pay to play, the issue is when you PAY for something you actually expect to get the worth while of your money in this product, but instead they got a shittily made level generated land that was 99% empty, the NPCs were and are laggy as hell, and there were no quests, and there is only two shitty things today for hearts that suck so much i refuse to even call them quests, and to add to that about 40% of everyone that paid and gave [[Unixmad]] there credit card number NEVER got the accounts they paid 27$ or more for, and those that did clearly got chumped out by a cheap peice of crap that aint worth paying for, it sucked so badly that most people played on [[Graal]] Classic still, even those that foolishly paid for pay to play accounts, and in an attempt to "FORCE" people to pay for a shitty product they do not want against they're will [[Unixmad]] hired "Tyhm" to deface and ruin [[Graal]]Classic in an attempt to make it buggier and less fun than even [[Graal]]2001, about this time i was disgusted with [[Unixmad]] and most of the other admins and decided to downright turn against [[Graal]] and for the most part stop playing the peice of crap in general. People starting getting angry, complaining, asking for help, and asking for refunds, of coarse [[Unixmad]] gave noone a cash refund, and simply deleted and banned "PAID ACCOUNTS" of those who complained, asked for help, or asked for a refund these are PAYING CUSTOMERS, they have the rights of basic service that they PAID for, [[Unixmad]] promises pay to play players a quality product and customer service, but instead gives them a grade F product and ripps off his customers and delete they're accounts that they PAID HIM money for, his excuse? Credit card fraud, when infact at least 90% of the people he bans for credit card fraud pay legitamately with there OWN credit cards or pay via paypal by check, and yet [[Unixmad]] has stolen and used others credit card numbers to buy things for himself on several occassions, he also claims he needs pay to play money to keep [[Graal]] alive and running, yet there has been evidence that he makes at least 90% profit out of the monies he gets, and that he uses illegal porn ad banners and illegal cookie style web tracking and giveing email adresses of the players and even phone numbers of every player to spam and telemarketting companies without there permission, he even keeps personal player info, includeing email, adress, and phone number on unsecure servers which have already been leaked out, such info about people should not be on a public webserver accessable to the internet in anyway, then after all that [[Unixmad]] starts banning african american people, asians, koreans, and or people with images of people of that race from the [[Graal]]2001 forums and [[Graal]] itself, yet again they are paying customers and this is another sickening act of racism on the part of [[Unixmad]] and [[Graal]]Online, and then even more disgusting is what [[Stefan]] posts on the [[Graal]]2001 forums, he makes several anti american, racist, pro terrorist, pro nazi, and pro taliban comments on that post and goes on and on several pages bashing americans, this post was offense, obcene, and disgusting to many people includeing myself . If all that does not make you sick to your stomache or dislike [[Unixmad]] yet, i am far from done, then [[Unixmad]] proceeds to illegally DDOS webservers of mafukie and make threats to him over the phone, and has phone assaulted me over 40 times a day between midnight and 5am, and has made threats to sue dozens of people, kill there families, and shut down innocent websites and servers, while hosting illegal stuff and doing illegal things himself with the use of his own wanadoo.fr servers, stuff which includes child porn, bestiality porn, DVD Piracy, DDOS Attacks, theft of copyrighted materials from gameing companies such as nintendo, Credit Card fraud, theft, spamming, phone harrassment, useage of illegal pirated corperate softwares, all this just to start the list of what [[Unixmad]]', [[Stefan]], and they're servers are doing 24/7 for nearly 4 years now , anyone that likes [[Unixmad]] or thinks he is a good person even after all this is clearly a fool, everything in this document is the truth and why i hate [[Unixmad]] so much, if you like [[Unixmad]] after all these sickening things he does, then you are no better than a KKK or Neo Nazi member and should go kill yourselfs, i do not tolerate facists, racists, or nazis, they are all bad people, and [[Unixmad]] is one of the worst of the worst, and no person with any morales could tolerate or support such a person like Stephane Portha or [[Stefan]] Knorr. The people that spin, lie and bend the truth in support of [[Unixmad]] will always exist, but i will always reveal the truth about [[Unixmad]], and EVERYTHING said in this document is true, despite what any assclowns try and say about this, and this supriseingly enough is only 1% of the bad things [[Unixmad]] has done, how some people even tolerate, none the less support such a bad person is beyond me... I fight against bad people like [[Unixmad]], why? Because unlike many others in this world i actually care about other people, and i will do everything in my power to stop [[Unixmad]] from hurting [[Graal]] or its innocent players, many say i want to destroy and kill [[Graal]], this is NOT true, i used to love [[Graal]], i only wish to stop [[Unixmad]]'s evil sadistic illegal actions and restore [[Graal]] to the great game it used to be when it was "for the players, by the players" , but if i have to destroy [[Graal]]Online in exchange to stop [[Unixmad]]'s tyranny, it will be regreteable, but sometimes some sacrifices have to be made for the greater good, lets just hope that [[Unixmad]] drops dead and that sacrifice never has to be made... I love [[Graal]] and lots of its players, and i wish to someday restore it to the grandness it once had, but bad people like [[Unixmad]] must be gotten rid of if that is to be achieved...
+Displays a multi-lined text which can contain several HTML-tags. This should be put in a [[Creation/Dev/Script/Client/GuiScrollCtrl|GuiScrollCtrl]] to avoid text being clipped and not being displayed.
+GuiMLTextCtrl is also used for displaying ''hint''s when moving the mouse over a [[Creation/Dev/Script/Client/GuiControl|GuiControl]].
+=Variables=
+allowcolorchars - boolean
+allowedtags - string
+alpha - float
+deniedsound - string
+disallowedtags - string
+maxchars - integer
+parsetags - boolean
+syntaxhighlighting - boolean
+text - string
+wordwrap - boolean
+[http://forums.graalonline.com/forums/showpost.php?p=1634469&postcount=1[v6]] plaintext - string
+=Functions=
+addtext(str, bool) - adds text, second parameter specifies if it should automatically reflow; reflowing also updates width, height and line count, but if you plan to call addtext() several times then it's better to not let it reflow immediatelly because it can be slow on large text
+getcursorline() - returns integer
+getline(int) - returns string
+getlinecount() - returns integer
+getlines() - returns object - array of lines
+gettext() - returns string
+reflow()
+scrolltobottom()
+scrolltotag(int)
+scrolltotop()
+setlines(obj)
+settext(str)
+=Events=
+onCursorLineChanged(line) - the cursor has been moved to another line
+onSelectedTag(tagid) - an image inside the control has been clicked (<img src=imagefile id=tagid>-tag)
+onURL(url) - an url has been clicked (<a href=url>-tag)
+onReflow(newwidth,newheight) - the size of the displayed text has been changed
+=Tags=
+The text of multi-line text controls can contain
+a few HTML-tags and Torque-tags, you can use both
+of those tag types to define colors and fonts
+or to include images. The Torque-tags (previously added for compatibility) will be disabled in some time in the future, so it's recommended to use plain HTML tags. Currently following tags are available:
+'''HTML:'''
+<pre>
+<a href=url> text </a> - when the user clicks on 'text' then a
+  web browser is opened for the specified url (actually it is just
+  calling controlname.onURL(url) and the script needs to call openurl(url) then)
+<b> text </b> - draws text with bold font
+<body bgcolor=colorname or #rrggbb background=imagename> - sets the background color or image
+<br> - line break
+<center> text </center> - centers the contained text
+<font face=fontname size=textsize color=colorname or #rrggbb> text </font>
+  - draws text with a special font, size and color; you only
+  need to define one of those 3 attributes
+<h1> text </h1> .. <h6> text <h6> - draws text as a head line (with bigger fonts)
+<hr> - draws a horizontal line
+<i> text </i> - draws text with italic font
+<ignorelinebreaks> </ignorelinebreaks> - go into normal HTML mode where
+  you need to insert <br> to do a linebreak
+<img src=filename id=integer> - an image is displayed, you
+  can also specify a tagid if you want to get onSelectTag-events
+  for this image
+<p align=left/center/right> text </p> - sets the alignment of the
+  contained text
+<span style="width=100; height=100;" id=integer> </span> - for
+  displaying a subpage, you can also specifiy an id for
+  onSelectTag-events; instead of <span> you can also use <div> tags
+<ul type="disc" or "square" or "circle"><li>item</li><li></li></ol> - displays a list, each item is indented
+<ol><li>item</li></ol> - like <ul>, but is numerating each list item
+</pre>
+'''Torque:'''
+<pre>
+<a:url> text </a> - when the user clicks on 'text' then
+  a web browser is opened for the specified url
+<bitmap:filename> - an image is displayed
+<color:rrggbb> - sets the color of the text (hexadecimal value)
+<lmargin:pixels> - sets the left margin for the text
+<lmargin%:percent> - sets the size of the left margin depending
+  on the width of the whole control
+<linkcolor:rrggbb> - sets the color of links (the <a>-tag)
+<linkcolorhl:rrggbb> - sets the highlighted color, when
+  the user moves the mouse over a link
+<just:left/center/right> - sets the alignment of the following text
+<rmargin:pixels> - sets the right margin for the text
+<rmargin%:percent> - sets the size of the right margin depending
+  on the width of the whole control
+<sbreak> - line break
+<spush> - switches to a new style (like <font>)
+<spop> - switches back to the last saved style (like </font>)
+<tab:tab1,tab2,..> - sets the position of where tabulators should
+  be displayed if you have text like 'Apple \t Egg \t Chicken'
+<tag:id> - inserts an invisible tag which can be used
+  for the scrollToTag(id) function (beside image-tags)
+</pre>
+<h1> text </h1> .. <h6> text <h6> - draws text as a head line (with bigger fonts)
+<hr> - draws a horizontal line
+<i> text </i> - draws text with italic font
+<ignorelinebreaks> </ignorelinebreaks> - go into normal HTML mode where
+  you need to insert <br> to do a linebreak
+<img src=filename id=integer> - an image is displayed, you
+  can also specify a tagid if you want to get onSelectTag-events
+  for this image
+<p align=left/center/right> text </p> - sets the alignment of the
+  contained text
+<span style="width=100; height=100;" id=integer> </span> - for
+  displaying a subpage, you can also specifiy an id for
+  onSelectTag-events; instead of <span> you can also use <div> tags
+<ul type="disc" or "square" or "circle"><li>item</li><li></li></ol> - displays a list, each item is indented
+<ol><li>item</li></ol> - like <ul>, but is numerating each list item
+</pre>
+'''Torque:'''
+<pre>
+<a:url> text </a> - when the user clicks on 'text' then
+  a web browser is opened for the specified url
+<bitmap:filename> - an image is displayed
+<color:rrggbb> - sets the color of the text (hexadecimal value)
+<lmargin:pixels> - sets the left margin for the text
+<lmargin%:percent> - sets the size of the left margin depending
+  on the width of the whole control
+<linkcolor:rrggbb> - sets the color of links (the <a>-tag)
+<linkcolorhl:rrggbb> - sets the highlighted color, when
+  the user moves the mouse over a link
+<just:left/center/right> - sets the alignment of the following text
+<rmargin:pixels> - sets the right margin for the text
+<rmargin%:percent> - sets the size of the right margin depending
+  on the width of the whole control
+<sbreak> - line break
+<spush> - switches to a new style (like <font>)
+<spop> - switches back to the last saved style (like </font>)
+<tab:tab1,tab2,..> - sets the position of where tabulators should
+  be displayed if you have text like 'Apple \t Egg \t Chicken'
+<tag:id> - inserts an invisible tag which can be used
+  for the scrollToTag(id) function (beside image-tags)
+</pre>
+=Example=
+<pre>
+new GuiMLTextCtrl("Test_MultiLineText") {
+  profile = GuiBlueMLTextProfile;
+  x = 10;
+  y = 10;
+  width = 160;
+  height = 60;
+  text = "<font size=24><i>Multiline-<br>Text</i></font>";
+}
+</pre>