子メニューへリンクし、アイコンのフラグを保つ¶
既存のスロットを、新しいアイコン付きの子メニューへのリンクに変えます。 スロットのラベル、表示方法、アイコンのフラグは保ちます。
子メニューの UID を
read_pm()またはメニューの一覧から読み取ります。 UID を組み立てないでください。スロットを読み取り、アイコンのフラグ (
#、!、^) をアイコン名から分けます。リンクと、元のフラグを付けた新しいアイコン名を保存します。
before = pme.editing.read_pm(pm_uid, slot_uids=[slot_uid])
slot = before["slots"][0]
# Keep the leading flags and replace only the icon name.
old_icon = slot["icon"]
icon_flags = old_icon[:len(old_icon) - len(old_icon.lstrip("#!^"))]
result = pme.editing.update_slots(
pm_uid,
{slot_uid: {
"mode": "MENU",
"menu_target_uid": child_uid,
"icon": icon_flags + "TOOL_SETTINGS",
"auto_icon": False,
}},
expected_version=before["version"],
expected={slot_uid: slot},
)
assert result["status"] == "committed", result
子メニューの内容の分類に合うアイコンを選んでください。 Vector Menu は Nest の矢印を自身で描画します。
アイコンだけを変更する場合は
modeとmenu_target_uidを省きます。 表示設定は保存値のまま保たれます。 アイコンを変えるために Submenu を Button へ変更する必要はありません。menu_presentationは、リンク先 Regular Menu の配置方法です。 Nest のジェスチャーや Pie Menu の確定の設定とは別の設定です。
確認¶
result["slots"][0]["after"]のmodeが"MENU"、target_pm_uidがchild_uidと等しく、iconが元のフラグで始まっていること。目的のメニューで、アイコンの表示、子メニューへの移動、子メニュー内での選択、 子メニューからの離脱が意図どおりに動くこと。
使用する関数: read_pm()、update_slots()。
アイコンの値は アイコンの値、Menu スロットの text は
Menu スロットの text で説明しています。