win/include/content/nsISelection.h - chromium/deps/xulrunner-sdk - Git at Google

 /*
  * DO NOT EDIT.  THIS FILE IS GENERATED FROM e:/builds/tinderbox/XR-Trunk/WINNT_5.2_Depend/mozilla/content/base/public/nsISelection.idl
  */

 #ifndef __gen_nsISelection_h__
 #define __gen_nsISelection_h__


 #ifndef __gen_nsISupports_h__
 #include "nsISupports.h"
 #endif

 /* For IDL files that don't want to include root IDL files. */
 #ifndef NS_NO_VTABLE
 #define NS_NO_VTABLE
 #endif
 class nsIDOMNode; /* forward declaration */

 class nsIDOMRange; /* forward declaration */


 /* starting interface:    nsISelection */
 #define NS_ISELECTION_IID_STR "b2c7ed59-8634-4352-9e37-5484c8b6e4e1"

 #define NS_ISELECTION_IID \
   {0xb2c7ed59, 0x8634, 0x4352, \
     { 0x9e, 0x37, 0x54, 0x84, 0xc8, 0xb6, 0xe4, 0xe1 }}

 /**
  * Interface for manipulating and querying the current selected range
  * of nodes within the document.
  *
  * @status FROZEN
  * @version 1.0
  */
 class NS_NO_VTABLE NS_SCRIPTABLE nsISelection : public nsISupports {
  public:

   NS_DECLARE_STATIC_IID_ACCESSOR(NS_ISELECTION_IID)

   /**
      * Returns the node in which the selection begins.
      */
   /* readonly attribute nsIDOMNode anchorNode; */
   NS_SCRIPTABLE NS_IMETHOD GetAnchorNode(nsIDOMNode * *aAnchorNode) = 0;

   /**
      * The offset within the (text) node where the selection begins.
      */
   /* readonly attribute long anchorOffset; */
   NS_SCRIPTABLE NS_IMETHOD GetAnchorOffset(PRInt32 *aAnchorOffset) = 0;

   /**
      * Returns the node in which the selection ends.
      */
   /* readonly attribute nsIDOMNode focusNode; */
   NS_SCRIPTABLE NS_IMETHOD GetFocusNode(nsIDOMNode * *aFocusNode) = 0;

   /**
      * The offset within the (text) node where the selection ends.
      */
   /* readonly attribute long focusOffset; */
   NS_SCRIPTABLE NS_IMETHOD GetFocusOffset(PRInt32 *aFocusOffset) = 0;

   /**
      * Indicates if the selection is collapsed or not.
      */
   /* readonly attribute boolean isCollapsed; */
   NS_SCRIPTABLE NS_IMETHOD GetIsCollapsed(PRBool *aIsCollapsed) = 0;

   /**
      * Returns the number of ranges in the selection.
      */
   /* readonly attribute long rangeCount; */
   NS_SCRIPTABLE NS_IMETHOD GetRangeCount(PRInt32 *aRangeCount) = 0;

   /**
      * Returns the range at the specified index.
      */
   /* nsIDOMRange getRangeAt (in long index); */
   NS_SCRIPTABLE NS_IMETHOD GetRangeAt(PRInt32 index, nsIDOMRange **_retval) = 0;

   /**
      * Collapses the selection to a single point, at the specified offset
      * in the given DOM node. When the selection is collapsed, and the content
      * is focused and editable, the caret will blink there.
      * @param parentNode      The given dom node where the selection will be set
      * @param offset          Where in given dom node to place the selection (the offset into the given node)
      */
   /* void collapse (in nsIDOMNode parentNode, in long offset); */
   NS_SCRIPTABLE NS_IMETHOD Collapse(nsIDOMNode *parentNode, PRInt32 offset) = 0;

   /**
      * Extends the selection by moving the selection end to the specified node and offset,
      * preserving the selection begin position. The new selection end result will always
      * be from the anchorNode to the new focusNode, regardless of direction.
      * @param parentNode      The node where the selection will be extended to
      * @param offset          Where in node to place the offset in the new selection end
      */
   /* void extend (in nsIDOMNode parentNode, in long offset); */
   NS_SCRIPTABLE NS_IMETHOD Extend(nsIDOMNode *parentNode, PRInt32 offset) = 0;

   /**
      * Collapses the whole selection to a single point at the start
      * of the current selection (irrespective of direction).  If content
      * is focused and editable, the caret will blink there.
      */
   /* void collapseToStart (); */
   NS_SCRIPTABLE NS_IMETHOD CollapseToStart(void) = 0;

   /**
      * Collapses the whole selection to a single point at the end
      * of the current selection (irrespective of direction).  If content
      * is focused and editable, the caret will blink there.
      */
   /* void collapseToEnd (); */
   NS_SCRIPTABLE NS_IMETHOD CollapseToEnd(void) = 0;

   /**
      * Indicates whether the node is part of the selection. If partlyContained
      * is set to PR_TRUE, the function returns true when some part of the node
      * is part of the selection. If partlyContained is set to PR_FALSE, the
      * function only returns true when the entire node is part of the selection.
      */
   /* boolean containsNode (in nsIDOMNode node, in boolean partlyContained); */
   NS_SCRIPTABLE NS_IMETHOD ContainsNode(nsIDOMNode *node, PRBool partlyContained, PRBool *_retval) = 0;

   /**
      * Adds all children of the specified node to the selection.
      * @param parentNode  the parent of the children to be added to the selection.
      */
   /* void selectAllChildren (in nsIDOMNode parentNode); */
   NS_SCRIPTABLE NS_IMETHOD SelectAllChildren(nsIDOMNode *parentNode) = 0;

   /**
      * Adds a range to the current selection.
      */
   /* void addRange (in nsIDOMRange range); */
   NS_SCRIPTABLE NS_IMETHOD AddRange(nsIDOMRange *range) = 0;

   /**
      * Removes a range from the current selection.
      */
   /* void removeRange (in nsIDOMRange range); */
   NS_SCRIPTABLE NS_IMETHOD RemoveRange(nsIDOMRange *range) = 0;

   /**
      * Removes all ranges from the current selection.
      */
   /* void removeAllRanges (); */
   NS_SCRIPTABLE NS_IMETHOD RemoveAllRanges(void) = 0;

   /**
      * Deletes this selection from document the nodes belong to.
      */
   /* void deleteFromDocument (); */
   NS_SCRIPTABLE NS_IMETHOD DeleteFromDocument(void) = 0;

   /**
      * Modifies the cursor Bidi level after a change in keyboard direction
      * @param langRTL is PR_TRUE if the new language is right-to-left or
      *                PR_FALSE if the new language is left-to-right.
      */
   /* void selectionLanguageChange (in boolean langRTL); */
   NS_SCRIPTABLE NS_IMETHOD SelectionLanguageChange(PRBool langRTL) = 0;

   /**
      * Returns the whole selection into a plain text string.
      */
   /* wstring toString (); */
   NS_SCRIPTABLE NS_IMETHOD ToString(PRUnichar **_retval) = 0;

 };

   NS_DEFINE_STATIC_IID_ACCESSOR(nsISelection, NS_ISELECTION_IID)

 /* Use this macro when declaring classes that implement this interface. */
 #define NS_DECL_NSISELECTION \
   NS_SCRIPTABLE NS_IMETHOD GetAnchorNode(nsIDOMNode * *aAnchorNode); \
   NS_SCRIPTABLE NS_IMETHOD GetAnchorOffset(PRInt32 *aAnchorOffset); \
   NS_SCRIPTABLE NS_IMETHOD GetFocusNode(nsIDOMNode * *aFocusNode); \
   NS_SCRIPTABLE NS_IMETHOD GetFocusOffset(PRInt32 *aFocusOffset); \
   NS_SCRIPTABLE NS_IMETHOD GetIsCollapsed(PRBool *aIsCollapsed); \
   NS_SCRIPTABLE NS_IMETHOD GetRangeCount(PRInt32 *aRangeCount); \
   NS_SCRIPTABLE NS_IMETHOD GetRangeAt(PRInt32 index, nsIDOMRange **_retval); \
   NS_SCRIPTABLE NS_IMETHOD Collapse(nsIDOMNode *parentNode, PRInt32 offset); \
   NS_SCRIPTABLE NS_IMETHOD Extend(nsIDOMNode *parentNode, PRInt32 offset); \
   NS_SCRIPTABLE NS_IMETHOD CollapseToStart(void); \
   NS_SCRIPTABLE NS_IMETHOD CollapseToEnd(void); \
   NS_SCRIPTABLE NS_IMETHOD ContainsNode(nsIDOMNode *node, PRBool partlyContained, PRBool *_retval); \
   NS_SCRIPTABLE NS_IMETHOD SelectAllChildren(nsIDOMNode *parentNode); \
   NS_SCRIPTABLE NS_IMETHOD AddRange(nsIDOMRange *range); \
   NS_SCRIPTABLE NS_IMETHOD RemoveRange(nsIDOMRange *range); \
   NS_SCRIPTABLE NS_IMETHOD RemoveAllRanges(void); \
   NS_SCRIPTABLE NS_IMETHOD DeleteFromDocument(void); \
   NS_SCRIPTABLE NS_IMETHOD SelectionLanguageChange(PRBool langRTL); \
   NS_SCRIPTABLE NS_IMETHOD ToString(PRUnichar **_retval);

 /* Use this macro to declare functions that forward the behavior of this interface to another object. */
 #define NS_FORWARD_NSISELECTION(_to) \
   NS_SCRIPTABLE NS_IMETHOD GetAnchorNode(nsIDOMNode * *aAnchorNode) { return _to GetAnchorNode(aAnchorNode); } \
   NS_SCRIPTABLE NS_IMETHOD GetAnchorOffset(PRInt32 *aAnchorOffset) { return _to GetAnchorOffset(aAnchorOffset); } \
   NS_SCRIPTABLE NS_IMETHOD GetFocusNode(nsIDOMNode * *aFocusNode) { return _to GetFocusNode(aFocusNode); } \
   NS_SCRIPTABLE NS_IMETHOD GetFocusOffset(PRInt32 *aFocusOffset) { return _to GetFocusOffset(aFocusOffset); } \
   NS_SCRIPTABLE NS_IMETHOD GetIsCollapsed(PRBool *aIsCollapsed) { return _to GetIsCollapsed(aIsCollapsed); } \
   NS_SCRIPTABLE NS_IMETHOD GetRangeCount(PRInt32 *aRangeCount) { return _to GetRangeCount(aRangeCount); } \
   NS_SCRIPTABLE NS_IMETHOD GetRangeAt(PRInt32 index, nsIDOMRange **_retval) { return _to GetRangeAt(index, _retval); } \
   NS_SCRIPTABLE NS_IMETHOD Collapse(nsIDOMNode *parentNode, PRInt32 offset) { return _to Collapse(parentNode, offset); } \
   NS_SCRIPTABLE NS_IMETHOD Extend(nsIDOMNode *parentNode, PRInt32 offset) { return _to Extend(parentNode, offset); } \
   NS_SCRIPTABLE NS_IMETHOD CollapseToStart(void) { return _to CollapseToStart(); } \
   NS_SCRIPTABLE NS_IMETHOD CollapseToEnd(void) { return _to CollapseToEnd(); } \
   NS_SCRIPTABLE NS_IMETHOD ContainsNode(nsIDOMNode *node, PRBool partlyContained, PRBool *_retval) { return _to ContainsNode(node, partlyContained, _retval); } \
   NS_SCRIPTABLE NS_IMETHOD SelectAllChildren(nsIDOMNode *parentNode) { return _to SelectAllChildren(parentNode); } \
   NS_SCRIPTABLE NS_IMETHOD AddRange(nsIDOMRange *range) { return _to AddRange(range); } \
   NS_SCRIPTABLE NS_IMETHOD RemoveRange(nsIDOMRange *range) { return _to RemoveRange(range); } \
   NS_SCRIPTABLE NS_IMETHOD RemoveAllRanges(void) { return _to RemoveAllRanges(); } \
   NS_SCRIPTABLE NS_IMETHOD DeleteFromDocument(void) { return _to DeleteFromDocument(); } \
   NS_SCRIPTABLE NS_IMETHOD SelectionLanguageChange(PRBool langRTL) { return _to SelectionLanguageChange(langRTL); } \
   NS_SCRIPTABLE NS_IMETHOD ToString(PRUnichar **_retval) { return _to ToString(_retval); }

 /* Use this macro to declare functions that forward the behavior of this interface to another object in a safe way. */
 #define NS_FORWARD_SAFE_NSISELECTION(_to) \
   NS_SCRIPTABLE NS_IMETHOD GetAnchorNode(nsIDOMNode * *aAnchorNode) { return !_to ? NS_ERROR_NULL_POINTER : _to->GetAnchorNode(aAnchorNode); } \
   NS_SCRIPTABLE NS_IMETHOD GetAnchorOffset(PRInt32 *aAnchorOffset) { return !_to ? NS_ERROR_NULL_POINTER : _to->GetAnchorOffset(aAnchorOffset); } \
   NS_SCRIPTABLE NS_IMETHOD GetFocusNode(nsIDOMNode * *aFocusNode) { return !_to ? NS_ERROR_NULL_POINTER : _to->GetFocusNode(aFocusNode); } \
   NS_SCRIPTABLE NS_IMETHOD GetFocusOffset(PRInt32 *aFocusOffset) { return !_to ? NS_ERROR_NULL_POINTER : _to->GetFocusOffset(aFocusOffset); } \
   NS_SCRIPTABLE NS_IMETHOD GetIsCollapsed(PRBool *aIsCollapsed) { return !_to ? NS_ERROR_NULL_POINTER : _to->GetIsCollapsed(aIsCollapsed); } \
   NS_SCRIPTABLE NS_IMETHOD GetRangeCount(PRInt32 *aRangeCount) { return !_to ? NS_ERROR_NULL_POINTER : _to->GetRangeCount(aRangeCount); } \
   NS_SCRIPTABLE NS_IMETHOD GetRangeAt(PRInt32 index, nsIDOMRange **_retval) { return !_to ? NS_ERROR_NULL_POINTER : _to->GetRangeAt(index, _retval); } \
   NS_SCRIPTABLE NS_IMETHOD Collapse(nsIDOMNode *parentNode, PRInt32 offset) { return !_to ? NS_ERROR_NULL_POINTER : _to->Collapse(parentNode, offset); } \
   NS_SCRIPTABLE NS_IMETHOD Extend(nsIDOMNode *parentNode, PRInt32 offset) { return !_to ? NS_ERROR_NULL_POINTER : _to->Extend(parentNode, offset); } \
   NS_SCRIPTABLE NS_IMETHOD CollapseToStart(void) { return !_to ? NS_ERROR_NULL_POINTER : _to->CollapseToStart(); } \
   NS_SCRIPTABLE NS_IMETHOD CollapseToEnd(void) { return !_to ? NS_ERROR_NULL_POINTER : _to->CollapseToEnd(); } \
   NS_SCRIPTABLE NS_IMETHOD ContainsNode(nsIDOMNode *node, PRBool partlyContained, PRBool *_retval) { return !_to ? NS_ERROR_NULL_POINTER : _to->ContainsNode(node, partlyContained, _retval); } \
   NS_SCRIPTABLE NS_IMETHOD SelectAllChildren(nsIDOMNode *parentNode) { return !_to ? NS_ERROR_NULL_POINTER : _to->SelectAllChildren(parentNode); } \
   NS_SCRIPTABLE NS_IMETHOD AddRange(nsIDOMRange *range) { return !_to ? NS_ERROR_NULL_POINTER : _to->AddRange(range); } \
   NS_SCRIPTABLE NS_IMETHOD RemoveRange(nsIDOMRange *range) { return !_to ? NS_ERROR_NULL_POINTER : _to->RemoveRange(range); } \
   NS_SCRIPTABLE NS_IMETHOD RemoveAllRanges(void) { return !_to ? NS_ERROR_NULL_POINTER : _to->RemoveAllRanges(); } \
   NS_SCRIPTABLE NS_IMETHOD DeleteFromDocument(void) { return !_to ? NS_ERROR_NULL_POINTER : _to->DeleteFromDocument(); } \
   NS_SCRIPTABLE NS_IMETHOD SelectionLanguageChange(PRBool langRTL) { return !_to ? NS_ERROR_NULL_POINTER : _to->SelectionLanguageChange(langRTL); } \
   NS_SCRIPTABLE NS_IMETHOD ToString(PRUnichar **_retval) { return !_to ? NS_ERROR_NULL_POINTER : _to->ToString(_retval); }

 #if 0
 /* Use the code below as a template for the implementation class for this interface. */

 /* Header file */
 class nsSelection : public nsISelection
 {
 public:
   NS_DECL_ISUPPORTS
   NS_DECL_NSISELECTION

   nsSelection();

 private:
   ~nsSelection();

 protected:
   /* additional members */
 };

 /* Implementation file */
 NS_IMPL_ISUPPORTS1(nsSelection, nsISelection)

 nsSelection::nsSelection()
 {
   /* member initializers and constructor code */
 }

 nsSelection::~nsSelection()
 {
   /* destructor code */
 }

 /* readonly attribute nsIDOMNode anchorNode; */
 NS_IMETHODIMP nsSelection::GetAnchorNode(nsIDOMNode * *aAnchorNode)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* readonly attribute long anchorOffset; */
 NS_IMETHODIMP nsSelection::GetAnchorOffset(PRInt32 *aAnchorOffset)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* readonly attribute nsIDOMNode focusNode; */
 NS_IMETHODIMP nsSelection::GetFocusNode(nsIDOMNode * *aFocusNode)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* readonly attribute long focusOffset; */
 NS_IMETHODIMP nsSelection::GetFocusOffset(PRInt32 *aFocusOffset)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* readonly attribute boolean isCollapsed; */
 NS_IMETHODIMP nsSelection::GetIsCollapsed(PRBool *aIsCollapsed)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* readonly attribute long rangeCount; */
 NS_IMETHODIMP nsSelection::GetRangeCount(PRInt32 *aRangeCount)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* nsIDOMRange getRangeAt (in long index); */
 NS_IMETHODIMP nsSelection::GetRangeAt(PRInt32 index, nsIDOMRange **_retval)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* void collapse (in nsIDOMNode parentNode, in long offset); */
 NS_IMETHODIMP nsSelection::Collapse(nsIDOMNode *parentNode, PRInt32 offset)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* void extend (in nsIDOMNode parentNode, in long offset); */
 NS_IMETHODIMP nsSelection::Extend(nsIDOMNode *parentNode, PRInt32 offset)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* void collapseToStart (); */
 NS_IMETHODIMP nsSelection::CollapseToStart()
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* void collapseToEnd (); */
 NS_IMETHODIMP nsSelection::CollapseToEnd()
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* boolean containsNode (in nsIDOMNode node, in boolean partlyContained); */
 NS_IMETHODIMP nsSelection::ContainsNode(nsIDOMNode *node, PRBool partlyContained, PRBool *_retval)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* void selectAllChildren (in nsIDOMNode parentNode); */
 NS_IMETHODIMP nsSelection::SelectAllChildren(nsIDOMNode *parentNode)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* void addRange (in nsIDOMRange range); */
 NS_IMETHODIMP nsSelection::AddRange(nsIDOMRange *range)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* void removeRange (in nsIDOMRange range); */
 NS_IMETHODIMP nsSelection::RemoveRange(nsIDOMRange *range)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* void removeAllRanges (); */
 NS_IMETHODIMP nsSelection::RemoveAllRanges()
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* void deleteFromDocument (); */
 NS_IMETHODIMP nsSelection::DeleteFromDocument()
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* void selectionLanguageChange (in boolean langRTL); */
 NS_IMETHODIMP nsSelection::SelectionLanguageChange(PRBool langRTL)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* wstring toString (); */
 NS_IMETHODIMP nsSelection::ToString(PRUnichar **_retval)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* End of implementation class template. */
 #endif


 #endif /* __gen_nsISelection_h__ */
	/*
	* DO NOT EDIT. THIS FILE IS GENERATED FROM e:/builds/tinderbox/XR-Trunk/WINNT_5.2_Depend/mozilla/content/base/public/nsISelection.idl
	*/

	#ifndef __gen_nsISelection_h__
	#define __gen_nsISelection_h__


	#ifndef __gen_nsISupports_h__
	#include "nsISupports.h"
	#endif

	/* For IDL files that don't want to include root IDL files. */
	#ifndef NS_NO_VTABLE
	#define NS_NO_VTABLE
	#endif
	class nsIDOMNode; /* forward declaration */

	class nsIDOMRange; /* forward declaration */


	/* starting interface: nsISelection */
	#define NS_ISELECTION_IID_STR "b2c7ed59-8634-4352-9e37-5484c8b6e4e1"

	#define NS_ISELECTION_IID \
	{0xb2c7ed59, 0x8634, 0x4352, \
	{ 0x9e, 0x37, 0x54, 0x84, 0xc8, 0xb6, 0xe4, 0xe1 }}

	/**
	* Interface for manipulating and querying the current selected range
	* of nodes within the document.
	*
	* @status FROZEN
	* @version 1.0
	*/
	class NS_NO_VTABLE NS_SCRIPTABLE nsISelection : public nsISupports {
	public:

	NS_DECLARE_STATIC_IID_ACCESSOR(NS_ISELECTION_IID)

	/**
	* Returns the node in which the selection begins.
	*/
	/* readonly attribute nsIDOMNode anchorNode; */
	NS_SCRIPTABLE NS_IMETHOD GetAnchorNode(nsIDOMNode * *aAnchorNode) = 0;

	/**
	* The offset within the (text) node where the selection begins.
	*/
	/* readonly attribute long anchorOffset; */
	NS_SCRIPTABLE NS_IMETHOD GetAnchorOffset(PRInt32 *aAnchorOffset) = 0;

	/**
	* Returns the node in which the selection ends.
	*/
	/* readonly attribute nsIDOMNode focusNode; */
	NS_SCRIPTABLE NS_IMETHOD GetFocusNode(nsIDOMNode * *aFocusNode) = 0;

	/**
	* The offset within the (text) node where the selection ends.
	*/
	/* readonly attribute long focusOffset; */
	NS_SCRIPTABLE NS_IMETHOD GetFocusOffset(PRInt32 *aFocusOffset) = 0;

	/**
	* Indicates if the selection is collapsed or not.
	*/
	/* readonly attribute boolean isCollapsed; */
	NS_SCRIPTABLE NS_IMETHOD GetIsCollapsed(PRBool *aIsCollapsed) = 0;

	/**
	* Returns the number of ranges in the selection.
	*/
	/* readonly attribute long rangeCount; */
	NS_SCRIPTABLE NS_IMETHOD GetRangeCount(PRInt32 *aRangeCount) = 0;

	/**
	* Returns the range at the specified index.
	*/
	/* nsIDOMRange getRangeAt (in long index); */
	NS_SCRIPTABLE NS_IMETHOD GetRangeAt(PRInt32 index, nsIDOMRange **_retval) = 0;

	/**
	* Collapses the selection to a single point, at the specified offset
	* in the given DOM node. When the selection is collapsed, and the content
	* is focused and editable, the caret will blink there.
	* @param parentNode The given dom node where the selection will be set
	* @param offset Where in given dom node to place the selection (the offset into the given node)
	*/
	/* void collapse (in nsIDOMNode parentNode, in long offset); */
	NS_SCRIPTABLE NS_IMETHOD Collapse(nsIDOMNode *parentNode, PRInt32 offset) = 0;

	/**
	* Extends the selection by moving the selection end to the specified node and offset,
	* preserving the selection begin position. The new selection end result will always
	* be from the anchorNode to the new focusNode, regardless of direction.
	* @param parentNode The node where the selection will be extended to
	* @param offset Where in node to place the offset in the new selection end
	*/
	/* void extend (in nsIDOMNode parentNode, in long offset); */
	NS_SCRIPTABLE NS_IMETHOD Extend(nsIDOMNode *parentNode, PRInt32 offset) = 0;

	/**
	* Collapses the whole selection to a single point at the start
	* of the current selection (irrespective of direction). If content
	* is focused and editable, the caret will blink there.
	*/
	/* void collapseToStart (); */
	NS_SCRIPTABLE NS_IMETHOD CollapseToStart(void) = 0;

	/**
	* Collapses the whole selection to a single point at the end
	* of the current selection (irrespective of direction). If content
	* is focused and editable, the caret will blink there.
	*/
	/* void collapseToEnd (); */
	NS_SCRIPTABLE NS_IMETHOD CollapseToEnd(void) = 0;

	/**
	* Indicates whether the node is part of the selection. If partlyContained
	* is set to PR_TRUE, the function returns true when some part of the node
	* is part of the selection. If partlyContained is set to PR_FALSE, the
	* function only returns true when the entire node is part of the selection.
	*/
	/* boolean containsNode (in nsIDOMNode node, in boolean partlyContained); */
	NS_SCRIPTABLE NS_IMETHOD ContainsNode(nsIDOMNode node, PRBool partlyContained, PRBool _retval) = 0;

	/**
	* Adds all children of the specified node to the selection.
	* @param parentNode the parent of the children to be added to the selection.
	*/
	/* void selectAllChildren (in nsIDOMNode parentNode); */
	NS_SCRIPTABLE NS_IMETHOD SelectAllChildren(nsIDOMNode *parentNode) = 0;

	/**
	* Adds a range to the current selection.
	*/
	/* void addRange (in nsIDOMRange range); */
	NS_SCRIPTABLE NS_IMETHOD AddRange(nsIDOMRange *range) = 0;

	/**
	* Removes a range from the current selection.
	*/
	/* void removeRange (in nsIDOMRange range); */
	NS_SCRIPTABLE NS_IMETHOD RemoveRange(nsIDOMRange *range) = 0;

	/**
	* Removes all ranges from the current selection.
	*/
	/* void removeAllRanges (); */
	NS_SCRIPTABLE NS_IMETHOD RemoveAllRanges(void) = 0;

	/**
	* Deletes this selection from document the nodes belong to.
	*/
	/* void deleteFromDocument (); */
	NS_SCRIPTABLE NS_IMETHOD DeleteFromDocument(void) = 0;

	/**
	* Modifies the cursor Bidi level after a change in keyboard direction
	* @param langRTL is PR_TRUE if the new language is right-to-left or
	* PR_FALSE if the new language is left-to-right.
	*/
	/* void selectionLanguageChange (in boolean langRTL); */
	NS_SCRIPTABLE NS_IMETHOD SelectionLanguageChange(PRBool langRTL) = 0;

	/**
	* Returns the whole selection into a plain text string.
	*/
	/* wstring toString (); */
	NS_SCRIPTABLE NS_IMETHOD ToString(PRUnichar **_retval) = 0;

	};

	NS_DEFINE_STATIC_IID_ACCESSOR(nsISelection, NS_ISELECTION_IID)

	/* Use this macro when declaring classes that implement this interface. */
	#define NS_DECL_NSISELECTION \
	NS_SCRIPTABLE NS_IMETHOD GetAnchorNode(nsIDOMNode * *aAnchorNode); \
	NS_SCRIPTABLE NS_IMETHOD GetAnchorOffset(PRInt32 *aAnchorOffset); \
	NS_SCRIPTABLE NS_IMETHOD GetFocusNode(nsIDOMNode * *aFocusNode); \
	NS_SCRIPTABLE NS_IMETHOD GetFocusOffset(PRInt32 *aFocusOffset); \
	NS_SCRIPTABLE NS_IMETHOD GetIsCollapsed(PRBool *aIsCollapsed); \
	NS_SCRIPTABLE NS_IMETHOD GetRangeCount(PRInt32 *aRangeCount); \
	NS_SCRIPTABLE NS_IMETHOD GetRangeAt(PRInt32 index, nsIDOMRange **_retval); \
	NS_SCRIPTABLE NS_IMETHOD Collapse(nsIDOMNode *parentNode, PRInt32 offset); \
	NS_SCRIPTABLE NS_IMETHOD Extend(nsIDOMNode *parentNode, PRInt32 offset); \
	NS_SCRIPTABLE NS_IMETHOD CollapseToStart(void); \
	NS_SCRIPTABLE NS_IMETHOD CollapseToEnd(void); \
	NS_SCRIPTABLE NS_IMETHOD ContainsNode(nsIDOMNode node, PRBool partlyContained, PRBool _retval); \
	NS_SCRIPTABLE NS_IMETHOD SelectAllChildren(nsIDOMNode *parentNode); \
	NS_SCRIPTABLE NS_IMETHOD AddRange(nsIDOMRange *range); \
	NS_SCRIPTABLE NS_IMETHOD RemoveRange(nsIDOMRange *range); \
	NS_SCRIPTABLE NS_IMETHOD RemoveAllRanges(void); \
	NS_SCRIPTABLE NS_IMETHOD DeleteFromDocument(void); \
	NS_SCRIPTABLE NS_IMETHOD SelectionLanguageChange(PRBool langRTL); \
	NS_SCRIPTABLE NS_IMETHOD ToString(PRUnichar **_retval);

	/* Use this macro to declare functions that forward the behavior of this interface to another object. */
	#define NS_FORWARD_NSISELECTION(_to) \
	NS_SCRIPTABLE NS_IMETHOD GetAnchorNode(nsIDOMNode * *aAnchorNode) { return _to GetAnchorNode(aAnchorNode); } \
	NS_SCRIPTABLE NS_IMETHOD GetAnchorOffset(PRInt32 *aAnchorOffset) { return _to GetAnchorOffset(aAnchorOffset); } \
	NS_SCRIPTABLE NS_IMETHOD GetFocusNode(nsIDOMNode * *aFocusNode) { return _to GetFocusNode(aFocusNode); } \
	NS_SCRIPTABLE NS_IMETHOD GetFocusOffset(PRInt32 *aFocusOffset) { return _to GetFocusOffset(aFocusOffset); } \
	NS_SCRIPTABLE NS_IMETHOD GetIsCollapsed(PRBool *aIsCollapsed) { return _to GetIsCollapsed(aIsCollapsed); } \
	NS_SCRIPTABLE NS_IMETHOD GetRangeCount(PRInt32 *aRangeCount) { return _to GetRangeCount(aRangeCount); } \
	NS_SCRIPTABLE NS_IMETHOD GetRangeAt(PRInt32 index, nsIDOMRange **_retval) { return _to GetRangeAt(index, _retval); } \
	NS_SCRIPTABLE NS_IMETHOD Collapse(nsIDOMNode *parentNode, PRInt32 offset) { return _to Collapse(parentNode, offset); } \
	NS_SCRIPTABLE NS_IMETHOD Extend(nsIDOMNode *parentNode, PRInt32 offset) { return _to Extend(parentNode, offset); } \
	NS_SCRIPTABLE NS_IMETHOD CollapseToStart(void) { return _to CollapseToStart(); } \
	NS_SCRIPTABLE NS_IMETHOD CollapseToEnd(void) { return _to CollapseToEnd(); } \
	NS_SCRIPTABLE NS_IMETHOD ContainsNode(nsIDOMNode node, PRBool partlyContained, PRBool _retval) { return _to ContainsNode(node, partlyContained, _retval); } \
	NS_SCRIPTABLE NS_IMETHOD SelectAllChildren(nsIDOMNode *parentNode) { return _to SelectAllChildren(parentNode); } \
	NS_SCRIPTABLE NS_IMETHOD AddRange(nsIDOMRange *range) { return _to AddRange(range); } \
	NS_SCRIPTABLE NS_IMETHOD RemoveRange(nsIDOMRange *range) { return _to RemoveRange(range); } \
	NS_SCRIPTABLE NS_IMETHOD RemoveAllRanges(void) { return _to RemoveAllRanges(); } \
	NS_SCRIPTABLE NS_IMETHOD DeleteFromDocument(void) { return _to DeleteFromDocument(); } \
	NS_SCRIPTABLE NS_IMETHOD SelectionLanguageChange(PRBool langRTL) { return _to SelectionLanguageChange(langRTL); } \
	NS_SCRIPTABLE NS_IMETHOD ToString(PRUnichar **_retval) { return _to ToString(_retval); }

	/* Use this macro to declare functions that forward the behavior of this interface to another object in a safe way. */
	#define NS_FORWARD_SAFE_NSISELECTION(_to) \
	NS_SCRIPTABLE NS_IMETHOD GetAnchorNode(nsIDOMNode * *aAnchorNode) { return !_to ? NS_ERROR_NULL_POINTER : _to->GetAnchorNode(aAnchorNode); } \
	NS_SCRIPTABLE NS_IMETHOD GetAnchorOffset(PRInt32 *aAnchorOffset) { return !_to ? NS_ERROR_NULL_POINTER : _to->GetAnchorOffset(aAnchorOffset); } \
	NS_SCRIPTABLE NS_IMETHOD GetFocusNode(nsIDOMNode * *aFocusNode) { return !_to ? NS_ERROR_NULL_POINTER : _to->GetFocusNode(aFocusNode); } \
	NS_SCRIPTABLE NS_IMETHOD GetFocusOffset(PRInt32 *aFocusOffset) { return !_to ? NS_ERROR_NULL_POINTER : _to->GetFocusOffset(aFocusOffset); } \
	NS_SCRIPTABLE NS_IMETHOD GetIsCollapsed(PRBool *aIsCollapsed) { return !_to ? NS_ERROR_NULL_POINTER : _to->GetIsCollapsed(aIsCollapsed); } \
	NS_SCRIPTABLE NS_IMETHOD GetRangeCount(PRInt32 *aRangeCount) { return !_to ? NS_ERROR_NULL_POINTER : _to->GetRangeCount(aRangeCount); } \
	NS_SCRIPTABLE NS_IMETHOD GetRangeAt(PRInt32 index, nsIDOMRange **_retval) { return !_to ? NS_ERROR_NULL_POINTER : _to->GetRangeAt(index, _retval); } \
	NS_SCRIPTABLE NS_IMETHOD Collapse(nsIDOMNode *parentNode, PRInt32 offset) { return !_to ? NS_ERROR_NULL_POINTER : _to->Collapse(parentNode, offset); } \
	NS_SCRIPTABLE NS_IMETHOD Extend(nsIDOMNode *parentNode, PRInt32 offset) { return !_to ? NS_ERROR_NULL_POINTER : _to->Extend(parentNode, offset); } \
	NS_SCRIPTABLE NS_IMETHOD CollapseToStart(void) { return !_to ? NS_ERROR_NULL_POINTER : _to->CollapseToStart(); } \
	NS_SCRIPTABLE NS_IMETHOD CollapseToEnd(void) { return !_to ? NS_ERROR_NULL_POINTER : _to->CollapseToEnd(); } \
	NS_SCRIPTABLE NS_IMETHOD ContainsNode(nsIDOMNode node, PRBool partlyContained, PRBool _retval) { return !_to ? NS_ERROR_NULL_POINTER : _to->ContainsNode(node, partlyContained, _retval); } \
	NS_SCRIPTABLE NS_IMETHOD SelectAllChildren(nsIDOMNode *parentNode) { return !_to ? NS_ERROR_NULL_POINTER : _to->SelectAllChildren(parentNode); } \
	NS_SCRIPTABLE NS_IMETHOD AddRange(nsIDOMRange *range) { return !_to ? NS_ERROR_NULL_POINTER : _to->AddRange(range); } \
	NS_SCRIPTABLE NS_IMETHOD RemoveRange(nsIDOMRange *range) { return !_to ? NS_ERROR_NULL_POINTER : _to->RemoveRange(range); } \
	NS_SCRIPTABLE NS_IMETHOD RemoveAllRanges(void) { return !_to ? NS_ERROR_NULL_POINTER : _to->RemoveAllRanges(); } \
	NS_SCRIPTABLE NS_IMETHOD DeleteFromDocument(void) { return !_to ? NS_ERROR_NULL_POINTER : _to->DeleteFromDocument(); } \
	NS_SCRIPTABLE NS_IMETHOD SelectionLanguageChange(PRBool langRTL) { return !_to ? NS_ERROR_NULL_POINTER : _to->SelectionLanguageChange(langRTL); } \
	NS_SCRIPTABLE NS_IMETHOD ToString(PRUnichar **_retval) { return !_to ? NS_ERROR_NULL_POINTER : _to->ToString(_retval); }

	#if 0
	/* Use the code below as a template for the implementation class for this interface. */

	/* Header file */
	class nsSelection : public nsISelection
	{
	public:
	NS_DECL_ISUPPORTS
	NS_DECL_NSISELECTION

	nsSelection();

	private:
	~nsSelection();

	protected:
	/* additional members */
	};

	/* Implementation file */
	NS_IMPL_ISUPPORTS1(nsSelection, nsISelection)

	nsSelection::nsSelection()
	{
	/* member initializers and constructor code */
	}

	nsSelection::~nsSelection()
	{
	/* destructor code */
	}

	/* readonly attribute nsIDOMNode anchorNode; */
	NS_IMETHODIMP nsSelection::GetAnchorNode(nsIDOMNode * *aAnchorNode)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* readonly attribute long anchorOffset; */
	NS_IMETHODIMP nsSelection::GetAnchorOffset(PRInt32 *aAnchorOffset)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* readonly attribute nsIDOMNode focusNode; */
	NS_IMETHODIMP nsSelection::GetFocusNode(nsIDOMNode * *aFocusNode)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* readonly attribute long focusOffset; */
	NS_IMETHODIMP nsSelection::GetFocusOffset(PRInt32 *aFocusOffset)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* readonly attribute boolean isCollapsed; */
	NS_IMETHODIMP nsSelection::GetIsCollapsed(PRBool *aIsCollapsed)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* readonly attribute long rangeCount; */
	NS_IMETHODIMP nsSelection::GetRangeCount(PRInt32 *aRangeCount)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* nsIDOMRange getRangeAt (in long index); */
	NS_IMETHODIMP nsSelection::GetRangeAt(PRInt32 index, nsIDOMRange **_retval)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* void collapse (in nsIDOMNode parentNode, in long offset); */
	NS_IMETHODIMP nsSelection::Collapse(nsIDOMNode *parentNode, PRInt32 offset)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* void extend (in nsIDOMNode parentNode, in long offset); */
	NS_IMETHODIMP nsSelection::Extend(nsIDOMNode *parentNode, PRInt32 offset)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* void collapseToStart (); */
	NS_IMETHODIMP nsSelection::CollapseToStart()
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* void collapseToEnd (); */
	NS_IMETHODIMP nsSelection::CollapseToEnd()
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* boolean containsNode (in nsIDOMNode node, in boolean partlyContained); */
	NS_IMETHODIMP nsSelection::ContainsNode(nsIDOMNode node, PRBool partlyContained, PRBool _retval)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* void selectAllChildren (in nsIDOMNode parentNode); */
	NS_IMETHODIMP nsSelection::SelectAllChildren(nsIDOMNode *parentNode)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* void addRange (in nsIDOMRange range); */
	NS_IMETHODIMP nsSelection::AddRange(nsIDOMRange *range)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* void removeRange (in nsIDOMRange range); */
	NS_IMETHODIMP nsSelection::RemoveRange(nsIDOMRange *range)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* void removeAllRanges (); */
	NS_IMETHODIMP nsSelection::RemoveAllRanges()
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* void deleteFromDocument (); */
	NS_IMETHODIMP nsSelection::DeleteFromDocument()
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* void selectionLanguageChange (in boolean langRTL); */
	NS_IMETHODIMP nsSelection::SelectionLanguageChange(PRBool langRTL)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* wstring toString (); */
	NS_IMETHODIMP nsSelection::ToString(PRUnichar **_retval)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* End of implementation class template. */
	#endif


	#endif /* __gen_nsISelection_h__ */