TMainMenu - 管理帮助和搜索菜单项答案

【问题标题】：TMainMenu - managing Help and Search menu itemsTMainMenu - 管理帮助和搜索菜单项
【发布时间】：2018-02-22 21:06:07
【问题描述】：

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

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

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

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

如何指定搜索框应位于操作系统创建的帮助菜单项？
或者，我可以指定操作系统不应该自动创建一个帮助菜单项（以便我可以自己创建）？在那里面情况下，我还需要知道如何编程帮助手册。
如果我坚持使用操作系统创建的帮助菜单项，我该如何添加附加子菜单项？

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

【问题讨论】：

标签： macos firemonkey delphi-10.2-tokyo

【解决方案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 字段是在 my 最后一个菜单项上创建的并且帮助位于操作系统自动创建的新菜单项上，虽然功能不标准。

【讨论】：