{******************************************************************************}
{                       CnPack For Delphi/C++Builder                           }
{                     中国人自己的开放源码第三方开发包                         }
{                   (C)Copyright 2001-2015 CnPack 开发组                       }
{                   ------------------------------------                       }
{                                                                              }
{            本开发包是开源的自由软件，您可以遵照 CnPack 的发布协议来修        }
{        改和重新发布这一程序。                                                }
{                                                                              }
{            发布这一开发包的目的是希望它有用，但没有任何担保。甚至没有        }
{        适合特定目的而隐含的担保。更详细的情况请参阅 CnPack 发布协议。        }
{                                                                              }
{            您应该已经和开发包一起收到一份 CnPack 发布协议的副本。如果        }
{        还没有，可访问我们的网站：                                            }
{                                                                              }
{            网站地址：http://www.cnpack.org                                   }
{            电子邮件：master@cnpack.org                                       }
{                                                                              }
{******************************************************************************}

unit CnSampleSubMenuWizard;
{ |<PRE>
================================================================================
* 软件名称：CnPack IDE 专家包
* 单元名称：简单的子菜单专家演示单元
* 单元作者：CnPack 开发组
* 备    注：该单元演示了一个基本的带子菜单专家应该有的东西
* 开发平台：PWin2000Pro + Delphi 5.01
* 兼容测试：PWin9X/2000/XP + Delphi 5/6/7 + C++Builder 5/6
* 本 地 化：该窗体中的字符串暂不支持本地化处理方式
* 单元标识：$Id$
* 修改记录：2003.09.10 V1.0 何清(Qsoft) hq.com@263.net
*             重载CreateSubActions方法用于创建了菜单专家
*           2003.05.25 V1.0
*               创建单元
================================================================================
|</PRE>}

interface

{$I CnWizards.inc}

uses
  Windows, Messages, SysUtils, Classes, Graphics, Controls, Forms, Dialogs,
  ToolsAPI, IniFiles, CnWizClasses, CnWizUtils, CnWizConsts;

type

//==============================================================================
// 演示用子菜单专家
//==============================================================================

{ TCnSampleSubMenuWizard }

  TCnSampleSubMenuWizard = class(TCnSubMenuWizard)
  private
    IdTool: Integer;
    IdConfig: Integer;
  protected
    function GetHasConfig: Boolean; override;
    procedure SubActionExecute(Index: Integer); override;
    procedure SubActionUpdate(Index: Integer); override;
  public
    constructor Create; override;
    procedure AcquireSubActions; override;
    function GetState: TWizardState; override;
    procedure Config; override;
    procedure LoadSettings(Ini: TCustomIniFile); override;
    procedure SaveSettings(Ini: TCustomIniFile); override;
    class procedure GetWizardInfo(var Name, Author, Email, Comment: string); override;
    function GetCaption: string; override;
    function GetHint: string; override;
  end;

implementation

//==============================================================================
// 演示用菜单专家
//==============================================================================

{ TCnSampleSubMenuWizard }

procedure TCnSampleSubMenuWizard.Config;
begin
  ShowMessage('Test option.');
  { TODO -oAnyone : 在此显示配置窗口 }
end;

constructor TCnSampleSubMenuWizard.Create;
begin
  inherited;

end;

// 必须重载该方法来创建子菜单专家项
procedure TCnSampleSubMenuWizard.AcquireSubActions;
begin
  { TODO -oAnyone : 此处创建子菜单项，字符串请进行本地化处理 }
  IdTool := RegisterASubAction('SampleTool', 'SampleToolCaption', 0,
    'SampleToolHint', 'SampleTool');

  // 创建分隔菜单
  AddSepMenu;

  IdConfig := RegisterASubAction('SampleConfig',
    'SampleConfigCaption', 0, 'SampleConfigHint', 'SampleConfig');
end;

function TCnSampleSubMenuWizard.GetCaption: string;
begin
  Result := 'Test';
  { TODO -oAnyone : 返回专家菜单的标题，字符串请进行本地化处理 }
end;

function TCnSampleSubMenuWizard.GetHasConfig: Boolean;
begin
  Result := True;
  { TODO -oAnyone : 返回专家是否有配置窗口 }
end;

function TCnSampleSubMenuWizard.GetHint: string;
begin
  Result := 'Test hint';
  { TODO -oAnyone : 返回专家菜单提示信息，字符串请进行本地化处理 }
end;

function TCnSampleSubMenuWizard.GetState: TWizardState;
begin
  Result := [wsEnabled];
  { TODO -oAnyone : 返回专家菜单状态，可根据指定条件来设定 }
end;

class procedure TCnSampleSubMenuWizard.GetWizardInfo(var Name, Author, Email, Comment: string);
begin
  Name := 'Test Submenu Wizard';
  Author := 'CnPack Team';
  Email := 'master@cnpack.org';
  Comment := 'Only test';
  { TODO -oAnyone : 返回专家的名称、作者、邮箱及备注，字符串请进行本地化处理 }
end;

procedure TCnSampleSubMenuWizard.LoadSettings(Ini: TCustomIniFile);
begin
  { TODO -oAnyone : 在此装载专家内部用到的参数，专家创建时自动被调用 }
end;

procedure TCnSampleSubMenuWizard.SaveSettings(Ini: TCustomIniFile);
begin
  { TODO -oAnyone : 在此保存专家内部用到的参数，专家释放时自动被调用 }
end;

procedure TCnSampleSubMenuWizard.SubActionExecute(Index: Integer);
begin
  if not Active then Exit;

  if Index = IdTool then
     // Tool 子功能执行体
  else if Index = IdConfig then
    Config;
end;

procedure TCnSampleSubMenuWizard.SubActionUpdate(Index: Integer);
begin
  // 注：如果此处使用 inherited，将会根据当前专家的 Active 来设置
  // 子 Action 的 Enabled、Visible 等属性，如果子 Action 要自己设置
  // 状态，请不要调用 inherited 方法，否则可能会导致 Action 状态闪动
  // inherited;
  
  if Index = IdTool then
  begin
    SubActions[IdTool].Visible := Active;
    SubActions[IdTool].Enabled := Active;
  end
  else if Index = IdConfig then
  begin
    SubActions[IdConfig].Visible := Active;
    SubActions[IdConfig].Enabled := Active;
  end;
end;

initialization
  RegisterCnWizard(TCnSampleSubMenuWizard); // 注册专家

end.
