Q100098：如何通过创建自定义选项卡来修改 Katana 的用户界面

  1. Foundry
  2. Katana
  3. 工作流程帮助

概括

本文演示了如何创建自己的自定义选项卡类型，并从Katana的主菜单“选项卡”访问它。

更多信息

要创建自定义标签页，您需要：

1. 定义一个继承自UI4.Tabs.BaseTab类，并为其定义自己的控件布局。
2. 将该类注册为Katana Panel类型的插件

以下是一些用 Python 编写的示例，用以说明上述内容：

Katana 8.0 
from Katana import UI4
from PySide6 import QtWidgets

class MyCustomTab(UI4.Tabs.BaseTab):

    def __init__(self, parent):
        UI4.Tabs.BaseTab.__init__(self, parent)

       label = QtWidgets.QLabel('This is MyCustomTab')
        label.setObjectName('label')
        label.setStyleSheet('font-weight: bold; '
                            'font-size: 18pt; '
                            'font-style: italic;')

       hLayout = QtWidgets.QHBoxLayout()
        hLayout.setObjectName('hLayout')
        hLayout.addStretch()
        hLayout.addWidget(label)
        hLayout.addStretch()

       vLayout = QtWidgets.QVBoxLayout()
        vLayout.setObjectName('vLayout')
        vLayout.addLayout(hLayout)

        self.setLayout(vLayout)

PluginRegistry = [
    ('KatanaPanel', 2.0, 'MyCustomTab', MyCustomTab),
    ('KatanaPanel', 2.0, ' Custom/MyCustomTab ', MyCustomTab),
]
Katana 7.5 及以上
from Katana import UI4
from PyQt5 import QtWidgets

class MyCustomTab(UI4.Tabs.BaseTab):

    def __init__(self, parent):
        UI4.Tabs.BaseTab.__init__(self, parent)

       label = QtWidgets.QLabel('This is MyCustomTab')
        label.setObjectName('label')
        label.setStyleSheet('font-weight: bold; '
                            'font-size: 18pt; '
                            'font-style: italic;')

       hLayout = QtWidgets.QHBoxLayout()
        hLayout.setObjectName('hLayout')
        hLayout.addStretch()
        hLayout.addWidget(label)
        hLayout.addStretch()

       vLayout = QtWidgets.QVBoxLayout()
        vLayout.setObjectName('vLayout')
        vLayout.addLayout(hLayout)

        self.setLayout(vLayout)

PluginRegistry = [
    ('KatanaPanel', 2.0, 'MyCustomTab', MyCustomTab),
    ('KatanaPanel', 2.0, ' Custom/MyCustomTab ', MyCustomTab),
]
 
 
登记

为了在用户界面中看到选项卡类型，请将 Python 代码保存到 .py 文件中，并将其放置在添加到$KATANA_RESOURCES环境变量的目录的Tabs 子文件夹中。

以这种方式注册的选项卡类型将显示在Katana主菜单栏的“选项卡”菜单中，以及Katana布局中每个窗格的“添加选项卡”菜单中。
注意：您可以使用类似路径的标签类型名称（例如Custom/MyCustomTab ）对菜单中的标签类型进行分组。但是，请注意，在Katana 3.0v1 及更高版本中，标签还会根据标签插件的搜索路径组织到不同的部分中，这意味着从不同资源路径加载的标签插件不会被分组到同一个子菜单下。

每个自定义标签页文件夹都会被归入一个独立的章节。这些章节可以设置标题，您可以通过在KATANA _RESOURCES目录下的Tabs 文件夹中放置一个名为separatorTitle.txt的文件来自定义标题。例如，如果您想要将“API 示例标签页”作为分隔符标题，只需在separatorTitle.txt文件中输入“API 示例标签页”，结果如下所示：

mceclip1.png
注意：要拥有多个自定义选项卡部分，您必须为KATANA _RESOURCES分配多个不同的目录，每个目录下都有自己的选项卡文件夹。这是因为Katana只会查找选项卡文件夹，并且每个选项卡文件夹只接受一个separatorTitle.txt文件，Katana 无法识别子文件夹。有关向KATANA _RESOURCES添加新路径的更多信息，请参阅Katana资源安装指南。

    我们很遗憾听到

    请告诉我们