WoW:API GetInboxHeaderInfo: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
(Added note that GetInboxText marks an item as read)
Line 29: Line 29:
==Notes==
==Notes==
This function may be called from anywhere in the world, but will only be current as of the last time [[API_CheckInbox|CheckInbox()]] was called.
This function may be called from anywhere in the world, but will only be current as of the last time [[API_CheckInbox|CheckInbox()]] was called.
Details of an Auction House message can be extracted with [[API_GetInboxInvoiceInfo|GetInboxInvoiceInfo()]].

Revision as of 05:39, 3 November 2007

WoW API < GetInboxHeaderInfo

Returns information about an item in the mailbox.

packageIcon, stationeryIcon, sender, subject, money, CODAmount, daysLeft, hasItem, wasRead, wasReturned, 
textCreated, canReply, isGM = GetInboxHeaderInfo(index);

Parameters

Arguments

index
Number - the index of the message (1 is the first message)

Returns

packageIcon
String - texture path for package icon if it contains a package (nil otherwise)
stationeryIcon
String - texture path for mail message icon.
sender
String - name of the player who sent the message.
subject
String - the message subject
money
Number - The amount of money attached
CODAmount
Number - The amount of COD payment required to receive the package
daysLeft
Number - The number of days (fractional) before the message expires
hasItem
Flag - 1 if the mail still has an item in it, nil otherwise
wasRead
Flag - 1 if the mail has been read, nil otherwise. Using GetInboxText() marks an item as read.
wasReturned
Flag - 1 if the mail was returned, nil otherwise
textCreated
Flag - 1 if a letter object has been created from this mail, nil otherwise
canReply
Flag - 1 if this letter can be replied to, nil otherwise
isGM
Flag - 1 if this letter was sent by a GameMaster

Example

local packageTexture = GetInboxHeaderInfo(1);

Result

packageTexture is "Interface\Icons\INV_Scroll_03.blp"

Notes

This function may be called from anywhere in the world, but will only be current as of the last time CheckInbox() was called.

Details of an Auction House message can be extracted with GetInboxInvoiceInfo().