DELPHI基础教程

第九章 Delphi拖放编程

   Delphi 提供的所有控件 (Control ,即能获得输入焦点的部件 ) 都支持拖放操作,并有相应的拖放属性、拖放事件和拖放方法。下面我们先介绍控件的拖放支持,而后再给出开发拖放操作的一般步骤和应用实例。 

9.1  控件的拖放支持 

9.1.1 拖放属性 

  ● DragMode : 拖动模式

  ● DragCursor : 拖动光标 

  它们都是在拖放的源控件中设置。 DragMode 控制用户在运行时间内当在控件上按下鼠标时控件如何反应。如果 DragMode 置为 dmAutomatic ,那么当用户在控件上按下鼠标时拖动自动开始;如果 DragMode 置为 dmManual( 这是缺省值 ) ,则将通过处理鼠标事件来判断一个拖动是否可以开始。

   DragCursor 用于选择拖动时显示的光标,缺省值是 CrDrag ,一般不要去修改它。在程序设计过程中通用的界面规范应该得到开发者的尊重。但有时候为了特定的目的,开发者也可以把自己设计的光标赋给 DragCursor 。 

9.1.2 拖放事件 

  ● OnDragOver :拖动经过时激发

 ● OnDragDrop :拖动放下时激发

 ● OnEndDrop :拖动结束时激发 

   OnDragOver 事件最主要的功能是确定当用户就地放下拖动时控件是否可以接受。它的参数包括: 

Source : TObject ;  { 源控件}

X , Y : Integer; { 光标位置}

State : TDragState ; { 拖动状态}

var Accept : Boolean { 能否接受} 

   TDragState 是一个枚举类型,表示拖放项目与目标控件的关系。 

  type

TDragState = (dsDragEnter, dsDragLeave, dsDragMove);

表 9.1 DragState 的取值与意义

━━━━━━━━━━━━━━━━━━━━━━━━━━━

 取 值 意 义

───────────────────────────

dsDragEnter 拖动对象进入一个允许拖动对象放下

的控件中。为缺省状态。

dsDragLeave 拖动对象离开一个允许拖动对象放下

的控件。

dsDragMove 拖动对象在一个允许拖动对象放下的

控件内移动。

━━━━━━━━━━━━━━━━━━━━━━━━━━━  

  ● 判断源控件类型: 

  Accept := Source is TLabel;

  ● 判断源控件对象: 

  Accept := (Source = TabSet1);

  ● 判断光标位置:

见 (9.2),(9.3) 中的例程。 

● 判断拖动状态: 

  If (Source is TLabel) and (State = dsDragMove) then

   begin

source.DragIcon := ' New.Ico ';

Accept := True;

   end

   else

   Accept := False;

  当 Accept=True 时,目标控件可以响应 OnDragDrop 事件,用于确定拖动被放下后程序如何进行处理。

   OnDragDrop 事件处理过程的参数包括源控件和光标位置。这些信息可用于处理方式的确定。

  OnEndDrag 事件是在拖动操作结束后由源控件来进行响应的,用于源控件进行相应的处理。拖动操作结束既包括拖动放下被接受,也包括用户在一个不能接受放下的控件上释放了鼠标。该事件处理过程的参数包括目标控件 (Target) 和放下位置的坐标。如果 Target=nil, 表示拖动项目没有被任何控件接受。

  在第 3 节将介绍的文件拖放移动、拖放拷贝操作中,如果操作成功,则文件列表框应更新显示内容。下面这段程序用于实现这一功能。 

procedure TFMForm.FileListEndDrag(Sender, Target: TObject; X, Y: Integer);

begin

if Target <> nil then FileList.Update;

end;

  除以上介绍的三个事件外,还有一个事件 OnMouseDown 也常用于拖放操作的响应。 OnMouseDown 虽然不是一个专门的拖放事件,但在人工模式下拖动的开始是在这一事件的处理过程中实现的。 

9.1.3 拖放方法 

  ● BeginDrag : 人工方式下开始一个拖动

  ● EndDrag : 结束一个拖动

 ● Dragging : 判断一个控件是否正被拖动 

  当 DragMode 置为 dmManual 时,拖动必须调用控件的 BeginDrag 方法才能开始。 BeginDrag 有一个布尔参数 Immediate 。如果输入参数为 True ,拖动立即开始,光标改变到 DragCursor 的设置。如果输入参数为 False ,直到用户将光标移动了一定的距离 (5 个象素点 ) 后才改变光标,开始拖动。这就允许控件接受一个 OnClick 事件而并不开始拖动操作。

   EndDrag 方法中止一个对象的被拖动状态。它有一个布尔参数 Drop 。如果 Drop 设置为 True ,被拖动的对象在当前位置放下 ( 能否被接受由目标控件决定 ) ;如果 Drop 设置为 False ,则拖动就地被取消。

