objective-c - Cocoa App 帮助手册的目录(侧边栏)

Question

我正在为我的应用程序构建帮助手册，主要使用苹果的文档 here , 但是它似乎有点过时了。在 Yosemite OS X 10.10 中，苹果自己的应用程序有一个可折叠的侧栏，显示帮助包的目录

虽然侧边栏按钮出现在我自己的应用程序中，但我不知道如何访问它。有谁知道如何访问这个侧边栏？并为我们自己的应用程序提供内容？

Answer 1

我刚刚遇到了同样的问题，我不得不在 Apple Mail 的帮助文件中四处挖掘以找出他们使用的是什么。基本上他们用 HTML/CSS 构建了侧边栏，它不是帮助查看器的一部分。

要在帮助查看器中启用“目录”按钮，您需要使用 javascript 函数:

window.HelpViewer.showTOCButton(bool, function, function);

举一个更明确的例子，下面的代码片段将启用 Apple 帮助查看器中的“目录”按钮，并将其链接到函数“toggleNavigation”。

if ("HelpViewer" in window && "showTOCButton" in window.HelpViewer) {

    window.setTimeout(function () {
        window.HelpViewer.showTOCButton(true, toggleNavigation, toggleNavigation);
        window.HelpViewer.setTOCButton(true);
    }, 100);
}

toggleNavigation 函数将包含打开侧边栏的代码。

function toggleNavigation() {
    // YOUR CODE HERE
}

我发现使用 window.onload 似乎不起作用，但是将超时设置为 100 毫秒就可以了。在 Mail 中，Apple 根据示例对两个函数参数使用了等效的“toggleNavigation”函数。当您按下“目录”按钮时会调用第三个参数，但我还没有弄清楚第二个参数的用途。