mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-22 01:35:35 +00:00
00591135a4
This patch defines mozilla::SelectionType as an enum class. This is safer than nsISelectionController::SELECTION_* since setting illegal value to its variable is checked at build time. So, as far as possible, this should be used everywhere (but of course, this isn't available in scriptable interfaces). And also this implements some useful methods for managing SelectionType and RawSelectionType which are implemented in layout/nsSelection.cpp because nsISelectionController is implemented by both PresShell and nsTextEditorState. Therefore, implementing one of them may make hard to find them. On the other hand, nsSelection.cpp is a better file name to look for them. Note that this patch creates mozilla::Selection::RawType() for binding. Native code should keep using Selection::Type() but the binding code needs to use RawType() due to impossible to convert from SelectionType to RawSelectionType without explicit cast. MozReview-Commit-ID: 81vX7A0hHQN --HG-- extra : rebase_source : d9f88e217c713c60d1c2578ce6421c73ccba8650
89 lines
2.7 KiB
Plaintext
89 lines
2.7 KiB
Plaintext
/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
|
|
* You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
*
|
|
* The origin of this IDL file is
|
|
* https://dvcs.w3.org/hg/editing/raw-file/tip/editing.html#concept-selection
|
|
*
|
|
* Copyright © 2012 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C
|
|
* liability, trademark and document use rules apply.
|
|
*/
|
|
|
|
interface Selection {
|
|
readonly attribute Node? anchorNode;
|
|
readonly attribute unsigned long anchorOffset;
|
|
readonly attribute Node? focusNode;
|
|
readonly attribute unsigned long focusOffset;
|
|
|
|
readonly attribute boolean isCollapsed;
|
|
[Throws]
|
|
void collapse(Node node, unsigned long offset);
|
|
[Throws]
|
|
void collapseToStart();
|
|
[Throws]
|
|
void collapseToEnd();
|
|
|
|
[Throws]
|
|
void extend(Node node, unsigned long offset);
|
|
|
|
[Throws]
|
|
void selectAllChildren(Node node);
|
|
[Throws]
|
|
void deleteFromDocument();
|
|
|
|
readonly attribute unsigned long rangeCount;
|
|
[Throws]
|
|
Range getRangeAt(unsigned long index);
|
|
[Throws]
|
|
void addRange(Range range);
|
|
[Throws]
|
|
void removeRange(Range range);
|
|
[Throws]
|
|
void removeAllRanges();
|
|
|
|
[Throws]
|
|
boolean containsNode(Node node, boolean allowPartialContainment);
|
|
|
|
stringifier;
|
|
};
|
|
|
|
// Additional methods not currently in the spec
|
|
partial interface Selection {
|
|
[Throws]
|
|
void modify(DOMString alter, DOMString direction,
|
|
DOMString granularity);
|
|
};
|
|
|
|
// Additional chrome-only methods from nsISelectionPrivate
|
|
interface nsISelectionListener;
|
|
partial interface Selection {
|
|
[ChromeOnly]
|
|
const short ENDOFPRECEDINGLINE = 0;
|
|
[ChromeOnly]
|
|
const short STARTOFNEXTLINE = 1;
|
|
|
|
[ChromeOnly,Throws]
|
|
attribute boolean interlinePosition;
|
|
|
|
[Throws]
|
|
attribute short? caretBidiLevel;
|
|
|
|
[ChromeOnly,Throws]
|
|
DOMString toStringWithFormat(DOMString formatType, unsigned long flags, long wrapColumn);
|
|
[ChromeOnly,Throws]
|
|
void addSelectionListener(nsISelectionListener newListener);
|
|
[ChromeOnly,Throws]
|
|
void removeSelectionListener(nsISelectionListener listenerToRemove);
|
|
|
|
[ChromeOnly,BinaryName="rawType"]
|
|
readonly attribute short type;
|
|
|
|
[ChromeOnly,Throws,Pref="dom.testing.selection.GetRangesForInterval"]
|
|
sequence<Range> GetRangesForInterval(Node beginNode, long beginOffset, Node endNode, long endOffset,
|
|
boolean allowAdjacent);
|
|
|
|
[ChromeOnly,Throws]
|
|
void scrollIntoView(short aRegion, boolean aIsSynchronous, short aVPercent, short aHPercent);
|
|
};
|