procedure TForm1.Panel1DragOver(Sender, Source: TObject; X, Y: Integer;

State: TDragState; var Accept: Boolean);

begin

Accept := False;

if (Source is TLabel) and (State = dsDragEnter) then

(Source as TLabel).EndDrag(False);

end;

   Draging 方法判断一个控件是否正被拖动。在下面的例子中当用户拖动不同的检查框时窗口改变为不同的颜色。 

procedure TForm1.FormActivate(Sender: TObject);

begin

CheckBox1.DragMode := dmAutomatic;

CheckBox2.DragMode := dmAutomatic;

CheckBox3.DragMode := dmAutomatic;

end; 

procedure TForm1.FormDragOver(Sender, Source: TObject; X, Y: Integer;

State: TDragState; var Accept: Boolean);

begin

if CheckBox1.Dragging then

Color := clAqua;

if CheckBox2.Dragging then

Color := clYellow;

if CheckBox3.Dragging then

Color := clLime;

end; 

9.2 开发拖放功能的一般步骤 

 拖放作为 Windows 提供的一种方便操作对象的功能,在 Delphi 中可以很容易地开发出来。根据拖放操作的过程可以把开发步骤划分为四个阶段,即:

  ● 开始拖动操作

 ● 接收拖动项目

 ● 放下拖动项目

 ● 终止拖动操作 

 在介绍过程中我们将结合一个 TabSet( 标签集 ) 的拖放操作实例。界面设计如图。在运行时当用户把一个标签拖动到另一个标签的位置时,该标签将移动到该位置并引起标签集的重新布置。

9.2.1 开始拖动操作 

 当拖动模式 (DragMode) 设置为 dmAutomatic 时,用户在源控件上按下鼠标时拖动自动开始;当设置为 dmManual 时通过处理鼠标事件来决定拖动是否开始。如果想开始拖动调用 BeginDrag 方法。

  在 TabSet 拖放中,我们用下面的 MouseDown 事件处理过程来开始一个标签的拖动。首先判断按下的是否是左键,而后再判断项目是否合法。 

procedure TForm1.TabSet1MouseDown(Sender: TObject; Button: TMouseButton;

Shift: TShiftState; X, Y: Integer);

var

DragItem: Integer;

begin

if Button = mbLeft then

begin

DragItem := TabSet1.ItemAtPos(Point(X, Y));

if (DragItem > -1) and (DragItem < TabSet1.Tabs.Count) then

TabSet1.BeginDrag(False);

end;

end; 

9.2.2 接收拖动项目 

 一个控件能否接收拖动项目是由该控件的 OnDragOver 事件决定的。在 TabSet 拖动中,主要是利用鼠标的位置进行判断。  

procedure TForm1.TabSet1DragOver(Sender, Source: TObject; X, Y: Integer;

State: TDragState; var Accept: Boolean);

var

DropPos: Integer;

begin

if Source = TabSet1 then

begin

DropPos := TabSet1.ItemAtPos(Point(X, Y));

Accept := (DropPos > -1) and (DropPos <> TabSet1.TabIndex) and

(DropPos < TabSet1.Tabs.Count);

end;

else

Accept := False;

end; 

9.2.3 放下拖动项目 

  当 OnDragOver 事件处理过程返回的 Accept 为 True 且项目被放下时,由 OnDragDrop 事件处理过程来完成拖动放下后的响应。在 TabSet 拖放实例中是改变标签的位置。 

procedure TForm1.TabSet1DragDrop(Sender, Source: TObject; X, Y: Integer);

var

OldPos: Integer;

NewPos: Integer;

begin

if Source = TabSet1 then

begin

OldPos := TabSet1.TabIndex;

NewPos := TabSet1.ItemAtPos(Point(X, Y));

if (NewPos > -1) and (NewPos <> OldPos) then

TabSet1.Tabs.Move(OldPos, NewPos);

end;

end; 

9.2.4 结束拖动操作 

 结束拖动操作的方式有两种:或者是用户释放了鼠标键或者是程序用 EndDrag 方法强行中止拖动。结束拖动操作的后果有两种:放下被接受或放下被忽略。

  拖动操作结束后源控件都要收到一条消息响应拖动结束事件 OnEndDrag 。 

