dom/base/nsISelectionListener.idl

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /* This Source Code Form is subject to the terms of the Mozilla Public
   3  * License, v. 2.0. If a copy of the MPL was not distributed with this
   4  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
   5
   6 #include "nsISupports.idl"
   7
   8 webidl Document;
   9 webidl Selection;
  10
  11 [scriptable, uuid(45686299-ae2b-46bc-9502-c56c35691ab9)]
  12 interface nsISelectionListener : nsISupports
  13 {
  14   const short NO_REASON=0;
  15   const short DRAG_REASON=1;
  16   const short MOUSEDOWN_REASON=2;/*bitflags*/
  17   const short MOUSEUP_REASON=4;/*bitflags*/
  18   const short KEYPRESS_REASON=8;/*bitflags*/
  19   const short SELECTALL_REASON=16;
  20   const short COLLAPSETOSTART_REASON=32;
  21   const short COLLAPSETOEND_REASON=64;
  22   const short IME_REASON=128;
  23   // JS_REASON is set if the selection change is directly caused by a call
  24   // of Selection API or Range API.
  25   const short JS_REASON=256;
  26
  27   // Values of nsSelectionAmount.
  28   // Reflects the granularity in which the selection caret has moved.
  29   const long CHARACTER_AMOUNT = 0;
  30   const long CLUSTER_AMOUNT = 1;
  31   const long WORD_AMOUNT = 2;
  32   const long WORDNOSPACE_AMOUNT = 3;
  33   const long LINE_AMOUNT = 4;
  34   const long BEGINLINE_AMOUNT = 5;
  35   const long ENDLINE_AMOUNT = 6;
  36   const long NO_AMOUNT = 7;
  37   const long PARAGRAPH_AMOUNT = 8;
  38
  39   [can_run_script]
  40   void notifySelectionChanged(in Document doc, in Selection sel,
  41                               in short reason, in long amount);
  42 };
  43
  44 %{C++
  45 namespace mozilla {
  46
  47 /**
  48  * Returning names of `nsISelectionListener::*_REASON` in aReasons.
  49  */
  50 nsCString SelectionChangeReasonsToCString(int16_t aReasons);
  51
  52 } // namespace mozilla
  53 %}