NAME
  DropSite - Commands set for Drop facilities

COMMAND
  DropSite::include class types
  DropSite::register path ?option value...?
  DropSite::setcursor cursor
  DropSite::setdrop path subpath dropover drop ?force?
  DropSite::setoperation op

DESCRIPTION

この名前空間の命令は使用者に BWidget や Tk 部品を引き摺り所在地として定義することを可能にする｡落下所在地は､落下でき且つ操作に結合された対象の型と､落下が生じた時に呼ばれる命令と､対象が部品上で引き摺れる時の命令とから構成される｡落下所在地は､最低限受容れ可能の対象と落下命令の一つの型を備えねばならない｡ Commands of this namespace enable user to define a BWidget or a Tk widget as a drop site. A drop site is composed of the type of object that can be dropped and associated operation, a command called when drop occurs, and a command when an object is dragged over the widget. A drop site must have at least one type of acceptable object and a drop command.

COMMAND

DropSite::include class types
  この命令は落下所在地を BWidget 原資定義に含ませる指示項目の簡単な方法を提供する｡ それは必要とされる register の指示項目､空文字列の初期化のための -dropovercmd と -dropcmdとtypesへの初期化の為の -droptypes及び次の新しい指示項目を含む:｡ This command provides a simple way to include options relatives to a drop site into BWidget resources definition. It includes the options needed for register, -dropovercmd and -dropcmd, initialized to empty string, and -droptypes, initialized to types, and one new option:

  -dropenabled | 落下が活動か否かを指定する(初期値は0) Specifies wether or not drop is active (initialized to 0)

DropSite::register path ?option value...?
  この命令はpathを落下所在地として宣言する｡指示項目は: This command is used to declare path as a drop site. Options are:

  -dropcmd
    この命令は適切な落下対象の上で使用者が引き摺りアイコンを離した時に呼出される｡命令に渡される引数は: This command is called when user release the drag icon over a valid drop target widget. Arguments passed to the command are:
    - 落下目的の経路名(部品そのもの)｡ pathname of the drop target (the widget itself),
    - 引摺り原資の経路名 pathname of the drag source,
    - 指示子の根本x-座標､ root x-coordinate of the pointer,
    - 指示子の根本y-座標､ root y-coordinate of the pointer,
    - 操作｡ operation,
    - 引き摺られたデータの型｡ type of the dragged data,
    - 引き摺られたデータ｡ dragged data.
    それが返す値は引摺り原資の-dragendcmd 命令の結果として渡される｡ Its return values is passed as a result to the -dragendcmd command of the drag source widget.
  -dropovercmd
    この命令は上で引き摺り行事の間の動的引き摺りを提供する為に使用できる｡引き摺りが生じる間､行事 <Enter> と <Motion> と <Leave> が捕捉される｡命令に渡される引数は: This command can be used to provide a dynamic drag while drag-over events. While a drag occurs, events <Enter>, <Motion> and <Leave> are catched. Arguments passed to the command are:
    - 落下目標の経路名(部品そのもの)｡ pathname of the drop target (the widget itself),
    - 引摺り原資の経路名 pathname of the drag source,
    - 落下目標上の行事: enter か motion か leave, event over the drop target: enter, motion or leave,
    - 指示子の根本x-座標､ root x-coordinate of the pointer,
    - 指示子の根本y-座標､ root y-coordinate of the pointer,
    - 操作｡ operation,
    - 引き摺られたデータの型｡ type of the dragged data,
    - 引き摺られたデータ｡ dragged data.
    命令は新しい状態か引き摺りでなければならない: Command must the new status of the drag:
    - 0 部品はこの引き摺りを拒否｡命令は 移動/離別 では再呼出しされない｡ 0 if widget refuse this drag. Command will not be recalled on motion/leave event.
    - 1 部品はこの引き摺りを受容｡命令は 移動/離別 では再呼出しされない｡ 　 1 if widget accept this drag. Command will not be recalled on motion/leave event.
    - 2 部品はこの引き摺りを拒否｡命令は 再評価の為のそれぞれの動きで再呼出しされる｡ 2 if widget refuse this drag. Command will be recalled on each motion event to reevaluate.
    - 3 部品はこの引き摺りを受容｡命令は 再評価の為のそれぞれの動きで再呼出しされる｡ 　 3 if widget accept this drag. Command will be recalled on each motion event to reevaluate.
    これは行事と落下所在地部品に結合した動作のリストである｡この例は引き摺られたデータ型が落下対象に対して適切であることを仮定している｡status は落下所在地上の引き摺りの状態である｡その値は: Here is a list of events and associated actions on a DropSite widget. This example assumes that dragged data type is valid for the drop target. status is the status of the drag on a DropSite. Its value is:

    Event | Old status | Action | New status
    <Enter> | - | if DropSite has dropovercmd, call it with enter | result of dropovercmd
    else | 1
    <Motion> | 0 or 1 |  | unchanged
    2 or 3 | call dropovercmd with motion | result of dropovercmd
    <Leave> | 0 or 1 |  | -
    2 or 3 | call dropovercmd with leave | -
    <Drop> | 0 | call dragendcmd of drag source | -
    1 | call dropcmd and call dragendcmd of drag source
    2 | call dropovercmd with leave and call dragendcmd of drag source
    3 | call dropcmd and call dragendcmd of drag source

  -droptypes
    落下対象に関する受容れ可能な型と結合した操作のリストの {type oplist ?type oplist? ...} を指定する｡それぞれの型について､ oplist は､操作とこれらの操作に関する修正鍵を記述するリスト {descops mod ?descops mod? ...} である｡descops は操作を記述する｡それは事前定義操作()でも､ {subop baseop ?bitmap?} の形式の新しい使用者定義操作でも好い｡subop は仔操作に与えられた名前であり､ baseop は基本操作の名前であり､ bitmap は操作に関する展示の為の点地図である｡ もし bitmap が空なら基本操作の既定の点地図が仔操作の展示の為に使われる｡ 基本操作の点地図の変更の為に､subop が基本操作になり得る｡この場合､baseop は空か subopに等しくなければならない｡mod は操作に関する修正鍵である｡次のものがある: Specifies a list {type oplist ?type oplist? ...} of acceptable types and associated operations for the drop target. For each type, oplist is a list {descops mod ?descops mod? ...} describing operations and modifier keys for these operations. descops describe an operation. It can be a predefined operations (copy, move or link) or a new user defined operation, of the form {subop baseop ?bitmap?}. subop is the name given to the sub operation, baseop is the name of the base operation (copy, move or link) and bitmap is a bitmap to display for the operation.
    If bitmap is empty, the default bitmap of the base operation is used for the sub operation.
    subop can be a base operation, in order to change the bitmap of a base operation. In this case, baseop must be empty or equal to subop.
    mod is the modifer key for the operation. It can be:
    - none は､どの修正鍵も押されていないことを示す｡この修正子はdefault と名付けられた仔指示項目とのみ使用でき(逆も然り)､後者はどの点地図操作も展示しない振舞を有する｡全ての型について､もし修正子none が与えられないと､基本操作の複写の既定仔操作に結合される｡ none to specify that no modifier key is pressed. This modifier can only be used with a sub operation named default (and vice versa), which has the behaviour of not display any bitmap operation. For all type, if the modifier none is not given, it is automatically associated to the default sub operation of a copy base operation.
    - program は仔操作は DropSite::setoperation によってのみ利用可能に指定する｡ program to specifies a sub operation accessible only by DropSite::setoperation.
    - shift や control や alt の組合せのリストは対応する鍵を意味する｡ A list combining shift, control and alt, which means their corresponding key.

