tenfourfox/widget/nsIDatePicker.idl

82 lines
2.2 KiB
Plaintext

/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
*
* 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"
interface nsIURI;
interface nsIDOMWindow;
[scriptable, function, uuid(0d79adad-b244-49A5-9997-2a8cad93fc45)]
interface nsIDatePickerShownCallback : nsISupports
{
/**
* Callback which is called when a datepicker is shown and a result
* is returned.
*
* @param aResult One of returnOK, returnCancel
*/
void done(in short aResult);
};
[scriptable, uuid(9840d564-42c8-4d78-9a4d-71002343c919)]
interface nsIDatePicker : nsISupports
{
const short returnOK = 0; // User hit Ok, process selection
const short returnCancel = 1; // User hit cancel, ignore selection
/**
* Initialize the date picker widget. The date picker is not valid until this
* method is called.
*
* @param title The title for the file widget
*/
void init(in nsIDOMWindow parent, in AString title);
/**
* The date that should be suggested to the user as a default.
* The date is a string in YYYY-MM-DD format.
*
* @throws NS_ERROR_FAILURE on attempts to get
*/
attribute AString defaultDate;
/**
* The minimum date range. If null, there is no minimum date.
* The date is a string in YYYY-MM-DD format.
*
* @throws NS_ERROR_FAILURE on attempts to get
*/
attribute AString minDate;
/**
* The maximum date range. If null, there is no maximum date.
* The date is a string in YYYY-MM-DD format.
*
* @throws NS_ERROR_FAILURE on attempts to get
*/
attribute AString maxDate;
/**
* The selected date.
*
* @return Returns the date currently selected.
*/
readonly attribute AString selectedDate;
/**
* Show date dialog. The dialog is displayed modally.
*
* @return returnOK if the user selects OK, returnCancel if the user selects cancel
*/
[deprecated] short show();
/**
* Opens the date dialog asynchronously.
* The passed-in object's done method will be called upon completion.
*/
void open(in nsIDatePickerShownCallback aDatePickerShownCallback);
};