gecko-dev/cmd/macfe/gui/CRDFToolbarItem.h

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 *
 * The contents of this file are subject to the Netscape Public License
 * Version 1.0 (the "NPL"); you may not use this file except in
 * compliance with the NPL.  You may obtain a copy of the NPL at
 * http://www.mozilla.org/NPL/
 *
 * Software distributed under the NPL is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the NPL
 * for the specific language governing rights and limitations under the
 * NPL.
 *
 * The Initial Developer of this code under the NPL is Netscape
 * Communications Corporation.  Portions created by Netscape are
 * Copyright (C) 1998 Netscape Communications Corporation.  All Rights
 * Reserved.
 */

//
// Mike Pinkerton, Netscape Communications
//
// Interfaces for all the things that can go on a toolbar.
//
// CRDFToolbarItem - the base class for things that go on toolbars
// CRDFPushButton - a toolbar button
// CRDFSeparator - a separator bar
// CRDFURLBar - the url bar w/ proxy icon
//

#pragma once

#include "htrdf.h"
#include "CImageIconMixin.h"
#include "CDynamicTooltips.h"

class CToolbarButtonContextMenuAttachment;


//
// class CRDFToolbarItem
//
// The base class for things that go on toolbars. This is a virtual class
// and should never be instantiated by itself.
//
class CRDFToolbarItem
{
public:
	friend class CToolbarButtonContextMenuAttachment;
	
	struct placement
		/*
		*/
	{
		SDimension16	natural_size;
		SInt16				max_horizontal_shrink;	// min width is natural_size.width-max_horizontal_shrink
		bool					is_stretchable;		// can usefully grow, e.g., true for a text entry field
	};
	
		// Frame management routines
		// These MUST be implemented in every subclass. We do this so subclasses 
		// can inherit from the appropriate LView (such as LControl) w/out forcing
		// that decision into the base class.
	virtual void PutInside ( LView *inView, Boolean inOrient = true) = 0;
	virtual void ResizeFrameTo ( SInt16 inWidth, SInt16 inHeight, Boolean inRefresh ) = 0;
	virtual void PlaceInSuperFrameAt ( SInt32 inHoriz, SInt32 inVert, Boolean inRefresh ) = 0;
	virtual SDimension16 NaturalSize ( SDimension16 inAvail ) const = 0; // OBSOLETE
	virtual bool IsStretchy ( ) const { return false; }	// OBSOLETE
	virtual void GetPlacement( placement&, SDimension16 space_available ) const = 0;

		// Post-creation init routines
		// These are called AFTER the item has been placed inside its parent
		// toolbar. This is important because some items need to be part of
		// a window or need to walk up the view hierarchy to register themselves.
	virtual void HookUpToListeners ( ) { } ;
	virtual void FinishCreate ( ) ;

	
protected:

	HT_Resource HTNode ( ) { return mNode; }
	const HT_Resource HTNode ( ) const { return mNode; }
	
	virtual void AttachContextMenu ( ) { } ;

private:

	HT_Resource mNode;
	
		// don't instantiate one of these
	CRDFToolbarItem ( HT_Resource inNode ) ;
	virtual ~CRDFToolbarItem ( ) ;

		// items cannot be passed by value because they exist in 1-to-1 
		// correspondance with UI elements
	CRDFToolbarItem( const CRDFToolbarItem& );				// DON'T IMPLEMENT
	CRDFToolbarItem& operator=( const CRDFToolbarItem& );	// DON'T IMPLEMENT
	
}; // CRDFToolbarItem