DropSite::setcursor cursor
  この命令は記述譜dragovercmdの内部で使用できる｡それは引き摺りの状態に関する可視効果の提供に便利である｡ This command can be used within the script dragovercmd. It is usefull to provide visual effect about the state of the drag.

DropSite::setdrop path subpath dropover drop ?force?
  この命令はBWidget 生成又は構成設定の間 register を呼出す簡単な方法を提供する｡ This command provides a simple way to call register during a BWidget creation or configuration.
  - path は BWidget の経路名､ path is the pathname of the BWidget,
  - subpath は引き摺り行事が生じる場所の tk 部品の経路名､ subpath is the pathname of the tk widget where drag event occurs,
  - dropover は drag-over 行事に関する命令､ dropover is a command for drag-over event,
  - drop は drop 行事に関する命令､ drop is a command for drop event,
  - force は､何時であれ､どの指示項目の値も変わらないとき､register 呼出するか否かを指定する(既定は0 - BWidget 生成には BWidget 構成設定で1を使われたい)｡ force specifies wether or not to call register whenever no option value has changed (0 by default - for BWidget configuration, use 1 for BWidget creation).
  setdrop は dropenabled と droptypes 指示項目の修正旗徴を検証し､指示項目の値及びdropover と drop 引数に従って必要とされるときは register を呼ぶ｡dropovercmd と dropcmd は部品から指示項目を取らない､理由は使用者命令と看做されるから drag-over と drop 行事の BWidget 実装によって呼ばれる｡ setdrop verifies the modification flag of options dropenabled and droptypes and calls register if needed according to the options values and dropover and drop arguments. dropovercmd and dropcmd are not taken from options of widget because they are considered as user command, called by BWidget implementation of drag-over and drop events.

DropSite::setoperation op
  説明文 Description text