nsIDragService

継承元: nsISupports

メソッドの概要

定数

メソッド

invokeDragSession()

移転可能なオブジェクトの配列を伴った、モーダルなドラッグセッションを開始します。

  void invokeDragSession ( 
   in nsIDOMNode aDOMNode, 
   in nsISupportsArray aTransferables, 
   in nsIScriptableRegion aRegion, 
   in unsigned long aActionType 
 );

引数

<tt>aDOMNode</tt>

 

<tt>aTransferables</tt>

ドラッグされる移転可能なオブジェクトの配列。

<tt>aRegion</tt>

カーソルフィードバックの矩形を含む範囲。ウィンドウ座標で指定。

<tt>aActionType</tt>

コピー、移動、リンクのうち、いずれが可能かを指定。

invokeDragSessionWithImage()

画像を利用して、モーダルなドラッグセッションを開始します。最初 4 つの引数は invokeDragSession と同じです。

aImage 引数を使って独自の画像を指定することができます。画像が指定された場合、aImageX と aImageY 引数で、その画像の中でカーソルが位置するオフセットを指定できます。つまり、画像が表示されたときに、指定された量だけ左上に画像がずらされて、画像内のその位置にカーソルが現れます。aImage が null の場合、aImageX と aImageY は使われず、代わりにソースノードである aDOMNode から画像が判別され、オフセットは自動計算されます。このため、画像の初期位置は、要素が位置するのと同じ画面上の位置になります。ノードはドキュメント内になくてはなりません。

今のところ、サポートされている画像はすべて DOM ノードです。これが HTML <image> あるいは <canvas> 要素の場合、ドラッグに付随する画像はその画像データから取得されます。要素がドキュメント上にある場合は、画像は表示されているサイズで表示されます。ドキュメント上にない場合は、実際のサイズで表示されます。他の種類の要素については、現在表示されているのと同じ方法で、画面外のバッファとして表示されます。ドキュメント上の選択範囲はドラッグ中非表示となります。画像の位置を計算するのに、イベントの現在の画面座標が必要となるため、aDragEvent は必ず指定する必要があります。

  void invokeDragSessionWithImage(in nsIDOMNode aDOMNode,
                                  in nsISupportsArray aTransferableArray,
                                  in nsIScriptableRegion aRegion,
                                  in unsigned long aActionType,
                                  in nsIDOMNode aImage,
                                  in long aImageX,
                                  in long aImageY,
                                  in nsIDOMMouseEvent aDragEvent
  );

引数

<tt>aImage</tt>

画像オブジェクト

<tt>aImageX</tt>

画像の X 座標

<tt>aImageY</tt>

画像の Y 座標

<tt>aDragEvent</tt>

 

invokeDragSessionWithSelection()

選択範囲をドラッグ画像として利用して、モーダルなドラッグセッションを開始します。画像の位置を計算するのに、イベントの現在の画面座標が必要となるため、aDragEvent は必ず指定する必要があります。

  void invokeDragSessionWithSelection(
     in nsISelection aSelection,
     in nsISupportsArray aTransferableArray,
     in unsigned long aActionType,
     in nsIDOMMouseEvent aDragEvent
  );

引数

<tt>aSelection</tt>

 

<tt>aTransferableArray</tt>

 

<tt>aActionType</tt>

コピー、移動、リンクのうち、いずれが可能かを指定。

<tt>aDragEvent</tt>

 

getCurrentSession()

現在のドラッグセッションを返します。

  nsIDragSession getCurrentSession ( ) ;

startDragSession()

ドラッグサービスにドラッグセッションを開始するよう伝えます。これは外部でドラッグが発生したときに呼び出されます。

  void startDragSession ( ) ;

endDragSession()

ドラッグサービスにドラッグセッションを終了するよう伝えます。これは外部でドラッグが発生したときに呼び出されます。

  void endDragSession ( 
     in PRBool aDoneDrag 
  ) ;

引数

<tt>aDoneDrag </tt>

aDoneDrag が true の場合、ドラッグはすでに終了しています。そうでない場合、ドラッグはウィンドウを離れたところです。この引数は Firefox 3 以前のバージョンには存在しません。

fireDragEventAtSource()

ドラッグのソースに対してドラッグイベントを発生させます。このメソッドは Firefox 3 以降で利用可能です。

  void fireDragEventAtSource ( 
     in unsigned long aMsg 
  );

引数

<tt>aMsg </tt>