mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-12-27 19:09:47 +00:00
478 lines
16 KiB
C++
478 lines
16 KiB
C++
/* -*- 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 Communicator client 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):
|
|
* Mats Palmgren <mats.palmgren@bredband.net>
|
|
*
|
|
* 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 ***** */
|
|
#ifndef nsListControlFrame_h___
|
|
#define nsListControlFrame_h___
|
|
|
|
#ifdef DEBUG_evaughan
|
|
//#define DEBUG_rods
|
|
#endif
|
|
|
|
#ifdef DEBUG_rods
|
|
//#define DO_REFLOW_DEBUG
|
|
//#define DO_REFLOW_COUNTER
|
|
//#define DO_UNCONSTRAINED_CHECK
|
|
//#define DO_PIXELS
|
|
#endif
|
|
|
|
#include "nsGfxScrollFrame.h"
|
|
#include "nsIFormControlFrame.h"
|
|
#include "nsIListControlFrame.h"
|
|
#include "nsISelectControlFrame.h"
|
|
#include "nsIDOMEventListener.h"
|
|
#include "nsIContent.h"
|
|
#include "nsAutoPtr.h"
|
|
#include "nsSelectsAreaFrame.h"
|
|
|
|
class nsIDOMHTMLSelectElement;
|
|
class nsIDOMHTMLOptionsCollection;
|
|
class nsIDOMHTMLOptionElement;
|
|
class nsIComboboxControlFrame;
|
|
class nsPresContext;
|
|
class nsListEventListener;
|
|
|
|
/**
|
|
* Frame-based listbox.
|
|
*/
|
|
|
|
class nsListControlFrame : public nsHTMLScrollFrame,
|
|
public nsIFormControlFrame,
|
|
public nsIListControlFrame,
|
|
public nsISelectControlFrame
|
|
{
|
|
public:
|
|
friend nsIFrame* NS_NewListControlFrame(nsIPresShell* aPresShell, nsStyleContext* aContext);
|
|
|
|
NS_DECL_QUERYFRAME
|
|
NS_DECL_FRAMEARENA_HELPERS
|
|
|
|
// nsIFrame
|
|
NS_IMETHOD HandleEvent(nsPresContext* aPresContext,
|
|
nsGUIEvent* aEvent,
|
|
nsEventStatus* aEventStatus);
|
|
|
|
NS_IMETHOD SetInitialChildList(nsIAtom* aListName,
|
|
nsFrameList& aChildList);
|
|
|
|
virtual nscoord GetPrefWidth(nsIRenderingContext *aRenderingContext);
|
|
virtual nscoord GetMinWidth(nsIRenderingContext *aRenderingContext);
|
|
|
|
NS_IMETHOD Reflow(nsPresContext* aCX,
|
|
nsHTMLReflowMetrics& aDesiredSize,
|
|
const nsHTMLReflowState& aReflowState,
|
|
nsReflowStatus& aStatus);
|
|
|
|
NS_IMETHOD Init(nsIContent* aContent,
|
|
nsIFrame* aParent,
|
|
nsIFrame* aPrevInFlow);
|
|
|
|
NS_IMETHOD DidReflow(nsPresContext* aPresContext,
|
|
const nsHTMLReflowState* aReflowState,
|
|
nsDidReflowStatus aStatus);
|
|
virtual void DestroyFrom(nsIFrame* aDestructRoot);
|
|
|
|
NS_IMETHOD BuildDisplayList(nsDisplayListBuilder* aBuilder,
|
|
const nsRect& aDirtyRect,
|
|
const nsDisplayListSet& aLists);
|
|
|
|
virtual nsIFrame* GetContentInsertionFrame();
|
|
|
|
/**
|
|
* Get the "type" of the frame
|
|
*
|
|
* @see nsGkAtoms::scrollFrame
|
|
*/
|
|
virtual nsIAtom* GetType() const;
|
|
|
|
virtual PRBool IsFrameOfType(PRUint32 aFlags) const
|
|
{
|
|
return nsHTMLScrollFrame::IsFrameOfType(aFlags &
|
|
~(nsIFrame::eReplaced | nsIFrame::eReplacedContainsBlock));
|
|
}
|
|
|
|
virtual PRBool IsContainingBlock() const;
|
|
|
|
virtual void InvalidateInternal(const nsRect& aDamageRect,
|
|
nscoord aX, nscoord aY, nsIFrame* aForChild,
|
|
PRUint32 aFlags);
|
|
|
|
#ifdef DEBUG
|
|
NS_IMETHOD GetFrameName(nsAString& aResult) const;
|
|
#endif
|
|
|
|
// nsIFormControlFrame
|
|
virtual nsresult SetFormProperty(nsIAtom* aName, const nsAString& aValue);
|
|
virtual nsresult GetFormProperty(nsIAtom* aName, nsAString& aValue) const;
|
|
virtual void SetFocus(PRBool aOn = PR_TRUE, PRBool aRepaint = PR_FALSE);
|
|
|
|
virtual nsGfxScrollFrameInner::ScrollbarStyles GetScrollbarStyles() const;
|
|
virtual PRBool ShouldPropagateComputedHeightToScrolledContent() const;
|
|
|
|
// for accessibility purposes
|
|
#ifdef ACCESSIBILITY
|
|
NS_IMETHOD GetAccessible(nsIAccessible** aAccessible);
|
|
#endif
|
|
|
|
// nsHTMLContainerFrame
|
|
virtual PRIntn GetSkipSides() const;
|
|
|
|
// nsIListControlFrame
|
|
virtual void SetComboboxFrame(nsIFrame* aComboboxFrame);
|
|
virtual PRInt32 GetSelectedIndex();
|
|
|
|
/**
|
|
* Gets the text of the currently selected item.
|
|
* If the there are zero items then an empty string is returned
|
|
* If there is nothing selected, then the 0th item's text is returned.
|
|
*/
|
|
virtual void GetOptionText(PRInt32 aIndex, nsAString & aStr);
|
|
|
|
virtual void CaptureMouseEvents(PRBool aGrabMouseEvents);
|
|
virtual nscoord GetHeightOfARow();
|
|
virtual PRInt32 GetNumberOfOptions();
|
|
virtual void SyncViewWithFrame();
|
|
virtual void AboutToDropDown();
|
|
|
|
/**
|
|
* @note This method might destroy |this|.
|
|
*/
|
|
virtual void AboutToRollup();
|
|
|
|
/**
|
|
* Dispatch a DOM onchange event synchroniously.
|
|
* @note This method might destroy |this|.
|
|
*/
|
|
virtual void FireOnChange();
|
|
|
|
/**
|
|
* Makes aIndex the selected option of a combobox list.
|
|
* @note This method might destroy |this|.
|
|
*/
|
|
virtual void ComboboxFinish(PRInt32 aIndex);
|
|
virtual void OnContentReset();
|
|
|
|
// nsISelectControlFrame
|
|
NS_IMETHOD AddOption(PRInt32 index);
|
|
NS_IMETHOD RemoveOption(PRInt32 index);
|
|
NS_IMETHOD DoneAddingChildren(PRBool aIsDone);
|
|
|
|
/**
|
|
* Gets the content (an option) by index and then set it as
|
|
* being selected or not selected.
|
|
*/
|
|
NS_IMETHOD OnOptionSelected(PRInt32 aIndex, PRBool aSelected);
|
|
NS_IMETHOD OnSetSelectedIndex(PRInt32 aOldIndex, PRInt32 aNewIndex);
|
|
|
|
// mouse event listeners (both might destroy |this|)
|
|
nsresult MouseDown(nsIDOMEvent* aMouseEvent);
|
|
nsresult MouseUp(nsIDOMEvent* aMouseEvent);
|
|
|
|
// mouse motion listeners
|
|
nsresult MouseMove(nsIDOMEvent* aMouseEvent);
|
|
nsresult DragMove(nsIDOMEvent* aMouseEvent);
|
|
|
|
// key listener (might destroy |this|)
|
|
nsresult KeyPress(nsIDOMEvent* aKeyEvent);
|
|
|
|
/**
|
|
* Returns the options collection for aContent, if any.
|
|
*/
|
|
static already_AddRefed<nsIDOMHTMLOptionsCollection>
|
|
GetOptions(nsIContent * aContent);
|
|
|
|
/**
|
|
* Returns the nsIDOMHTMLOptionElement for a given index
|
|
* in the select's collection.
|
|
*/
|
|
static already_AddRefed<nsIDOMHTMLOptionElement>
|
|
GetOption(nsIDOMHTMLOptionsCollection* aOptions, PRInt32 aIndex);
|
|
|
|
/**
|
|
* Returns the nsIContent object in the collection
|
|
* for a given index.
|
|
*/
|
|
static already_AddRefed<nsIContent>
|
|
GetOptionAsContent(nsIDOMHTMLOptionsCollection* aCollection,PRInt32 aIndex);
|
|
|
|
static void ComboboxFocusSet();
|
|
|
|
// Helper
|
|
PRBool IsFocused() { return this == mFocused; }
|
|
|
|
/**
|
|
* Function to paint the focus rect when our nsSelectsAreaFrame is painting.
|
|
* @param aPt the offset of this frame, relative to the rendering reference
|
|
* frame
|
|
*/
|
|
void PaintFocus(nsIRenderingContext& aRC, nsPoint aPt);
|
|
/**
|
|
* If this frame IsFocused(), invalidates an area that includes anything
|
|
* that PaintFocus will or could have painted --- basically the whole
|
|
* GetOptionsContainer, plus some extra stuff if there are no options. This
|
|
* must be called every time mEndSelectionIndex changes.
|
|
*/
|
|
void InvalidateFocus();
|
|
|
|
/**
|
|
* Function to calculate the height a row, for use with the "size" attribute.
|
|
* Can't be const because GetNumberOfOptions() isn't const.
|
|
*/
|
|
nscoord CalcHeightOfARow();
|
|
|
|
/**
|
|
* Function to ask whether we're currently in what might be the
|
|
* first pass of a two-pass reflow.
|
|
*/
|
|
PRBool MightNeedSecondPass() const {
|
|
return mMightNeedSecondPass;
|
|
}
|
|
|
|
void SetSuppressScrollbarUpdate(PRBool aSuppress) {
|
|
nsHTMLScrollFrame::SetSuppressScrollbarUpdate(aSuppress);
|
|
}
|
|
|
|
/**
|
|
* Return whether the list is in dropdown mode.
|
|
*/
|
|
PRBool IsInDropDownMode() const;
|
|
|
|
/**
|
|
* Dropdowns need views
|
|
*/
|
|
virtual PRBool NeedsView() { return IsInDropDownMode(); }
|
|
|
|
/**
|
|
* Frees statics owned by this class.
|
|
*/
|
|
static void Shutdown();
|
|
|
|
#ifdef ACCESSIBILITY
|
|
/**
|
|
* Post a custom DOM event for the change, so that accessibility can
|
|
* fire a native focus event for accessibility
|
|
* (Some 3rd party products need to track our focus)
|
|
*/
|
|
void FireMenuItemActiveEvent(); // Inform assistive tech what got focused
|
|
#endif
|
|
|
|
protected:
|
|
/**
|
|
* Updates the selected text in a combobox and then calls FireOnChange().
|
|
* Returns PR_FALSE if calling it destroyed |this|.
|
|
*/
|
|
PRBool UpdateSelection();
|
|
|
|
/**
|
|
* Returns whether the nsIDOMHTMLSelectElement supports
|
|
* multiple selection.
|
|
*/
|
|
PRBool GetMultiple(nsIDOMHTMLSelectElement* aSelect = nsnull) const;
|
|
|
|
/**
|
|
* Toggles (show/hide) the combobox dropdown menu.
|
|
* @note This method might destroy |this|.
|
|
*/
|
|
void DropDownToggleKey(nsIDOMEvent* aKeyEvent);
|
|
|
|
nsresult IsOptionDisabled(PRInt32 anIndex, PRBool &aIsDisabled);
|
|
nsresult ScrollToFrame(nsIContent * aOptElement);
|
|
nsresult ScrollToIndex(PRInt32 anIndex);
|
|
|
|
/**
|
|
* When the user clicks on the comboboxframe to show the dropdown
|
|
* listbox, they then have to move the mouse into the list. We don't
|
|
* want to process those mouse events as selection events (i.e., to
|
|
* scroll list items into view). So we ignore the events until
|
|
* the mouse moves below our border-inner-edge, when
|
|
* mItemSelectionStarted is set.
|
|
*
|
|
* @param aPoint relative to this frame
|
|
*/
|
|
PRBool IgnoreMouseEventForSelection(nsIDOMEvent* aEvent);
|
|
|
|
/**
|
|
* If the dropdown is showing and the mouse has moved below our
|
|
* border-inner-edge, then set mItemSelectionStarted.
|
|
*/
|
|
void UpdateInListState(nsIDOMEvent* aEvent);
|
|
void AdjustIndexForDisabledOpt(PRInt32 aStartIndex, PRInt32 &anNewIndex,
|
|
PRInt32 aNumOptions, PRInt32 aDoAdjustInc, PRInt32 aDoAdjustIncNext);
|
|
|
|
/**
|
|
* Resets the select back to it's original default values;
|
|
* those values as determined by the original HTML
|
|
*/
|
|
virtual void ResetList(PRBool aAllowScrolling);
|
|
|
|
nsListControlFrame(nsIPresShell* aShell, nsIDocument* aDocument, nsStyleContext* aContext);
|
|
virtual ~nsListControlFrame();
|
|
|
|
// Utility methods
|
|
nsresult GetSizeAttribute(PRInt32 *aSize);
|
|
nsIContent* GetOptionFromContent(nsIContent *aContent);
|
|
|
|
/**
|
|
* Sets the mSelectedIndex and mOldSelectedIndex from figuring out what
|
|
* item was selected using content
|
|
* @param aPoint the event point, in listcontrolframe coordinates
|
|
* @return NS_OK if it successfully found the selection
|
|
*/
|
|
nsresult GetIndexFromDOMEvent(nsIDOMEvent* aMouseEvent, PRInt32& aCurIndex);
|
|
|
|
/**
|
|
* For a given index it returns the nsIContent object
|
|
* from the select.
|
|
*/
|
|
already_AddRefed<nsIContent> GetOptionContent(PRInt32 aIndex) const;
|
|
|
|
/**
|
|
* For a given piece of content, it determines whether the
|
|
* content (an option) is selected or not.
|
|
* @return PR_TRUE if it is, PR_FALSE if it is NOT.
|
|
*/
|
|
PRBool IsContentSelected(nsIContent* aContent) const;
|
|
|
|
/**
|
|
* For a given index is return whether the content is selected.
|
|
*/
|
|
PRBool IsContentSelectedByIndex(PRInt32 aIndex) const;
|
|
|
|
PRBool IsOptionElement(nsIContent* aContent);
|
|
PRBool CheckIfAllFramesHere();
|
|
PRInt32 GetIndexFromContent(nsIContent *aContent);
|
|
PRBool IsLeftButton(nsIDOMEvent* aMouseEvent);
|
|
|
|
// guess at a row height based on our own style.
|
|
nscoord CalcFallbackRowHeight();
|
|
|
|
// CalcIntrinsicHeight computes our intrinsic height (taking the "size"
|
|
// attribute into account). This should only be called in non-dropdown mode.
|
|
nscoord CalcIntrinsicHeight(nscoord aHeightOfARow, PRInt32 aNumberOfOptions);
|
|
|
|
// Dropped down stuff
|
|
void SetComboboxItem(PRInt32 aIndex);
|
|
|
|
/**
|
|
* Method to reflow ourselves as a dropdown list. This differs from
|
|
* reflow as a listbox because the criteria for needing a second
|
|
* pass are different. This will be called from Reflow() as needed.
|
|
*/
|
|
nsresult ReflowAsDropdown(nsPresContext* aPresContext,
|
|
nsHTMLReflowMetrics& aDesiredSize,
|
|
const nsHTMLReflowState& aReflowState,
|
|
nsReflowStatus& aStatus);
|
|
|
|
// Selection
|
|
PRBool SetOptionsSelectedFromFrame(PRInt32 aStartIndex,
|
|
PRInt32 aEndIndex,
|
|
PRBool aValue,
|
|
PRBool aClearAll);
|
|
PRBool ToggleOptionSelectedFromFrame(PRInt32 aIndex);
|
|
PRBool SingleSelection(PRInt32 aClickedIndex, PRBool aDoToggle);
|
|
PRBool ExtendedSelection(PRInt32 aStartIndex, PRInt32 aEndIndex,
|
|
PRBool aClearAll);
|
|
PRBool PerformSelection(PRInt32 aClickedIndex, PRBool aIsShift,
|
|
PRBool aIsControl);
|
|
PRBool HandleListSelection(nsIDOMEvent * aDOMEvent, PRInt32 selectedIndex);
|
|
void InitSelectionRange(PRInt32 aClickedIndex);
|
|
|
|
nsSelectsAreaFrame* GetOptionsContainer() const {
|
|
return static_cast<nsSelectsAreaFrame*>(GetScrolledFrame());
|
|
}
|
|
|
|
nscoord HeightOfARow() {
|
|
return GetOptionsContainer()->HeightOfARow();
|
|
}
|
|
|
|
// Data Members
|
|
PRInt32 mStartSelectionIndex;
|
|
PRInt32 mEndSelectionIndex;
|
|
|
|
nsIComboboxControlFrame *mComboboxFrame;
|
|
PRInt32 mNumDisplayRows;
|
|
PRPackedBool mChangesSinceDragStart:1;
|
|
PRPackedBool mButtonDown:1;
|
|
// Has the user selected a visible item since we showed the
|
|
// dropdown?
|
|
PRPackedBool mItemSelectionStarted:1;
|
|
|
|
PRPackedBool mIsAllContentHere:1;
|
|
PRPackedBool mIsAllFramesHere:1;
|
|
PRPackedBool mHasBeenInitialized:1;
|
|
PRPackedBool mNeedToReset:1;
|
|
PRPackedBool mPostChildrenLoadedReset:1;
|
|
|
|
//bool value for multiple discontiguous selection
|
|
PRPackedBool mControlSelectMode:1;
|
|
|
|
// True if we're in the middle of a reflow and might need a second
|
|
// pass. This only happens for auto heights.
|
|
PRPackedBool mMightNeedSecondPass:1;
|
|
|
|
/**
|
|
* Set to aPresContext->HasPendingInterrupt() at the start of Reflow.
|
|
* Set to PR_FALSE at the end of DidReflow.
|
|
*/
|
|
PRPackedBool mHasPendingInterruptAtStartOfReflow:1;
|
|
|
|
// The last computed height we reflowed at if we're a combobox dropdown.
|
|
// XXXbz should we be using a subclass here? Or just not worry
|
|
// about the extra member on listboxes?
|
|
nscoord mLastDropdownComputedHeight;
|
|
|
|
// At the time of our last dropdown, the backstop color to draw in case we
|
|
// are translucent.
|
|
nscolor mLastDropdownBackstopColor;
|
|
|
|
nsRefPtr<nsListEventListener> mEventListener;
|
|
|
|
static nsListControlFrame * mFocused;
|
|
static nsString * sIncrementalString;
|
|
|
|
#ifdef DO_REFLOW_COUNTER
|
|
PRInt32 mReflowId;
|
|
#endif
|
|
|
|
private:
|
|
// for incremental typing navigation
|
|
static nsAString& GetIncrementalString ();
|
|
static DOMTimeStamp gLastKeyTime;
|
|
};
|
|
|
|
#endif /* nsListControlFrame_h___ */
|
|
|