mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-20 00:35:44 +00:00
99666eed8c
the printing of headers and footers. Printing of selection is implemented by the frames figuring out if they are in the selection and painting if they or not they they don't paint. This also only allows the printing of the first page of selections, alothough it is well documented where this is implemeted so it can be removed. Bugs 63426, 31218, 61075 r=dcone,kmcclusk,erik,buster sr=waterson
396 lines
13 KiB
C++
396 lines
13 KiB
C++
/* -*- 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/
|
|
*
|
|
* 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 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
|
|
*
|
|
*/
|
|
#ifndef nsIPresContext_h___
|
|
#define nsIPresContext_h___
|
|
|
|
#include "nslayout.h"
|
|
#include "nsISupports.h"
|
|
#include "nsRect.h"
|
|
#include "nsColor.h"
|
|
#include "nsIFrameImageLoader.h"
|
|
#include "nsILanguageAtom.h"
|
|
|
|
struct nsFont;
|
|
|
|
class nsIContent;
|
|
class nsIDocument;
|
|
class nsIDeviceContext;
|
|
class nsIFontMetrics;
|
|
class nsIFrame;
|
|
class nsIImage;
|
|
class nsIImageGroup;
|
|
class nsILinkHandler;
|
|
class nsIPresShell;
|
|
class nsIPref;
|
|
class nsIStyleContext;
|
|
class nsIAtom;
|
|
class nsString;
|
|
class nsIEventStateManager;
|
|
class nsIURI;
|
|
class nsILookAndFeel;
|
|
|
|
#define NS_IPRESCONTEXT_IID \
|
|
{ 0x0a5d12e0, 0x944e, 0x11d1, \
|
|
{0x93, 0x23, 0x00, 0x80, 0x5f, 0x8a, 0xdd, 0x32} }
|
|
|
|
enum nsCompatibility {
|
|
eCompatibility_Standard = 1,
|
|
eCompatibility_NavQuirks = 2
|
|
};
|
|
|
|
enum nsWidgetRendering {
|
|
eWidgetRendering_Native = 1,
|
|
eWidgetRendering_Gfx = 2,
|
|
eWidgetRendering_PartialGfx = 3
|
|
};
|
|
|
|
enum nsWidgetType {
|
|
eWidgetType_Button = 1,
|
|
eWidgetType_Checkbox = 2,
|
|
eWidgetType_Radio = 3,
|
|
eWidgetType_Text = 4
|
|
};
|
|
|
|
enum nsLanguageSpecificTransformType {
|
|
eLanguageSpecificTransformType_Unknown = -1,
|
|
eLanguageSpecificTransformType_None = 0,
|
|
eLanguageSpecificTransformType_Japanese,
|
|
eLanguageSpecificTransformType_Korean
|
|
};
|
|
|
|
// supported values for cached bool types
|
|
const PRUint32 kPresContext_UseDocumentColors = 0x01;
|
|
const PRUint32 kPresContext_UseDocumentFonts = 0x02;
|
|
const PRUint32 kPresContext_UnderlineLinks = 0x03;
|
|
|
|
// An interface for presentation contexts. Presentation contexts are
|
|
// objects that provide an outer context for a presentation shell.
|
|
class nsIPresContext : public nsISupports {
|
|
public:
|
|
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.
|
|
* @param aStopChrome PR_TRUE to stop chrome as well.
|
|
*/
|
|
NS_IMETHOD Stop(PRBool aStopChrome = PR_TRUE) = 0;
|
|
|
|
/**
|
|
* 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;
|
|
|
|
/**
|
|
* Get the PresentationShell that this context is bound to.
|
|
*/
|
|
NS_IMETHOD GetShell(nsIPresShell** aResult) = 0;
|
|
|
|
/**
|
|
* 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;
|
|
|
|
/**
|
|
* Get base url for presentation
|
|
*/
|
|
NS_IMETHOD GetBaseURL(nsIURI** aURLResult) = 0;
|
|
|
|
/**
|
|
* Get medium of presentation
|
|
*/
|
|
NS_IMETHOD GetMedium(nsIAtom** aMediumResult) = 0;
|
|
|
|
/**
|
|
* Remap style from the root frame downwards, and reflow.
|
|
*/
|
|
NS_IMETHOD RemapStyleAndReflow(void) = 0;
|
|
|
|
/**
|
|
* Resolve style for the given piece of content that will be a child
|
|
* of the aParentContext. Don't use this for pseudo frames.
|
|
*/
|
|
NS_IMETHOD ResolveStyleContextFor(nsIContent* aContent,
|
|
nsIStyleContext* aParentContext,
|
|
PRBool aForceUnique,
|
|
nsIStyleContext** aResult) = 0;
|
|
|
|
/**
|
|
* Resolve style for a pseudo frame within the given aParentContent & aParentContext.
|
|
* The tag should be lowercase and inclue the colon.
|
|
* ie: NS_NewAtom(":first-line");
|
|
*/
|
|
NS_IMETHOD ResolvePseudoStyleContextFor(nsIContent* aParentContent,
|
|
nsIAtom* aPseudoTag,
|
|
nsIStyleContext* aParentContext,
|
|
PRBool aForceUnique,
|
|
nsIStyleContext** aResult) = 0;
|
|
|
|
/**
|
|
* Probe style for a pseudo frame within the given aParentContent & aParentContext.
|
|
* This will return nsnull id there are no explicit rules for the pseudo element.
|
|
* The tag should be lowercase and inclue the colon.
|
|
* ie: NS_NewAtom(":first-line");
|
|
*/
|
|
NS_IMETHOD ProbePseudoStyleContextFor(nsIContent* aParentContent,
|
|
nsIAtom* aPseudoTag,
|
|
nsIStyleContext* aParentContext,
|
|
PRBool aForceUnique,
|
|
nsIStyleContext** aResult) = 0;
|
|
|
|
/**
|
|
* 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;
|
|
|
|
|
|
/**
|
|
* Get the font metrics for a given font.
|
|
*/
|
|
NS_IMETHOD GetMetricsFor(const nsFont& aFont, nsIFontMetrics** aResult) = 0;
|
|
|
|
/** 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;
|
|
|
|
/** 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;
|
|
|
|
/** Get a cached boolean pref, by its type
|
|
if the type is not supported, then NS_ERROR_FAILURE is returned
|
|
and the aValue argument is undfined, otherwise aValue is set
|
|
to the value of the boolean pref */
|
|
// * - initially created for bugs 31816, 20760, 22963
|
|
NS_IMETHOD GetCachedBoolPref(PRUint32 prefType, PRBool &aValue) = 0;
|
|
|
|
/**
|
|
* Access Nav's magic font scaler value
|
|
*/
|
|
NS_IMETHOD GetFontScaler(PRInt32* aResult) = 0;
|
|
NS_IMETHOD SetFontScaler(PRInt32 aScaler) = 0;
|
|
|
|
/**
|
|
* Get the default 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 GetDefaultLinkColor(nscolor* aColor) = 0;
|
|
NS_IMETHOD GetDefaultVisitedLinkColor(nscolor* aColor) = 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 SetDefaultLinkColor(nscolor aColor) = 0;
|
|
NS_IMETHOD SetDefaultVisitedLinkColor(nscolor aColor) = 0;
|
|
|
|
NS_IMETHOD GetImageGroup(nsIImageGroup** aGroupResult) = 0;
|
|
|
|
/**
|
|
* 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
|
|
* 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.
|
|
*/
|
|
NS_IMETHOD StartLoadImage(const nsString& aURL,
|
|
const nscolor* aBackgroundColor,
|
|
const nsSize* aDesiredSize,
|
|
nsIFrame* aTargetFrame,
|
|
nsIFrameImageLoaderCB aCallBack,
|
|
void* aClosure,
|
|
void* aKey,
|
|
nsIFrameImageLoader** aResult) = 0;
|
|
|
|
/**
|
|
* Stop a specific image load being done on behalf of the argument frame.
|
|
*/
|
|
NS_IMETHOD StopLoadImage(void* aKey,
|
|
nsIFrameImageLoader* aLoader) = 0;
|
|
|
|
/**
|
|
* Stop any image loading being done on behalf of the argument frame.
|
|
*/
|
|
NS_IMETHOD StopAllLoadImagesFor(nsIFrame* aTargetFrame, void* aKey) = 0;
|
|
|
|
NS_IMETHOD SetContainer(nsISupports* aContainer) = 0;
|
|
|
|
NS_IMETHOD GetContainer(nsISupports** aResult) = 0;
|
|
|
|
// XXX this are going to be replaced with set/get container
|
|
NS_IMETHOD SetLinkHandler(nsILinkHandler* aHandler) = 0;
|
|
NS_IMETHOD GetLinkHandler(nsILinkHandler** aResult) = 0;
|
|
|
|
/**
|
|
* 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).
|
|
*/
|
|
NS_IMETHOD GetVisibleArea(nsRect& aResult) = 0;
|
|
|
|
/**
|
|
* Set the currently visible area. The units for r are standard
|
|
* nscoord units (as scaled by the device context).
|
|
*/
|
|
NS_IMETHOD SetVisibleArea(const nsRect& r) = 0;
|
|
|
|
/**
|
|
* Return true if this presentation context is a paginated
|
|
* context.
|
|
*/
|
|
NS_IMETHOD IsPaginated(PRBool* aResult) = 0;
|
|
|
|
/**
|
|
* Return the page width if this is a paginated context.
|
|
*/
|
|
NS_IMETHOD GetPageWidth(nscoord* aResult) = 0;
|
|
|
|
/**
|
|
* Return the page height if this is a paginated context
|
|
*/
|
|
NS_IMETHOD GetPageHeight(nscoord* aResult) = 0;
|
|
|
|
NS_IMETHOD GetPixelsToTwips(float* aResult) const = 0;
|
|
|
|
NS_IMETHOD GetTwipsToPixels(float* aResult) const = 0;
|
|
|
|
//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;
|
|
|
|
//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;
|
|
|
|
/**
|
|
* Get the language-specific transform type for the current document.
|
|
* This tells us whether we need to perform special language-dependent
|
|
* transformations such as Unicode U+005C (backslash) to Japanese
|
|
* Yen Sign (Unicode U+00A5, JIS 0x5C).
|
|
*
|
|
* @param aType returns type, must be non-NULL
|
|
*/
|
|
NS_IMETHOD GetLanguageSpecificTransformType(
|
|
nsLanguageSpecificTransformType* aType) = 0;
|
|
|
|
/**
|
|
* Render only Selection
|
|
*/
|
|
NS_IMETHOD SetIsRenderingOnlySelection(PRBool aResult) = 0;
|
|
NS_IMETHOD IsRenderingOnlySelection(PRBool* aResult) = 0;
|
|
|
|
#ifdef MOZ_REFLOW_PERF
|
|
NS_IMETHOD CountReflows(const char * aName, PRUint32 aType) = 0;
|
|
#endif
|
|
};
|
|
|
|
// 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
|
|
|
|
// 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);
|
|
|
|
|
|
|
|
#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
|
|
|
|
#endif /* nsIPresContext_h___ */
|