gecko-dev/layout/base/nsPresContext.h

359 lines
12 KiB
C
Raw Normal View History

1998-04-13 20:24:54 +00:00
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
*
* The contents of this file are subject to the Netscape 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/NPL/
1998-04-13 20:24:54 +00:00
*
* 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.
1998-04-13 20:24:54 +00:00
*
* The Original Code is mozilla.org code.
*
* The Initial Developer of the Original Code is Netscape
1998-04-13 20:24:54 +00:00
* Communications Corporation. Portions created by Netscape are
* Copyright (C) 1998 Netscape Communications Corporation. All
* Rights Reserved.
*
* Contributor(s):
* IBM Corporation
*
* This Original Code has been modified by IBM Corporation.
* Modifications made by IBM described herein are
* Copyright (c) International Business Machines
* Corporation, 2000
*
* Modifications to Mozilla code or documentation
* identified per MPL Section 3.3
*
* Date Modified by Description of modification
* 03/20/2000 IBM Corp. BiDi - ability to change the default direction of the browser
*
1998-04-13 20:24:54 +00:00
*/
#ifndef nsIPresContext_h___
#define nsIPresContext_h___
#include "nslayout.h"
#include "nsISupports.h"
#include "nsRect.h"
#include "nsColor.h"
1998-09-26 18:36:59 +00:00
#include "nsIFrameImageLoader.h"
#include "nsILanguageAtom.h"
1998-04-13 20:24:54 +00:00
1998-05-11 22:57:05 +00:00
struct nsFont;
class nsIContent;
class nsIDocument;
1998-05-11 22:57:05 +00:00
class nsIDeviceContext;
class nsIFontMetrics;
class nsIFrame;
1999-04-13 21:48:49 +00:00
class nsIImage;
1998-05-11 22:57:05 +00:00
class nsIImageGroup;
1998-04-13 20:24:54 +00:00
class nsILinkHandler;
class nsIPresShell;
class nsIPref;
1998-04-13 20:24:54 +00:00
class nsIStyleContext;
1998-05-18 21:03:10 +00:00
class nsIAtom;
1998-04-13 20:24:54 +00:00
class nsString;
class nsIEventStateManager;
class nsIURI;
class nsILookAndFeel;
1998-04-13 20:24:54 +00:00
#define NS_IPRESCONTEXT_IID \
{ 0x0a5d12e0, 0x944e, 0x11d1, \
{0x93, 0x23, 0x00, 0x80, 0x5f, 0x8a, 0xdd, 0x32} }
enum nsCompatibility {
eCompatibility_Standard = 1,
eCompatibility_NavQuirks = 2
};
1998-04-13 20:24:54 +00:00
enum nsWidgetRendering {
eWidgetRendering_Native = 1,
eWidgetRendering_Gfx = 2,
eWidgetRendering_PartialGfx = 3
};
1999-08-06 05:11:39 +00:00
enum nsWidgetType {
eWidgetType_Button = 1,
eWidgetType_Checkbox = 2,
eWidgetType_Radio = 3,
eWidgetType_Text = 4
};
1998-04-13 20:24:54 +00:00
// An interface for presentation contexts. Presentation contexts are
// objects that provide an outer context for a presentation shell.
class nsIPresContext : public nsISupports {
public:
1999-04-30 08:59:11 +00:00
static const nsIID& GetIID() { static nsIID iid = NS_IPRESCONTEXT_IID; return iid; }
/**
* Initialize the presentation context from a particular device.
*/
NS_IMETHOD Init(nsIDeviceContext* aDeviceContext) = 0;
/**
* Stop the presentation in preperation for destruction.
*/
NS_IMETHOD Stop(void) = 0;
1998-04-13 20:24:54 +00:00
/**
* Set the presentation shell that this context is bound to.
* A presentation context may only be bound to a single shell.
*/
NS_IMETHOD SetShell(nsIPresShell* aShell) = 0;
1998-04-13 20:24:54 +00:00
/**
* Get the PresentationShell that this context is bound to.
*/
NS_IMETHOD GetShell(nsIPresShell** aResult) = 0;
1998-04-13 20:24:54 +00:00
/**
* Access compatibility mode for this context
*/
NS_IMETHOD GetCompatibilityMode(nsCompatibility* aModeResult) = 0;
NS_IMETHOD SetCompatibilityMode(nsCompatibility aMode) = 0;
/**
* Access the widget rendering mode for this context
*/
NS_IMETHOD GetWidgetRenderingMode(nsWidgetRendering* aModeResult) = 0;
NS_IMETHOD SetWidgetRenderingMode(nsWidgetRendering aMode) = 0;
/**
* Access the image animation mode for this context
*/
NS_IMETHOD GetImageAnimationMode(nsImageAnimation* aModeResult) = 0;
NS_IMETHOD SetImageAnimationMode(nsImageAnimation aMode) = 0;
/**
* Get look and feel object
*/
NS_IMETHOD GetLookAndFeel(nsILookAndFeel** aLookAndFeel) = 0;
1998-09-05 03:51:16 +00:00
/**
* Get base url for presentation
*/
NS_IMETHOD GetBaseURL(nsIURI** aURLResult) = 0;
1998-09-05 03:51:16 +00:00
1998-12-02 00:28:57 +00:00
/**
* Get medium of presentation
*/
NS_IMETHOD GetMedium(nsIAtom** aMediumResult) = 0;
1998-12-02 00:28:57 +00:00
/**
* Remap style from the root frame downwards, and reflow.
*/
NS_IMETHOD RemapStyleAndReflow(void) = 0;
1998-04-13 20:24:54 +00:00
/**
* Resolve style for the given piece of content that will be a child
* of the aParentContext. Don't use this for pseudo frames.
1998-04-13 20:24:54 +00:00
*/
NS_IMETHOD ResolveStyleContextFor(nsIContent* aContent,
nsIStyleContext* aParentContext,
PRBool aForceUnique,
nsIStyleContext** aResult) = 0;
1998-04-13 20:24:54 +00:00
1998-05-18 21:03:10 +00:00
/**
* Resolve style for a pseudo frame within the given aParentContent & aParentContext.
1999-02-12 06:19:07 +00:00
* The tag should be lowercase and inclue the colon.
* ie: NS_NewAtom(":first-line");
1998-05-18 21:03:10 +00:00
*/
NS_IMETHOD ResolvePseudoStyleContextFor(nsIContent* aParentContent,
nsIAtom* aPseudoTag,
nsIStyleContext* aParentContext,
PRBool aForceUnique,
nsIStyleContext** aResult) = 0;
1998-05-18 21:03:10 +00:00
/**
* Probe style for a pseudo frame within the given aParentContent & aParentContext.
1998-05-18 21:03:10 +00:00
* This will return nsnull id there are no explicit rules for the pseudo element.
1999-02-12 06:19:07 +00:00
* The tag should be lowercase and inclue the colon.
* ie: NS_NewAtom(":first-line");
1998-05-18 21:03:10 +00:00
*/
NS_IMETHOD ProbePseudoStyleContextFor(nsIContent* aParentContent,
nsIAtom* aPseudoTag,
nsIStyleContext* aParentContext,
PRBool aForceUnique,
nsIStyleContext** aResult) = 0;
1999-09-03 23:35:41 +00:00
/**
* For a given frame tree, get a new style context that is the equivalent
* but within a new parent
*/
NS_IMETHOD ReParentStyleContext(nsIFrame* aFrame,
nsIStyleContext* aNewParentContext) = 0;
1998-04-13 20:24:54 +00:00
/**
* Get the font metrics for a given font.
*/
NS_IMETHOD GetMetricsFor(const nsFont& aFont, nsIFontMetrics** aResult) = 0;
1998-04-13 20:24:54 +00:00
/** Get the default font */
NS_IMETHOD GetDefaultFont(nsFont& aResult) = 0;
/** Set the default font */
NS_IMETHOD SetDefaultFont(const nsFont& aFont) = 0;
virtual const nsFont& GetDefaultFontDeprecated() = 0;
1998-04-13 20:24:54 +00:00
/** Get the default fixed pitch font */
NS_IMETHOD GetDefaultFixedFont(nsFont& aResult) = 0;
/** Set the default fixed pitch font */
NS_IMETHOD SetDefaultFixedFont(const nsFont& aFont) = 0;
virtual const nsFont& GetDefaultFixedFontDeprecated() = 0;
1998-07-25 01:11:49 +00:00
/**
* Access Nav's magic font scaler value
*/
NS_IMETHOD GetFontScaler(PRInt32* aResult) = 0;
NS_IMETHOD SetFontScaler(PRInt32 aScaler) = 0;
1998-07-25 01:11:49 +00:00
/**
* Get the defualt colors
*/
NS_IMETHOD GetDefaultColor(nscolor* aColor) = 0;
NS_IMETHOD GetDefaultBackgroundColor(nscolor* aColor) = 0;
NS_IMETHOD GetDefaultBackgroundImage(nsString& aImage) = 0;
NS_IMETHOD GetDefaultBackgroundImageRepeat(PRUint8* aRepeat) = 0;
NS_IMETHOD GetDefaultBackgroundImageOffset(nscoord* aX, nscoord* aY) = 0;
NS_IMETHOD GetDefaultBackgroundImageAttachment(PRUint8* aRepeat) = 0;
NS_IMETHOD SetDefaultColor(nscolor aColor) = 0;
NS_IMETHOD SetDefaultBackgroundColor(nscolor aColor) = 0;
NS_IMETHOD SetDefaultBackgroundImage(const nsString& aImage) = 0;
NS_IMETHOD SetDefaultBackgroundImageRepeat(PRUint8 aRepeat) = 0;
NS_IMETHOD SetDefaultBackgroundImageOffset(nscoord aX, nscoord aY) = 0;
NS_IMETHOD SetDefaultBackgroundImageAttachment(PRUint8 aRepeat) = 0;
NS_IMETHOD GetImageGroup(nsIImageGroup** aGroupResult) = 0;
1998-05-11 22:57:05 +00:00
1998-04-13 20:24:54 +00:00
/**
1998-05-11 22:57:05 +00:00
* Load an image for the target frame. This call can be made
* repeated with only a single image ever being loaded. If
* aNeedSizeUpdate is PR_TRUE, then when the image's size is
1998-05-11 22:57:05 +00:00
* determined the target frame will be reflowed (via a
* ContentChanged notification on the presentation shell). When the
* image's data is ready for rendering the target frame's Paint()
* method will be invoked (via the ViewManager) so that the
* appropriate damage repair is done.
*
* @param aBackgroundColor - If the background color is NULL, a mask
* will be generated for transparent images. If the background
* color is non-NULL, it indicates the RGB value to be folded
* into the transparent areas of the image and no mask is created.
1998-04-13 20:24:54 +00:00
*/
NS_IMETHOD StartLoadImage(const nsString& aURL,
const nscolor* aBackgroundColor,
1999-04-13 21:48:49 +00:00
const nsSize* aDesiredSize,
nsIFrame* aTargetFrame,
1999-04-13 21:48:49 +00:00
nsIFrameImageLoaderCB aCallBack,
void* aClosure,
void* aKey,
1999-04-13 21:48:49 +00:00
nsIFrameImageLoader** aResult) = 0;
/**
* Stop a specific image load being done on behalf of the argument frame.
*/
NS_IMETHOD StopLoadImage(void* aKey,
1999-04-13 21:48:49 +00:00
nsIFrameImageLoader* aLoader) = 0;
1998-04-13 20:24:54 +00:00
/**
* Stop any image loading being done on behalf of the argument frame.
*/
NS_IMETHOD StopAllLoadImagesFor(nsIFrame* aTargetFrame, void* aKey) = 0;
1998-04-13 20:24:54 +00:00
NS_IMETHOD SetContainer(nsISupports* aContainer) = 0;
NS_IMETHOD GetContainer(nsISupports** aResult) = 0;
1998-07-13 19:49:07 +00:00
// XXX this are going to be replaced with set/get container
1998-04-13 20:24:54 +00:00
NS_IMETHOD SetLinkHandler(nsILinkHandler* aHandler) = 0;
NS_IMETHOD GetLinkHandler(nsILinkHandler** aResult) = 0;
/**
1998-07-13 19:49:07 +00:00
* Get the visible area associated with this presentation context.
* This is the size of the visiable area that is used for
* presenting the document. The returned value is in the standard
* nscoord units (as scaled by the device context).
1998-04-13 20:24:54 +00:00
*/
NS_IMETHOD GetVisibleArea(nsRect& aResult) = 0;
1998-04-13 20:24:54 +00:00
/**
1998-07-13 19:49:07 +00:00
* Set the currently visible area. The units for r are standard
* nscoord units (as scaled by the device context).
1998-04-13 20:24:54 +00:00
*/
NS_IMETHOD SetVisibleArea(const nsRect& r) = 0;
1998-04-13 20:24:54 +00:00
/**
* Return true if this presentation context is a paginated
* context.
*/
NS_IMETHOD IsPaginated(PRBool* aResult) = 0;
1998-04-13 20:24:54 +00:00
/**
* Return the page width if this is a paginated context.
*/
NS_IMETHOD GetPageWidth(nscoord* aResult) = 0;
1998-04-13 20:24:54 +00:00
/**
* Return the page height if this is a paginated context
*/
NS_IMETHOD GetPageHeight(nscoord* aResult) = 0;
NS_IMETHOD GetPixelsToTwips(float* aResult) const = 0;
1998-04-13 20:24:54 +00:00
NS_IMETHOD GetTwipsToPixels(float* aResult) const = 0;
1998-04-13 20:24:54 +00:00
1998-11-14 01:52:27 +00:00
//XXX this is probably not an ideal name. MMP
/**
* Do pixels to twips conversion taking into account
* differing size of a "pixel" from device to device.
*/
NS_IMETHOD GetScaledPixelsToTwips(float* aScale) const = 0;
1998-11-14 01:52:27 +00:00
1998-04-13 20:24:54 +00:00
//be sure to Relase() after you are done with the Get()
NS_IMETHOD GetDeviceContext(nsIDeviceContext** aResult) const = 0;
NS_IMETHOD GetEventStateManager(nsIEventStateManager** aManager) = 0;
NS_IMETHOD GetDefaultDirection(PRUint8* aDirection) = 0;
NS_IMETHOD SetDefaultDirection(PRUint8 aDirection) = 0;
NS_IMETHOD GetLanguage(nsILanguageAtom** aLanguage) = 0;
#ifdef MOZ_REFLOW_PERF
NS_IMETHOD CountReflows(const char * aName, PRUint32 aType) = 0;
#endif
1998-04-13 20:24:54 +00:00
};
// Bit values for StartLoadImage's aImageStatus
#define NS_LOAD_IMAGE_STATUS_ERROR 0x1
#define NS_LOAD_IMAGE_STATUS_SIZE 0x2
#define NS_LOAD_IMAGE_STATUS_BITS 0x4
1998-04-13 20:24:54 +00:00
// Factory method to create a "galley" presentation context (galley is
// a kind of view that has no limit to the size of a page)
extern NS_LAYOUT nsresult
NS_NewGalleyContext(nsIPresContext** aInstancePtrResult);
// Factory method to create a "paginated" presentation context for
// the screen.
extern NS_LAYOUT nsresult
NS_NewPrintPreviewContext(nsIPresContext** aInstancePtrResult);
// Factory method to create a "paginated" presentation context for
// printing
extern NS_LAYOUT nsresult
NS_NewPrintContext(nsIPresContext** aInstancePtrResult);
#ifdef MOZ_REFLOW_PERF
#define DO_GLOBAL_REFLOW_COUNT(_name, _type) \
aPresContext->CountReflows((_name), (_type));
#else
#define DO_GLOBAL_REFLOW_COUNT(_name, _type)
#endif // MOZ_REFLOW_PERF
1998-04-13 20:24:54 +00:00
#endif /* nsIPresContext_h___ */