本文翻译至官网,方便读者阅读。Rhino允许开发人员自定义Rhino的大部分接口,这样应用程序就像他们自己的一样。我们称之为自定义皮肤。通过自定义皮肤,您可以更改应用程序图标、启动屏幕、菜单栏、应用程序标题栏、关于框和工具栏。
为Rhino创建自定义皮肤需要创建两个代码模块:
<skin name>.rhs是一个常规的MFC DLL,它实现皮肤的图标、启动屏幕和可选的菜单。在本文中,我们将其称为皮肤DLL。
<skin name>.rhp是一个Rhino实用程序插件,它实现了菜单处理程序(如果需要的话)和一个或多个定制命令。在本文中,我们将其称为皮肤插件。
1.创建皮肤DLL
皮肤DLL是一个常规的MFC DLL,它实现皮肤的图标、启动屏幕和(可选的)菜单。要创建皮肤DLL,请启动Visual Studio并运行Rhino SDK安装的Rhino皮肤DLL向导。
Rhino Skin DLL向导创建了三个类:
一个CWinApp-derived类。 这是DLL的入口点。
一个CRhinoSkinDLL-derived类。 这个类允许您指定Rhino的图标、启动屏幕和菜单。关于这个类的更多信息,请参见rhinoSdkSkinDLL.h。
CSplashWnd类。 这是一个启动屏幕类的基本实现。如果您需要更高级的东西,可以用您自己的实现替换它。
修改项目的图标和启动画面位图。如果你的皮肤要覆盖Rhino的主菜单,那么你也需要创建你的菜单资源。记住填写在DLL's .CPP文件顶部找到的开发人员信息块。这个模块类似于Rhino插件。
2.创建皮肤插件
皮肤插件是实现菜单处理程序(如果需要的话)和一个或多个自定义命令的Rhino实用程序插件。
要创建Rhino实用程序插件,请启动Visual Studio并运行Rhino SDK安装的Rhino插件向导。在选择要运行的向导时,请确保将新项目添加到开放解决方案中,而不是创建新解决方案。这样,您的皮肤项目就被组织到单个解决方案中。如果皮肤DLL提供了一个自定义菜单,那么将插件AppWizard生成的UUID复制到皮肤的CRhinoSkinDLL::SkinPlugInID()成员中。重要!这两个方法必须返回相同的UUID。这是一个关键的步骤,因为它确定了Rhino将加载的主要插件来管理其菜单和扩展Rhino命令集。 在你的CRhinoPlugIn派生类的头文件中添加以下重写:
// Skin DLL menu update handler
void OnInitPlugInMenuPopups(WPARAM wparam, LPARAM lparam);
// Skin DLL menu command handler
BOOL OnPlugInMenuCommand(WPARAM wparam );
// Change to CRhinoPlugIn::load_plugin_at_startup
plugin_load_time PlugInLoadTime();
将以下定义添加到您的CRhinoPlugIn派生类的. cpp文件中。
CRhinoPlugIn::plugin_load_time CSkinPlugInSamplePlugIn::PlugInLoadTime()
{
// Override to change load time to "at startup"
return CRhinoPlugIn::load_plugin_at_startup;
}
如果您的皮肤DLL提供了一个自定义菜单,那么将一个名为MenuHandler.cpp的源文件添加到插件项目中,并将CRhinoPlugIn::OnInitPlugInMenuPopups()和CRhinoPlugIn::OnPlugInMenuCommand()的定义放在这个文件中。重要!在MenuHandler.cpp中包含皮肤DLL的resource.h文件,以提供对皮肤DLL的菜单资源标识符的访问。 例如:
#include "stdafx.h"
#include "MySkinPlugIn.h"
#include "../MySkinDLL/Resource.h"
// Put these to overrides in a separate CPP file so they could
// include the MySkinDLL/Resource.h file without conflicting
// with this projects resource.h
void CSkinPlugInSamplePlugIn::OnInitPlugInMenuPopups(WPARAM wParam, LPARAM lParam)
{
HMENU hMenu = (HMENU)wParam;
if( NULL == hMenu )
return;
switch( GetMenuItemID(hMenu, LOWORD(lParam)) )
{
case IDM_SAMPLE_DISABLE:
::EnableMenuItem( hMenu, IDM_SAMPLE_DISABLE, MF_BYCOMMAND|MF_DISABLED|MF_GRAYED );
break;
case IDM_SAMPLE_SUB_DISABLE:
::EnableMenuItem( hMenu, IDM_SAMPLE_SUB_DISABLE, MF_BYCOMMAND|MF_DISABLED|MF_GRAYED );
break;
// TODO...
}
}
BOOL CSkinPlugInSamplePlugIn::OnPlugInMenuCommand(WPARAM wParam)
{
ON_wString w;
switch( (UINT)wParam )
{
case IDM_SAMPLE_ONE:
w = L"Test Item One";
break;
case IDM_SAMPLE_TWO:
w = L"Two";
break;
case IDM_SAMPLE_DISABLE:
w = L"Disabled";
break;
case IDM_SAMPLE_SUB_A:
w = L"Sub Menu A";
break;
case IDM_SAMPLE_SUB_B:
w = L"Sub Menu B";
break;
case IDM_SAMPLE_SUB_DISABLE:
w = L"Sub Menu Disabled";
break;
default:
return true;
}
::RhinoMessageBox( w, L"OnMenu", MB_OK );
return true;
}
接着,编译皮肤插件。使用Rhino的PluginManager命令加载皮肤插件,这样它就有机会进行自我注册。
3.安装
要安装自定义皮肤,请使用REGEDIT.EXE将scheme键添加到注册表中,该键具有皮肤DLL的路径。例如:
Item | Value |
---|---|
Subkey | HKEY_LOCAL_MACHINE\SOFTWARE\McNeel\Rhinoceros\4.0\Scheme: MySkin |
Entry name | SkinDLLPath |
Type | REG_SZ |
Data value | C:\Src\MySkin\MySkinDLL\Release\MySkinDLL.rhs |
现在,您可以通过使用/scheme= " <上一步中的方案名> "作为命令行参数创建Rhino可执行文件的快捷方式来测试您的自定义皮肤。例如:
"C:\Program Files\Rhinoceros 4.0\System\Rhino4.exe" /scheme=MySkin
4.附加信息
如果用户选择不运行您的带皮肤版本的Rhino,那么您可能希望阻止加载您的带皮肤插件。可以通过检查Rhino使用的方案名是否与您的皮肤的方案名匹配来实现这一点。通过检入插件的CRhinoPlugIn::OnLoadPlugIn()成员来实现这一点。
BOOL CSkinPlugInSamplePlugIn::OnLoadPlugIn()
{
ON_wString scheme = RhinoApp().RegistrySchemeName();
if( scheme.CompareNoCase(L"Scheme: MySkin") != 0 )
return -1; // Fail silently...
// TODO...
return CRhinoUtilityPlugIn::OnLoadPlugIn();
}
合理的脚本代码可以有效的提高工作效率,减少重复劳动。
5.作者答疑
如有疑问,请留言。
提示: 作者知了-联系方式1
提示: 作者知了-联系方式2