3

在 OSX 中运行我的 Firemonkey 应用程序，搜索框会自动出现在我的最后一个菜单项上，我将其标记为“帮助”。到目前为止一切顺利，因为带有搜索框的帮助菜单是 OSX 的标准配置。

接下来，我需要添加一个帮助文件。我购买了一个令人印象深刻的实用程序Help Crafter，我用它快速轻松地制作了 Apple HelpBook。我将 HelpBook 捆绑包放入主应用程序的 Resources 文件夹中。然后我在 IDE 中使用 Project|Options|Version Info 来编辑 Info.plist 文件。我在 Info.plist 中添加了两个键 CFBundleHelpBookFolder 和 CFBundleHelpBookName 以指向我的 HelpBook。

运行我的应用程序，我现在发现我有两个帮助菜单项——一个是我编程的，另一个显然是由 Mac OS 自动创建的，并带有一个子菜单项，可以显示我的帮助手册。令我惊讶的是，我现在无需任何编码即可获得工作帮助。

接下来，我想删除我创建的帮助菜单项以消除重复。但是搜索框仍然位于我的帮助菜单项下，而不是操作系统创建的帮助菜单项上。当我删除我的帮助菜单项时，搜索框重新定位到我现在创建的最后一个菜单项。

  1. 如何指定搜索框应位于操作系统创建的帮助菜单项上？

  2. 或者，我是否可以指定操作系统不应该自动创建帮助菜单项（以便我可以自己创建）？在那种情况下，我还需要知道如何对 HelpBook 的加载进行编程。

  3. 如果我坚持使用操作系统创建的帮助菜单项，如何向其中添加其他子菜单项？

从Apple 文档中可以看出，帮助和搜索功能是在注册帮助手册时由操作系统提供的。但是这两个功能应该在同一个菜单项上。我想知道这是否可能是他们被拆分的 Firemonkey 错误。

4

1 回答 1

1

我的问题分为三个部分。我对 1 和 3 没有运气，但我对 2 有部分解决方案。

为了防止操作系统自动创建帮助菜单，只需删除 Info.plist 中的 CFBundleHelpBookFolder 和 CFBundleHelpBookName 键。然后在 FormCreate 中完成了 HelpBook 的注册：

var
{$IFDEF MACOS}
  HelpBundle: NSBundle;
  AppBundle: NSBundle;
  Path: string;
  HelpReg: Boolean;
{$ENDIF}
begin
{$IFDEF MACOS}
  HelpMgr := TNSHelpManager.Create; // HelpMgr declared as a global variable
  AppBundle := TNSBundle.Wrap(TNSBundle.OCClass.mainBundle);
  Path := AppBundle.bundlePath.UTF8String +
    '/Contents/Resources/MyAppHelp.help';
  HelpBundle := TNSBundle.Wrap(TNSBundle.OCClass.bundleWithPath(StrToNSSTR(Path)));
  HelpReg := HelpMgr.registerBooksInBundle(HelpBundle);
  if not(HelpReg) then
    ShowMessage('Failed to register Help Book');
{$ENDIF}

为了打开 HelpBook，我将以下代码放在相应子菜单项的 OnClick 事件中（即 Help|MyApp Help）：

HelpMgr.openHelpAnchor(StrToNSSTR('Page0'), 
        StrToNSSTR('com.mycompany.myapp.help'));

这种方法导致Spotlight for Help字段自动添加到帮助菜单中。不幸的是，Spotlight for Help 不再索引我的 HelpBook。使用我第一次尝试的方法（使用我原始帖子中描述的 Info.plist），Spotlight for Help 确实索引了我的 HelpBook，但正如我所报告的，Spotlight 字段是在我的最后一个菜单项上创建的，Help 是在一个新菜单上由操作系统自动创建的项目，虽然功能是非标准的。

于 2017-09-18T06:41:00.300 回答