9.3   拖放应用实例:文件管理器的拖放支持 

 在第六章最后开发的文件管理器应用实例,虽然功能上已初具规模,但在操作上与 Windows 的文件管理器相比还有很大不足。其中最大的缺陷是它不支持文件的拖放移动和拖放拷贝。在这一章结束的时候,我们可以来弥补这一缺陷了。

   1. 如何记录每一驱动器的当前目录?

   var

CurentDirList: Array[0...25] of string[70]; 

在 DirectoryOutline 的 OnChange 事件中: 

procedure TFMForm.DirectoryOutlineChange(Sender: TObject);

begin

CreateCaption;

FileList.clear;

FileList.Directory := DirectoryOutline.Directory;

FileList.Update;

CurrentDirList[DriveTabSet.TabIndex] := DirectoryOutline.Directory;

FileManager.DirectoryPanel.Caption := DirectoryOutline.Directory;

end;   

 由于 DriveTabSet 在响应 OnDragDrop 事件前先响应 OnClick 事件,并由该事件激发 DirectoryOutline 的 Onchange 事件,因而可保证在任何时候 OnDragDrop 事件中用到的 CurrentDirList 数组项不为空字符串。

  在这里一个关键问题是我们判断源控件时是用 is 操作符进行类型检查 : 

If Source is TFileList then

  If Source = FileList then

   …

   1.FileList 开始拖动操作 

procedure TFMForm.FileListMouseDown(Sender: TObject; Button: TMouseButton;

Shift: TShiftState; X, Y: Integer);

begin

if Button = mbLeft then

with Sender as TFileListBox do

begin

if ItemAtPos(Point(X, Y), True) >= 0 then

BeginDrag(False);

end;

end;

   ItemAtPos 用来检查当前是否有文件存在。而 BeginDrag 方法传递参数 False, 允许 FileList 单独处理鼠标事件而并不开始拖动。事实上这种情况是大量存在的。 

  2.DirectoryOutline 、 DriveTabSet 决定是否能接受拖动的就地放下。  

procedure TFMForm.DirectoryOutlineDragOver(Sender, Source: TObject; X,

Y: Integer; State: TDragState; var Accept: Boolean);

begin

if Source is TFileListBox then

Accept := True;

end; 

procedure TFMForm.DriveTabSetDragOver(Sender, Source: TObject; X,

Y: Integer; State: TDragState; var Accept: Boolean);

var

PropPos: Integer;

begin

if Source is TFileListBox then

with DriveTabSet do

begin

PropPos := ItemAtPos(Point(X,Y));

Accept := (PropPos > -1) and (PropPos < Tabs.Count);

end;

end;

   DirectoryOutline 是无条件的接受,而 DriveTabSet 需检查是否是合法的标签。 

  3. 拖动放下的响应

  DirectoryOutline 的拖动放下用于实现文件移动功能。程序中调用 ConfirmChange 事件处理过程,目标路径由 DirctoryOutline.Items[GetItem(X,Y)].FullPath 来得到。  

procedure TFMForm.DirectoryOutlineDragDrop(Sender, Source: TObject; X,

Y: Integer);

begin

if Source is TFileListBox then

with DirectoryOutline do

begin

ConfirmChange('Move',FileList.FileName, Items[GetItem(X, Y)].FullPath);

end;

end;

  DriveTabSet 的拖动放下用于实现文件拷贝功能。程序中把当前位置转化为相应的驱动器号,目标路径由 CurrentDirList[DriveTabSet.TabIndex] 获得。 

procedure TFMForm.DriveTabSetDragDrop(Sender, Source: TObject; X,Y: Integer);

var

APoint: TPoint;

begin

APoint.X := X; APoint.Y := Y;

DriveTabSet.TabIndex := DriveTabSet.ItemAtPos(APoint);

if Source is TFileListBox then

with DriveTabSet do

begin

if CurrentDirList[TabIndex] <> '' then

ConfirmChange('Copy',TheFilename,CurrentDirList[TabIndex]);

end;

end; 

4.FileList 响应拖动结束,更新文件列表 

procedure TFMForm.FileListEndDrag(Sender, Target: TObject; X, Y: Integer);

begin

if Target <> nil then FileList.Update;

end; 

到目前为止,我们的文件管理器功能已足够强大。 不过还有许多问题值得读者去进

一步探讨,如:

   1. 文件与应用程序关联的建立;

  2. 在文件列表框中显示更多的文件信息;

  3. 文件列表框中的文件按后缀各排序等。

 文件管理器是一个真正的综合例程,对它的钻研会使您更进一步模到 Delphi 编程的精髓。

[目录] [上一页] [下一页]