pjs/layout/base/nsPresContext.h

235 строки
7.6 KiB
C
Исходник Обычный вид История

1998-04-14 00:24:54 +04: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.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.
*/
#ifndef nsIPresContext_h___
#define nsIPresContext_h___
#include "nslayout.h"
#include "nsISupports.h"
#include "nsRect.h"
#include "nsColor.h"
1998-04-14 00:24:54 +04:00
1998-05-12 02:57:05 +04:00
struct nsFont;
class nsIContent;
class nsIDeviceContext;
class nsIFontMetrics;
class nsIFrame;
class nsIFrameImageLoader;
class nsIImageGroup;
1998-04-14 00:24:54 +04:00
class nsILinkHandler;
class nsIPresShell;
class nsIPref;
1998-04-14 00:24:54 +04:00
class nsIStyleContext;
1998-05-19 01:03:10 +04:00
class nsIAtom;
1998-04-14 00:24:54 +04:00
class nsString;
class nsIEventStateManager;
1998-09-05 07:51:16 +04:00
class nsIURL;
1998-04-14 00:24:54 +04: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-14 00:24:54 +04:00
// An interface for presentation contexts. Presentation contexts are
// objects that provide an outer context for a presentation shell.
class nsIPresContext : public nsISupports {
public:
/**
* Initialize the presentation context from a particular device.
*/
virtual nsresult Init(nsIDeviceContext* aDeviceContext, nsIPref* aPrefs) = 0;
1998-04-14 00:24:54 +04:00
/**
* Set the presentation shell that this context is bound to.
* A presentation context may only be bound to a single shell.
*/
virtual void SetShell(nsIPresShell* aShell) = 0;
/**
* Get the PresentationShell that this context is bound to.
*/
virtual nsIPresShell* GetShell() = 0;
/**
* Get a reference to the prefs API for this context
*/
NS_IMETHOD GetPrefs(nsIPref*& aPrefs) = 0;
/**
* Access compatibility mode for this context
*/
NS_IMETHOD GetCompatibilityMode(nsCompatibility& aMode) = 0;
NS_IMETHOD SetCompatibilityMode(nsCompatibility aMode) = 0;
1998-09-05 07:51:16 +04:00
/**
* Get base url for presentation
*/
NS_IMETHOD GetBaseURL(nsIURL*& aURL) = 0;
1998-04-14 00:24:54 +04:00
/**
* Resolve style for the given piece of content that will be a child
1998-05-19 01:03:10 +04:00
* of the aParentFrame frame. Don't use this for pseudo frames.
1998-04-14 00:24:54 +04:00
*/
virtual nsIStyleContext* ResolveStyleContextFor(nsIContent* aContent,
nsIFrame* aParentFrame,
PRBool aForceUnique = PR_FALSE) = 0;
1998-04-14 00:24:54 +04:00
1998-05-19 01:03:10 +04:00
/**
* Resolve style for a pseudo frame within the given aParentFrame frame.
* The tag should be uppercase and inclue the colon.
* ie: NS_NewAtom(":FIRST-LINE");
*/
virtual nsIStyleContext* ResolvePseudoStyleContextFor(nsIAtom* aPseudoTag,
nsIFrame* aParentFrame,
PRBool aForceUnique = PR_FALSE) = 0;
1998-05-19 01:03:10 +04:00
/**
* Probe style for a pseudo frame within the given aParentFrame frame.
* This will return nsnull id there are no explicit rules for the pseudo element.
* The tag should be uppercase and inclue the colon.
* ie: NS_NewAtom(":FIRST-LINE");
*/
virtual nsIStyleContext* ProbePseudoStyleContextFor(nsIAtom* aPseudoTag,
nsIFrame* aParentFrame,
PRBool aForceUnique = PR_FALSE) = 0;
1998-04-14 00:24:54 +04:00
/**
* Get the font metrics for a given font.
*/
virtual nsIFontMetrics* GetMetricsFor(const nsFont& aFont) = 0;
/**
* Get the default font
*/
virtual const nsFont& GetDefaultFont(void) = 0;
/**
* Get the default fixed pitch font
*/
virtual const nsFont& GetDefaultFixedFont(void) = 0;
1998-07-25 05:11:49 +04:00
/**
* Access Nav's magic font scaler value
*/
virtual PRInt32 GetFontScaler(void) = 0;
virtual void SetFontScaler(PRInt32 aScaler) = 0;
/**
* Get the defualt colors
*/
NS_IMETHOD GetDefaultColor(nscolor& aColor) = 0;
NS_IMETHOD GetDefaultBackgroundColor(nscolor& aColor) = 0;
1998-07-23 21:57:00 +04:00
NS_IMETHOD SetDefaultColor(const nscolor& aColor) = 0;
NS_IMETHOD SetDefaultBackgroundColor(const nscolor& aColor) = 0;
1998-05-12 02:57:05 +04:00
NS_IMETHOD GetImageGroup(nsIImageGroup*& aGroupResult) = 0;
1998-04-14 00:24:54 +04:00
/**
1998-05-12 02:57:05 +04: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-12 02:57:05 +04: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-14 00:24:54 +04:00
*/
NS_IMETHOD StartLoadImage(const nsString& aURL,
const nscolor* aBackgroundColor,
nsIFrame* aTargetFrame,
PRBool aNeedSizeUpdate,
nsIFrameImageLoader*& aLoader) = 0;
1998-04-14 00:24:54 +04:00
/**
* Stop any image loading being done on behalf of the argument frame.
*/
NS_IMETHOD StopLoadImage(nsIFrame* aForFrame) = 0;
1998-04-14 00:24:54 +04:00
NS_IMETHOD SetContainer(nsISupports* aContainer) = 0;
NS_IMETHOD GetContainer(nsISupports** aResult) = 0;
1998-07-13 23:49:07 +04:00
// XXX this are going to be replaced with set/get container
1998-04-14 00:24:54 +04:00
NS_IMETHOD SetLinkHandler(nsILinkHandler* aHandler) = 0;
NS_IMETHOD GetLinkHandler(nsILinkHandler** aResult) = 0;
/**
1998-07-13 23:49:07 +04: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-14 00:24:54 +04:00
*/
1998-05-22 22:27:48 +04:00
virtual void GetVisibleArea(nsRect& aResult) = 0;
1998-04-14 00:24:54 +04:00
/**
1998-07-13 23:49:07 +04:00
* Set the currently visible area. The units for r are standard
* nscoord units (as scaled by the device context).
1998-04-14 00:24:54 +04:00
*/
virtual void SetVisibleArea(const nsRect& r) = 0;
/**
* Return true if this presentation context is a paginated
* context.
*/
virtual PRBool IsPaginated() = 0;
/**
* Return the page width if this is a paginated context.
*/
virtual nscoord GetPageWidth() = 0;
/**
* Return the page height if this is a paginated context
*/
virtual nscoord GetPageHeight() = 0;
virtual float GetPixelsToTwips() const = 0;
virtual float GetTwipsToPixels() const = 0;
//be sure to Relase() after you are done with the Get()
virtual nsIDeviceContext * GetDeviceContext() const = 0;
NS_IMETHOD GetEventStateManager(nsIEventStateManager** aManager) = 0;
1998-04-14 00:24:54 +04: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-14 00:24:54 +04: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);
#endif /* nsIPresContext_h___ */