mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-05 00:25:27 +00:00
174 lines
6.8 KiB
Plaintext
174 lines
6.8 KiB
Plaintext
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* ***** BEGIN LICENSE BLOCK *****
|
|
* Version: MPL 1.1/GPL 2.0/LGPL 2.1
|
|
*
|
|
* The contents of this file are subject to the Mozilla Public License Version
|
|
* 1.1 (the "License"); you may not use this file except in compliance with
|
|
* the License. You may obtain a copy of the License at
|
|
* http://www.mozilla.org/MPL/
|
|
*
|
|
* Software distributed under the License is distributed on an "AS IS" basis,
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
|
|
* for the specific language governing rights and limitations under the
|
|
* License.
|
|
*
|
|
* The Original Code is mozilla.org code.
|
|
*
|
|
* The Initial Developer of the Original Code is
|
|
* Netscape Communications Corporation.
|
|
* Portions created by the Initial Developer are Copyright (C) 1998
|
|
* the Initial Developer. All Rights Reserved.
|
|
*
|
|
* Contributor(s):
|
|
* David W. Hyatt <hyatt@netscape.com>
|
|
* Ben Goodger <ben@netscape.com>
|
|
*
|
|
* Alternatively, the contents of this file may be used under the terms of
|
|
* either of the GNU General Public License Version 2 or later (the "GPL"),
|
|
* or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
|
|
* in which case the provisions of the GPL or the LGPL are applicable instead
|
|
* of those above. If you wish to allow use of your version of this file only
|
|
* under the terms of either the GPL or the LGPL, and not to allow others to
|
|
* use your version of this file under the terms of the MPL, indicate your
|
|
* decision by deleting the provisions above and replace them with the notice
|
|
* and other provisions required by the GPL or the LGPL. If you do not delete
|
|
* the provisions above, a recipient may use your version of this file under
|
|
* the terms of any one of the MPL, the GPL or the LGPL.
|
|
*
|
|
* ***** END LICENSE BLOCK ***** */
|
|
|
|
#include "nsIBoxObject.idl"
|
|
|
|
interface nsIDOMElement;
|
|
|
|
[scriptable, uuid(88DC87BF-83EC-4F45-847A-E04C15DDA2FA)]
|
|
interface nsIPopupBoxObject : nsISupports
|
|
{
|
|
/**
|
|
* This method is deprecated. Use openPopup or openPopupAtScreen instead.
|
|
*/
|
|
void showPopup(in nsIDOMElement srcContent, in nsIDOMElement popupContent,
|
|
in long xpos, in long ypos,
|
|
in wstring popupType, in wstring anchorAlignment,
|
|
in wstring popupAlignment);
|
|
|
|
/**
|
|
* Hide the popup if it is open.
|
|
*/
|
|
void hidePopup();
|
|
|
|
/**
|
|
* Allow the popup to automatically position itself.
|
|
*/
|
|
attribute boolean autoPosition;
|
|
|
|
/**
|
|
* If keyboard navigation is enabled, the keyboard may be used to navigate
|
|
* the menuitems on the popup. Enabling keyboard navigation is the default
|
|
* behaviour and will install capturing key event listeners on the popup
|
|
* that do not propagate key events to the contents. If you wish to place
|
|
* elements in a popup which accept key events, such as textboxes, keyboard
|
|
* navigation should be disabled.
|
|
*
|
|
* Setting ignorekeys="true" on the popup element also disables keyboard
|
|
* navigation, and is recommended over calling this method.
|
|
*/
|
|
void enableKeyboardNavigator(in boolean enableKeyboardNavigator);
|
|
|
|
/**
|
|
* Enable automatic popup dismissal. This only has effect when called
|
|
* on an open popup.
|
|
*/
|
|
void enableRollup(in boolean enableRollup);
|
|
|
|
/**
|
|
* Control whether the event that caused the popup to be automatically
|
|
* dismissed ("rolled up") should be consumed, or dispatched as a
|
|
* normal event. This should be set immediately before calling showPopup()
|
|
* if non-default behavior is desired.
|
|
*/
|
|
const PRUint32 ROLLUP_DEFAULT = 0; /* widget/platform default */
|
|
const PRUint32 ROLLUP_CONSUME = 1; /* consume the rollup event */
|
|
const PRUint32 ROLLUP_NO_CONSUME = 2; /* don't consume the rollup event */
|
|
void setConsumeRollupEvent(in PRUint32 consume);
|
|
|
|
/**
|
|
* Size the popup to the given dimensions
|
|
*/
|
|
void sizeTo(in long width, in long height);
|
|
|
|
/**
|
|
* Move the popup to a point on screen in CSS pixels.
|
|
*/
|
|
void moveTo(in long left, in long top);
|
|
|
|
/**
|
|
* Open the popup relative to a specified node at a specific location.
|
|
*
|
|
* The popup may be either anchored to another node or opened freely.
|
|
* To anchor a popup to a node, supply an anchor node and set the position
|
|
* to a string indicating the manner in which the popup should be anchored.
|
|
* Possible values for position are:
|
|
* before_start, before_end, after_start, after_end,
|
|
* start_before, start_after, end_before, end_after,
|
|
* overlap, after_pointer
|
|
*
|
|
* The anchor node does not need to be in the same document as the popup.
|
|
*
|
|
* If the attributesOverride argument is true, the popupanchor, popupalign
|
|
* and position attributes on the popup node override the position value
|
|
* argument. If attributesOverride is false, the attributes are only used
|
|
* if position is empty.
|
|
*
|
|
* For an anchored popup, the x and y arguments may be used to offset the
|
|
* popup from its anchored position by some distance, measured in CSS pixels.
|
|
* x increases to the right and y increases down. Negative values may also
|
|
* be used to move to the left and upwards respectively.
|
|
*
|
|
* Unanchored popups may be created by supplying null as the anchor node.
|
|
* An unanchored popup appears at the position specified by x and y,
|
|
* relative to the viewport of the document containing the popup node. In
|
|
* this case, position and attributesOverride are ignored.
|
|
*
|
|
* @param anchorElement the node to anchor the popup to, may be null
|
|
* @param position manner is which to anchor the popup to node
|
|
* @param x horizontal offset
|
|
* @param y vertical offset
|
|
* @param isContextMenu true for context menus, false for other popups
|
|
* @param attributesOverride true if popup node attributes override position
|
|
*/
|
|
void openPopup(in nsIDOMElement anchorElement,
|
|
in AString position,
|
|
in long x, in long y,
|
|
in boolean isContextMenu,
|
|
in boolean attributesOverride);
|
|
|
|
/**
|
|
* Open the popup at a specific screen position specified by x and y. This
|
|
* position may be adjusted if it would cause the popup to be off of the
|
|
* screen. The x and y coordinates are measured in CSS pixels, and like all
|
|
* screen coordinates, are given relative to the top left of the primary
|
|
* screen.
|
|
*
|
|
* @param isContextMenu true for context menus, false for other popups
|
|
* @param x horizontal screen position
|
|
* @param y vertical screen position
|
|
*/
|
|
void openPopupAtScreen(in long x, in long y, in boolean isContextMenu);
|
|
|
|
/**
|
|
* Returns the state of the popup:
|
|
* closed - the popup is closed
|
|
* open - the popup is open
|
|
* showing - the popup is in the process of being shown
|
|
* hiding - the popup is in the process of being hidden
|
|
*/
|
|
readonly attribute AString popupState;
|
|
};
|
|
|
|
%{C++
|
|
nsresult
|
|
NS_NewPopupBoxObject(nsIBoxObject** aResult);
|
|
|
|
%}
|