//
// class CRDFPushButton
//
// It's a button, it's a slicer, it's a mulcher, it's a ....
//
class CRDFPushButton : public CRDFToolbarItem, public LControl, public CImageIconMixin,
						public CDynamicTooltipMixin
{
public:
	CRDFPushButton ( HT_Resource inNode ) ;
	virtual ~CRDFPushButton ( ) ;

		// returns how the buttons wants to display: icon only, icon & text, text only
		// based on the properties in HT.
	UInt32 CalcDisplayMode ( ) const;
	
	virtual void PutInside ( LView *inView, Boolean inOrient = true) { 
		LPane::PutInside(inView, inOrient);
	}
	virtual void ResizeFrameTo ( SInt16 inWidth, SInt16 inHeight, Boolean inRefresh ) {
		LPane::ResizeFrameTo(inWidth, inHeight, inRefresh);
	}
	virtual void PlaceInSuperFrameAt ( SInt32 inHoriz, SInt32 inVert, Boolean inRefresh ) {
		LPane::PlaceInSuperFrameAt(inHoriz, inVert, inRefresh);	
	}
	virtual SDimension16 NaturalSize ( SDimension16 inAvail ) const ;
	virtual void GetPlacement( placement&, SDimension16 space_available ) const ;

	virtual void HookUpToListeners ( ) ;

protected:

		// computations for drawing text and icon
	virtual void PrepareDrawButton ( ) ;
	virtual void CalcGraphicFrame ( ) ;
	virtual void CalcTitleFrame ( ) ;
	virtual void FinalizeDrawButton ( ) ;
	
		// handle actual drawing
	virtual void DrawSelf ( ) ;
	virtual void DrawButtonContent ( ) ;
	virtual void DrawButtonTitle ( ) ;
	virtual void DrawButtonGraphic ( ) ;
	virtual void DrawSelfDisabled ( ) ;
	virtual void DrawButtonOutline ( ) ;
	virtual void DrawButtonHilited ( ) ;
	virtual void EnableSelf ( ) ;
	virtual void DisableSelf ( ) ;
	
		// handle drawing icon as an image
	virtual void ImageIsReady ( ) ;
	virtual void DrawStandby ( const Point & inTopLeft, IconTransformType inTransform ) const ;

		// handle rollover feedback
	virtual void MouseEnter ( Point inPortPt, const EventRecord &inMacEvent) ;
	virtual void MouseWithin ( Point inPortPt, const EventRecord &inMacEvent);
	virtual void MouseLeave(void);
	virtual void AdjustCursorSelf( Point /*inPoint*/, const EventRecord& inEvent ) ;

		// handle control tracking
	virtual void HotSpotAction(short /* inHotSpot */, Boolean inCurrInside, Boolean inPrevInside) ;
	virtual void DoneTracking ( SInt16 inHotSpot, Boolean /* inGoodTrack */) ;
	virtual void HotSpotResult ( Int16 inHotSpot );
	virtual void ClickSelf( const SMouseDownEvent &inMouseDown ) ;
	
	bool IsMouseInFrame ( ) const { return mMouseInFrame; } ;
	void SetTrackInside(bool inInside) { mTrackInside = inInside; }
	bool IsTrackInside() const { return mTrackInside; }

		// calculate tooltip to display title
	virtual void FindTooltipForMouseLocation ( const EventRecord& inMacEvent,
												StringPtr outTip );
	
	virtual void AssignCommand ( ) ;
		// is this a special button like back/forward/reload or is it just a url
	bool IsCommandButton ( ) const ;
	bool IsIconAboveText ( ) const ;
		
private:

	UInt32 CalcAlignment ( UInt32 inTopAlignment, Uint32 inSideAlignment ) const;
	void AttachTooltip ( ) ;
	void AttachContextMenu ( ) ;
	void AttachPaneEnabler ( ) ;
	
	StRegion mButtonMask;
	Rect mCachedButtonFrame;
	Rect mCachedTitleFrame;
	Rect mCachedGraphicFrame;
	
	ResIDT mTitleTraitsID;
	UInt8 mCurrentMode;
	Int8 mGraphicPadPixels;
	Int8 mTitlePadPixels;
	Int8 mTitleAlignment;
	Int8 mGraphicAlignment;
	Uint8 mOvalWidth, mOvalHeight;

	bool mMouseInFrame;
	bool mTrackInside;
	
		// items cannot be passed by value because they exist in 1-to-1 
		// correspondance with UI elements
	CRDFPushButton( const CRDFPushButton& );				// DON'T IMPLEMENT
	CRDFPushButton& operator=( const CRDFPushButton& );		// DON'T IMPLEMENT
	
}; // CRDFToolbarItem


//
// class CRDFSeparator
//
// Draws a 3d-beveled vertical separator between portions of toolbars.
//
class CRDFSeparator : public CRDFToolbarItem, public LPane
{
public:
	CRDFSeparator ( HT_Resource inNode ) ;
	virtual ~CRDFSeparator ( ) ;

		// Frame management routines
	virtual void PutInside ( LView *inView, Boolean inOrient = true) { 
		LPane::PutInside(inView, inOrient); 
	}
	virtual void ResizeFrameTo ( SInt16 inWidth, SInt16 inHeight, Boolean inRefresh ) {
		LPane::ResizeFrameTo(inWidth, inHeight, inRefresh);
	}
	virtual void PlaceInSuperFrameAt ( SInt32 inHoriz, SInt32 inVert, Boolean inRefresh ) {
		LPane::PlaceInSuperFrameAt(inHoriz, inVert, inRefresh);	
	}
	virtual SDimension16 NaturalSize ( SDimension16 inAvail ) const ;
	virtual void GetPlacement( placement&, SDimension16 space_available ) const ;
	
	virtual void DrawSelf ( ) ;
	
private:
	// items cannot be passed by value because they exist in 1-to-1 correspondance
	// with UI elements
	CRDFSeparator( const CRDFSeparator& );				// DON'T IMPLEMENT
	CRDFSeparator& operator=( const CRDFSeparator& );	// DON'T IMPLEMENT
	
}; // CRDFToolbarItem


//
// class CRDFURLBar
//
// Our fabled url entry bar with page proxy icon.
//
class CRDFURLBar : public CRDFToolbarItem, public LView
{
public:
	CRDFURLBar ( HT_Resource inNode ) ;
	virtual ~CRDFURLBar ( ) ;

		// Frame management routines
	virtual void PutInside ( LView *inView, Boolean inOrient = true) { 
		LPane::PutInside(inView, inOrient); 
	}
	virtual void ResizeFrameTo ( SInt16 inWidth, SInt16 inHeight, Boolean inRefresh ) {
		LPane::ResizeFrameTo(inWidth, inHeight, inRefresh);
	}
	virtual void PlaceInSuperFrameAt ( SInt32 inHoriz, SInt32 inVert, Boolean inRefresh ) {
		LPane::PlaceInSuperFrameAt(inHoriz, inVert, inRefresh);	
	}
	virtual SDimension16 NaturalSize ( SDimension16 inAvail ) const ;
	virtual bool IsStretchy ( ) const ;
	virtual void GetPlacement( placement&, SDimension16 space_available ) const ;

	virtual void FinishCreate ( ) ;

private:

	void AttachContextMenu ( ) ;

	// items cannot be passed by value because they exist in 1-to-1 correspondance
	// with UI elements
	CRDFURLBar( const CRDFURLBar& );				// DON'T IMPLEMENT
	CRDFURLBar& operator=( const CRDFURLBar& );		// DON'T IMPLEMENT
	
}; // CRDFToolbarItem