gecko-dev/dom/telephony/nsIDOMVoicemailStatus.idl
2012-07-19 11:26:49 +08:00

51 lines
1.6 KiB
Plaintext

/* -*- Mode: c++; c-basic-offset: 2; indent-tabs-mode: nil; tab-width: 40 -*- */
/* vim: set ts=2 et sw=2 tw=40: */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
* You can obtain one at http://mozilla.org/MPL/2.0/. */
#include "nsISupports.idl"
[scriptable, uuid(8c58859a-e006-466a-ad76-b188ba0918ab)]
interface nsIDOMMozVoicemailStatus : nsISupports
{
/**
* There are voicemail messages waiting, but the count is unknown.
*/
const long MESSAGE_COUNT_UNKNOWN = -1;
/**
* Whether or not there are messages waiting in the voicemail box
*/
readonly attribute boolean hasMessages;
/**
* The total message count. Some voicemail indicators will only specify that
* messages are waiting, but not the actual number. In that case, the value
* of messageCount will be MESSAGE_COUNT_UNKNOWN (-1).
*
* Logic for a voicemail notification might look something like:
* if (status.hasMessages) {
* // show new voicemail notification
* if (status.messageCount > 0) {
* // add a label for the message count
* }
* } else {
* // hide the voicemail notification
* }
*/
readonly attribute long messageCount;
/**
* Return call number received for this voicemail status, or null if one
* wasn't provided.
*/
readonly attribute DOMString returnNumber;
/**
* Displayable return call message received for this voicemail status, or null
* if one wasn't provided.
*/
readonly attribute DOMString returnMessage;
};