Delphi Modal窗体（ModalResult、ShowModal）的介绍、使用方法和注意事项

Delphi Modal窗体（ModalResult）的介绍、使用方法和注意事项

1、ModalResult 介绍

//uses  controls
const
  mrNone     = 0;
  mrOk       = idOk;
  mrCancel   = idCancel;
  mrAbort    = idAbort;
  mrRetry    = idRetry;
  mrIgnore   = idIgnore;
  mrYes      = idYes;
  mrNo       = idNo;
  mrAll      = mrNo + 1;
  mrNoToAll  = mrAll + 1;
  mrYesToAll = mrNoToAll + 1;

type
  TModalResult = Low(Integer)..High(Integer);

//uses  windows
const
  IDOK = 1;          ID_OK = IDOK;
  IDCANCEL = 2;      ID_CANCEL = IDCANCEL;
  IDABORT = 3;       ID_ABORT = IDABORT;
  IDRETRY = 4;       ID_RETRY = IDRETRY;
  IDIGNORE = 5;      ID_IGNORE = IDIGNORE;
  IDYES = 6;         ID_YES = IDYES;
  IDNO = 7;          ID_NO = IDNO;
  IDCLOSE = 8;       ID_CLOSE = IDCLOSE;

ModalResult 表示模式对话框的返回值。应用程序可以使用任何整数值作为模式结果值。尽管TModalResult可以采用任何整数值，但为常用的TModalResult值定义了以下常量：

• mrNone  //无。在用户退出之前用作默认值。
• mrOk   //idOK   用户使用OK按钮退出。
• mrCancel  //idCancel  用户使用“取消”按钮退出。
• mrAbort   //idAbort用户使用中止按钮退出。
• mrRetry   //idRetry用户使用重试按钮退出。
• mrIgnore  //idIgnore用户使用IGNORE按钮退出。
• mrYes  //IdYes 用户使用“是”按钮退出。
• mrNo   //idNo 用户使用“否”按钮退出。
• mrAll   //mrNo+1用户使用ALL按钮退出。
• mrNoToAll  //mrAll+1用户使用“全部拒绝”按钮退出。
• mrYesToAll   //mrNoToAll+1  用户使用“全部是”按钮退出。

2、ModalResult 注意事项：

• ModalResult属性返回值执行之后，该按钮所在的窗体会自动关闭，请勿再次使用Close关闭窗体。
• 基本上窗体和按钮的都有ModalResult的属性值
• 窗体的ModalResult属性会自动传递给ShowModal，作为方法的返回值。

3、ShowModal 介绍

function ShowModal: Integer; virtual;

function TCustomForm.ShowModal: Integer;
var
  WindowList: Pointer;
  SaveFocusCount: Integer;
  SaveCursor: TCursor;
  SaveCount: Integer;
  ActiveWindow: HWnd;
begin
  CancelDrag;
  if Visible or not Enabled or (fsModal in FFormState) or
    (FormStyle = fsMDIChild) then
    raise EInvalidOperation.Create(SCannotShowModal);
  if GetCapture <> 0 then SendMessage(GetCapture, WM_CANCELMODE, 0, 0);
  ReleaseCapture;
  Application.ModalStarted;
  try
  Include(FFormState, fsModal);
  ActiveWindow := GetActiveWindow;
  SaveFocusCount := FocusCount;
  Screen.FSaveFocusedList.Insert(0, Screen.FFocusedForm);
  Screen.FFocusedForm := Self;
  SaveCursor := Screen.Cursor;
  Screen.Cursor := crDefault;
  SaveCount := Screen.FCursorCount;
  WindowList := DisableTaskWindows(0);
  try
    Show;
    try
      SendMessage(Handle, CM_ACTIVATE, 0, 0);
      ModalResult := 0;
      repeat
        Application.HandleMessage;
        if Application.FTerminate then ModalResult := mrCancel else
          if ModalResult <> 0 then CloseModal;
      until ModalResult <> 0;
      Result := ModalResult;
      SendMessage(Handle, CM_DEACTIVATE, 0, 0);
      if GetActiveWindow <> Handle then ActiveWindow := 0;
    finally
      Hide;
    end;
  finally
    if Screen.FCursorCount = SaveCount then
      Screen.Cursor := SaveCursor
    else Screen.Cursor := crDefault;
    EnableTaskWindows(WindowList);
    if Screen.FSaveFocusedList.Count > 0 then
    begin
      Screen.FFocusedForm := Screen.FSaveFocusedList.First;
      Screen.FSaveFocusedList.Remove(Screen.FFocusedForm);
    end else Screen.FFocusedForm := nil;
    if ActiveWindow <> 0 then SetActiveWindow(ActiveWindow);
    FocusCount := SaveFocusCount;
    Exclude(FFormState, fsModal);
  end;
  finally
    Application.ModalFinished;
  end;
end;

• 使用ShowModal将窗体显示为模态窗体。模式窗体是指在关闭窗体之前应用程序无法继续运行的窗体。因此，ShowModal在表单关闭之前不会返回。当窗体关闭时，它返回ModalResult属性的值。
• 要关闭模态窗体，请将其ModalResult属性设置为非零值。
• 注意：如果表单包含ModalResult属性设置为mrNone以外的值的按钮，则当用户单击其中一个按钮并将ModalResult值作为ShowModal的返回值返回时，表单将自动关闭。
• 您可以使用全局IsAbortResult、IsAllResult、IsNegativeResult或IsPositiveResult函数对照常见返回值检查返回值。　　

4、使用示例：

//Form1中:
if Form2.ShowModal = mrok then ShowMessage('TaoRoy OK！');

//Form2中 
procedure TForm2.button1Click(Sender: TObject);
begin
   self.ModalResult := mrok;
end;

　　

创建时间：2021.08.31　　更新时间：