NAME
  DragSite - 引き摺り設備の為の命令 Commands set for Drag facilities

COMMAND
  DragSite::include class type event
  DragSite::register path ?option value...?
  DragSite::setdrag path subpath initcmd endcmd ?force?

説明 DESCRIPTION

この名前空間の命令は使用者に BWidget や Tk 部品を引き摺り所在地として定義することを可能にする｡ Commands of this namespace enable user to define a BWidget or a Tk widget as a drag site.

命令 COMMAND

DragSite::include class type event
  この命令は引き摺り所在地に関連する指示項目をBWidget 原資定義に含ませる簡単な方法を提供する｡それは register に必要な次の指示項目である: -dragevent はeventの初期化､-draginitcmd と -dragendcmdは空文字列に初期化される､更に二つの新しい指示項目: This command provides a simple way to include options relatives to a drag site into BWidget resources definition. It includes the options needed for register: -dragevent, initialized to event, -draginitcmd and -dragendcmd, initialized to empty string, and two new options:

  -dragenabled | 引摺りが活性か否かを指定する(初期値は0) Specifies wether or not drag is active (initialized to 0)
  -dragtype | 既定又は代りの､引摺られたデータ様式(初期値はtype)Default or alternate dragged data type (initialized to type)

DragSite::register path ?option value...?
  この命令はpath を引き摺り所在地に宣言する為に使われる｡指示項目は: This command is used to declare path as a drag site. Options are:

  -dragendcmd
    命令は引き摺りが終了した時に呼出される(即ち使用者が引き摺りアイコンを離した時)｡この命令は次の引数と共に呼ばれる: 　 Command called when drag terminates (ie when user release drag icon). This command is called with the following arguments:
    - 引摺り原資の経路名(部品そのもの)｡ the pathname of the drag source (the widget itself),
    - 落下目標の経路名｡ the pathname of the drop target,
    - 操作｡ the operation,
    - 引き摺られたデータの型｡ the type of the dragged data,
    - 引き摺られたデータ｡ the dragged data,
    - 落下の結果(目標の-dropcmdへの呼出の結果)｡ result of the drop (result of the call to -dropcmd of the target),
    もし落下が生じないと､目標と操作は空文字列であり且つ結果は0である｡ If the drop does not occurs, the target and the operation are empty string and the result is 0.
  -dragevent
    引き摺りに結合するマウス釦の番号を指定する｡1か2か3でなければならない｡ Specifies the number of the mouse button associated to the drag. Must be 1, 2 or 3.
  -draginitcmd
    引き摺りが始まる時に呼ばれる命令｡行事指示項目drageventがpathで生じる時､この命令は次の引数と共に呼ばれる: Command called when drag initiates. When the event of option dragevent occurs on path, this command is called with the following arguments:
    - 引き摺り原資の経路名(path)､ pathname of the drag source (path),
    - 指示子の根本x-座標､ root x-coordinate of pointer,
    - 指示子の根本y-座標､ root y-coordinate of pointer,
    - 引き摺られたデータを表示する為に生成された頂上水準｡帰った時に子供がないと､点地図が自動的に展示される｡ a toplevel created to represent dragged data. When returning, if it has no children, a bitmap is automatically displayed.
    もし命令が空文字列を返すと引き摺りは抑制される｡それ以外の場合命令は三つの要素を含むリストを返さねばならない: If the command returns an empty string, then the drag will be suppressed. Otherwise the command must return a list containing three elements:
    - データの型､ the type of the data,
    - 受容れられる基本的操作のリスト(copy と move と link) the list of acceptable basic operations (copy, move and link)
    - データ｡ and the data.
    註意すべきは､基本操作のリストの中に複写が現れなくても､受容れられる操作と看做される､理由は､複写の意味合いは引き摺り原資を修正しないから｡ Note that even if copy does not appear in the list of basic operation, it is considered as an acceptable operation, since copy semantic does not modify the drag source.

DragSite::setdrag path subpath initcmd endcmd ?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,
  - initcmd はdrag-init行事に関する BWidget 命令､ initcmd BWidget command for drag-init event,
  - endcmd は drag-end 行事に関する BWidget 命令､ endcmd BWidget command for drag-end 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).
  setdrag は dragenabled と dragevent 指示項目の修正旗徴を検証し､指示項目の値及びinitcmd と endcmd 引数に従って必要とされるときは register を呼ぶ｡draginitcmd と dragendcmd は部品から指示項目を取らない､理由は使用者命令と看做されるから drag-init と drag-end 行事の BWidget 実装によって呼ばれる｡ setdrag verifies the modification flag of options dragenabled and dragevent and calls register if needed according to the options values and initcmd and endcmd arguments. draginitcmd and dragendcmd are not taken from options of widget because they are considered as user command, called by BWidget implementation of drag-init and drag-end events.