WoW:API MessageFrame AddMessage: Difference between revisions
Jump to navigation
Jump to search
MessageFrame:AddMessage -Documentation by Jason Citron, Additions by Dan Yankowsky, Fixes by Beladona-
({{widgetmethod}}) |
No edit summary |
||
| Line 6: | Line 6: | ||
Outputs text to a MessageFrame in the specified color, for a specified amount of time. | Outputs text to a MessageFrame in the specified color, for a specified amount of time. | ||
MessageFrame:AddMessage("text", red, green, blue, | MessageFrame:AddMessage("text", red, green, blue, messageId, holdTime); | ||
---- | ---- | ||
;''Arguments'' | ;''Arguments'' | ||
:(String text, Number red, Number green, Number blue, Number | :(String text, Number red, Number green, Number blue, Number messageId, Number holdTime) | ||
:;text : The message to output | :;text : The message to output | ||
| Line 17: | Line 17: | ||
:;green : The intensity of the green component. A clamped float between 0.0 and 1.0 | :;green : The intensity of the green component. A clamped float between 0.0 and 1.0 | ||
:;blue : The intensity of the blue component. A clamped float between 0.0 and 1.0 | :;blue : The intensity of the blue component. A clamped float between 0.0 and 1.0 | ||
:; | :;messageId : A user-defined number that specifies which "color group" this message fits into | ||
:;holdTime : length of time before the message fades out from the frame, in seconds | :;holdTime : length of time before the message fades out from the frame, in seconds | ||
| Line 27: | Line 27: | ||
---- | ---- | ||
;''Example'' | ;''Example'' | ||
UIErrorsFrame:AddMessage("Testing", 1.0, 0.0, 0.0, | UIErrorsFrame:AddMessage("Testing", 1.0, 0.0, 0.0, 53, 5); | ||
;''Result'' | ;''Result'' | ||
Testing -- in red, fades out after 5 seconds | Testing -- in red, fades out after 5 seconds, in message group 53 | ||
---- | ---- | ||
| Line 36: | Line 36: | ||
Any of the parameters after text are optional. The hold time should also be set however, otherwise the message will remain within the ScrollingMessageFrame until it is scrolled up past the lines specified in the frame, or until you exit the game. | Any of the parameters after text are optional. The hold time should also be set however, otherwise the message will remain within the ScrollingMessageFrame until it is scrolled up past the lines specified in the frame, or until you exit the game. | ||
If you call UpdateChatColor with messageId as an argument, you can change the color of a chat message dynamically. | |||
Revision as of 00:08, 30 May 2007
← Widget API ← MessageFrame < AddMessage
Outputs text to a MessageFrame in the specified color, for a specified amount of time.
MessageFrame:AddMessage("text", red, green, blue, messageId, holdTime);
- Arguments
- (String text, Number red, Number green, Number blue, Number messageId, Number holdTime)
- text
- The message to output
- red
- The intensity of the red component. A clamped float between 0.0 and 1.0
- green
- The intensity of the green component. A clamped float between 0.0 and 1.0
- blue
- The intensity of the blue component. A clamped float between 0.0 and 1.0
- messageId
- A user-defined number that specifies which "color group" this message fits into
- holdTime
- length of time before the message fades out from the frame, in seconds
- Returns
- nil
- Example
UIErrorsFrame:AddMessage("Testing", 1.0, 0.0, 0.0, 53, 5);
- Result
Testing -- in red, fades out after 5 seconds, in message group 53
- Description
Any of the parameters after text are optional. The hold time should also be set however, otherwise the message will remain within the ScrollingMessageFrame until it is scrolled up past the lines specified in the frame, or until you exit the game.
If you call UpdateChatColor with messageId as an argument, you can change the color of a chat message dynamically.