スロット¶
スロットは、メニューに保存された一つの項目です。
コマンド、プロパティ、別のメニューへのリンク、レイアウト項目のいずれかを表します。
このページでは、スロットの保存フィールド、Slot Editor の入力、スロットを編集・消去・追加・削除・移動・入れ替え・移送する操作を扱います。
Pop-up Dialog と Floating Panel の行、spacer、Layout Panel は レイアウトの行とパネル で扱います。
read_pm() のメニュー単位の結果は メニュー にあります。
関数 |
用途 |
|---|---|
メニューのスロットを |
|
|
|
スロットをその入力名で返します。 |
|
Auto Icon が各スロットのアイコンを見つけられるかを報告します。 |
|
Slot Editor の保存処理を通してスロットの内容を変更します。 |
|
スロットを残したまま内容を消去します。 |
|
既定の項目を1件追加します。 |
|
項目を1件削除します。 |
|
項目を1件、同じメニュー内で移動します。 |
|
2項目を入れ替えます。 |
|
1項目の内容を別のメニューへ移します。 |
メニューの種類ごとのスロット¶
適用できる操作は、メニューの種類で決まります。
最後の行の種類では read_pm()["editable_slots"] が False です。
これらの種類のスロットは、それぞれ専用の操作で編集します。
メニューの種類 |
スロット |
選べるスロットモード |
操作 |
|---|---|---|---|
Pie Menu ( |
固定 |
|
|
Sticky Key ( |
固定: On Press、On Release |
|
|
Regular Menu ( |
一覧 |
|
|
Stack Key ( |
一覧 |
|
|
Macro Operator ( |
一覧 |
|
|
Modal Operator ( |
一覧 |
|
|
Pop-up Dialog ( |
行 (レイアウトの行とパネル) |
|
このページのすべてのスロット操作 |
Panel Group ( |
専用エディター |
— |
なし。Context Router は |
選べるスロットモード は、Slot Editor のモード選択にあるモードです。
Sticky Key、Stack Key、Macro Operator、Modal Operator のエディターは空のスロットを保存しません。
これらの種類では clear_slots() が clear_unsupported を返します。
専用エディターを持つ種類では、update_slots() と clear_slots() は ValueError を送出し、ほかの操作は拒否されます。
pme.create_pm() で作成したメニューは、エディターの既定のスロットを持ちます。
Macro Operator は空の Command のステップを1つ、Modal Operator は On Invoke のスロットを1つ持ちます。
スロットを増やすには add_slot() を使います。
スロットのスナップショット¶
read_pm() は、メニューのスロットを保存順で slots に返します。
各スロットは、通常の Python 値でできた辞書です。
操作結果に入るスロットの before と after も同じ辞書です。
書き込みでは uid でスロットを指定します。index は現在の位置を示すだけです。
キー |
型 |
値 |
|---|---|---|
|
str |
スロットの UID。メニュー内で一意です。 |
|
int |
メニューの保存スロット一覧での位置。0 から数えます。レイアウト項目も数に入ります。 |
|
bool |
スロットが有効かどうか。 |
|
dict or None |
Layout Panel のアンカーでは |
|
str |
ラベル。 |
|
str |
アイコンのフラグと、その後に続くアイコン名。アイコンの値 を参照。 Modal Operator では、Command スロットと Property スロットのモーダル入力。 モーダル入力 を参照。 |
|
str |
|
|
bool |
Auto Icon。Command スロットでだけ |
|
str |
保存された本文。意味は |
|
str |
Menu スロット: リンク先メニューの UID。名前だけで保存されたリンクと、ほかのモードでは空。 |
|
str |
Menu スロット: リンク先メニューの、最後に確認された名前。 |
|
str |
Regular Menu へリンクする Menu スロット: |
|
bool |
Menu スロット: リンクが Sticky Key を開始したときに Vector Menu を閉じます。 |
|
float |
Menu スロット: 展開したメニューの幅 (ピクセル)。 |
|
float |
Menu スロット: 展開したメニューのオフセット (ピクセル)。 |
|
bool |
Command スロット: Blender のオペレーターではないコマンドを実行した後に、 Undo ステップを追加します。 |
|
str |
ツールチップの文字列。 |
|
bool |
|
|
str |
このスロットの、Vector Menu での Enum の表示方法: |
|
str |
このスロットの Property Split: |
|
bool |
|
|
list[float] |
赤、緑、青。それぞれ 0.0 から 1.0 の scene linear の値です。 ボタンの背景色 を参照してください。 |
>>> pme.editing.read_pm(pm_uid)["slots"][0]
{'uid': 'pmi_2j2ssemr', 'index': 0, 'enabled': True, 'layout_panel': None,
'name': 'Knife', 'icon': '', 'mode': 'COMMAND', 'auto_icon': True,
'text': "bpy.ops.wm.tool_set_by_id(name='builtin.knife')",
'target_pm_uid': '', 'target_pm_fallback_name': '', 'menu_presentation': '',
'menu_sticky_close': False, 'menu_expand_width': -1.0,
'menu_expand_offset_x': 0.0, 'menu_expand_offset_y': 0.0, 'exec_undo': False,
'description_is_expr': False, 'description': '',
'vector_menu_enum_strategy': 'global', 'use_property_split_override': 'inherit',
'button_background_color_enabled': False,
'button_background_color': [0.0, 0.0, 0.0]}
モードごとの text¶
text は保存された文字列です。
直接書き込まず、最後の列の入力を通して編集します。
|
|
入力 |
|---|---|---|
|
空のスロットでは空。Regular Menu ではレイアウト項目:
|
|
|
スロットを使ったときに実行する Python コード。 |
|
|
Blender のプロパティのデータパス。例:
|
|
|
リンク先メニューの名前。先頭に |
|
|
ホットキー文字列: 修飾キー |
|
|
カスタムレイアウトを描画する Python コード。 |
|
|
Modal Operator: オペレーターの起動、確定、キャンセル、更新のときに実行する Python コード。 |
|
Menu スロットの text¶
Menu スロットのリンクは target_pm_uid です。
text の名前は表示名で、名前だけで保存されたリンクの代替にもなります。
接頭辞は、リンク先メニューの表示方法を保存します。
|
意味 |
入力 |
|---|---|---|
|
展開しません。 |
|
|
リンク先メニューを展開します。 |
|
|
リンク先メニューを枠付きで展開します。 |
|
Regular Menu へのリンクは、表示方法を
menu_presentationに保存し、接頭辞を保存しません。 Context Router へのリンクと、Vector Menu から Property へのリンクも接頭辞を保存しません。 このようなリンクに指定したexpand_menu=Trueやuse_frame=Trueは保存されません。 スロットはcommittedになり、その項目についてslot_value_not_retainedを報告します。menu_presentationが空のとき、text が@で始まる Regular Menu へのリンクはSUBMENUとして読み取られます。それ以外はBUTTONとして読み取られます。枠は展開表示に属します。 結果の
expand_menuがFalseになるとき、update_slots()はuse_frame=Trueに対してValueErrorを送出します。 枠付きのスロットにexpand_menu=Falseを設定すると、接頭辞のないリンク先の名前を保存します。 読み戻すとexpand_menu=False、use_frame=Falseです。
アイコンの値¶
icon は、省略できるフラグと、その後に続くアイコン名です。例: #!^TOOL_SETTINGS。
フラグは文字列の一部で、別のフィールドではありません。
フラグ |
意味 |
|---|---|
|
アイコンのみ。ラベルを表示しません。 |
|
非表示。 |
|
チェックボックス風の表示 (対応する場所のみ)。 |
フラグは #、!、^ の順に読み取られます。
この順序から外れたフラグは、名前の一部になります。
名前は TOOL_SETTINGS などの Blender のアイコン識別子、アイコンなしを表す "" または NONE、
カスタム PNG アイコン を表す @filename のいずれかです。
未知の名前は指定どおりに保存されます。
スロットは代替アイコンを表示し、update_slots() は icon_not_found を報告します。
Macro Operator では、Macro を登録するときに、エディターが Command のステップすべてのアイコンを設定します。
Blender の Macro のオペレーターのステップとして実行するものは BLENDER、コードとして実行するものは TEXT です。
これらのステップへの icon の入力は置き換えられます。
2種類のステップは オペレーターのステップとコードのステップ で説明しています。
ボタンの背景色¶
button_background_color は、Blender 自身の色のプロパティと同じく scene linear で保存され、ボタンを描くときに sRGB へ変換されます。
16進のカラーコードや sRGB の色から取った値は、書き込む前に変換します。
変換せずに書き込むと、元の色より明るく描かれます。
def srgb_to_linear(channel):
if channel <= 0.04045:
return channel / 12.92
return ((channel + 0.055) / 1.055) ** 2.4
# sRGB #A83636
color = [srgb_to_linear(value / 255) for value in (0xA8, 0x36, 0x36)]
pme.editing.update_slots(pm_uid, {slot_uid: {
"button_background_color_enabled": True,
"button_background_color": color,
}})
色が描かれるのは、
button_background_color_enabledがTrueの間だけです。ボタンの文字色は変わりません。 選んだ色の上で文字が読めるかは、作者が確かめます。 テーマのボタンの文字色 (
bpy.context.preferences.themes[0].user_interface.wcol_tool.text) と比べ、描かれたメニューでも確認します。
スロットの入力フィールド¶
update_slots() が受け付けるのは、保存フィールドではなく Slot Editor の入力です。
slot_fields() はその説明を返し、read_slot_inputs() は現在の値を返します。
指定しなかった入力は、Slot Editor が保存済みのスロットから読み込む値を保ちます。
入力 |
型 |
保存フィールド |
意味 |
|---|---|---|---|
|
str |
|
スロットモード。 |
|
str |
|
ラベル。 |
|
str |
|
フラグとアイコン名。アイコンの値 を参照。 |
|
bool |
|
Auto Icon。Command スロットでだけ保持されます。 |
|
str |
|
|
|
str |
|
|
|
str |
|
|
|
bool |
|
Command スロットの Undo ステップ。 |
|
str |
|
リンク先メニュー。
名前または UID で指定します。
見つかった場合は |
|
str |
|
リンク先メニューの UID。空でないときは |
|
str |
— |
UID が存在しなくなったリンクを解決するための名前。保存される
|
|
str |
|
|
|
bool |
|
リンクが Sticky Key を開始したときに Vector Menu を閉じます。 |
|
bool |
|
リンク先メニューを展開します。Menu スロットの text を参照。 |
|
bool |
|
展開したメニューの周りに枠を描画します。 |
|
float |
|
展開したメニューの幅。 |
|
float |
同名 |
展開したメニューのオフセット。 |
|
str |
|
Hotkey スロット: キー。 |
|
bool |
|
Hotkey スロット: 修飾キー。 |
|
str |
|
Hotkey スロット: 修飾キーとして押し続ける通常のキー、または |
|
bool |
— |
保存済みのホットキーから読み取られます。どのスロットも保存しないため、
|
|
str |
|
ツールチップの文字列またはコード。 |
|
bool |
|
説明を Python として実行します。 |
|
str |
同名 |
|
|
str |
同名 |
|
|
bool |
同名 |
ボタンの背景色を使います。 |
|
list[float] |
同名 |
0.0 から 1.0 の数値3つ。scene linear の値です。 ボタンの背景色 を参照してください。 |
|
bool |
|
Layout Panel のアンカー: 最初はパネルを閉じた状態で表示します。 |
|
bool |
|
Layout Panel のアンカー: パネルのヘッダーにスロットを置けるようにします。
空のヘッダーを |
|
dict |
|
Modal Operator のみ。モーダル入力 を参照。 |
値は、何かを保存する前に型で検査されます。
文字列と Enum の入力は str を受け付け、Enum の値は slot_fields()[name]["values"] に含まれている必要があります。
bool の入力は True または False だけを受け付けます。
float の入力は有限の int または float を受け付けます。
button_background_color は要素3つの list または tuple を受け付けます。
モーダル入力¶
Modal Operator では、Command スロットと Property スロットがモーダル入力を icon に保存します。
Command スロットは hotkey;expression、キーを使う Property スロットは
hotkey;minimum;maximum;step;expression です。
これらの値は modal_input 入力で編集します。
これらのスロットでは、icon の入力は保存されるモーダル入力に置き換わります。
項目 |
型 |
値 |
|---|---|---|
|
str |
Hotkey スロットと同じ形式のホットキー文字列。既定値は |
|
str |
Property スロットの入力方法: |
|
str |
Display Expression: 結果をモーダルのオーバーレイに表示する Python 式。 |
|
float or None |
プロパティの範囲と刻み幅。 |
指定しなかった項目は保存値を保ちます。
Property スロットの
property_modeを変更すると、MOVEまたはWHEELのキーを設定し、 ホットキーの修飾キーと範囲を保ちます。KEYへ変更するには、hotkeyを明示する必要があります。 明示しない場合、保存はeditor_validationで拒否されます。
# invoke_uid と lens_uid は、Modal Operator から読み取ったスロット UID です。
pme.editing.update_slots(modal_uid, {
invoke_uid: {"mode": "INVOKE", "cmd": "view = C.space_data"},
lens_uid: {"mode": "PROP", "name": "Lens", "prop": "view.lens",
"modal_input": {"property_mode": "WHEEL", "step": 1.0}},
})
INVOKE、UPDATE、FINISH、CANCEL のスロットのコードは、cmd の入力で渡します。
Property スロットのパスは、この例の view のように、On Invoke のスロットが代入した変数から始められます。
スロットをまたいで「開始時の値」を覚える を参照してください。
Property スロットの保存された icon は、モーダル入力を文字列で持ちます。
read_slot_inputs() はそれを modal_input として返します。
スロット保存の結果¶
update_slots() と clear_slots() は同じ形の結果を返します。
ステータスの語は 結果とガード で定義しています。
キー |
型 |
値 |
|---|---|---|
|
str |
下の ステータス を参照。 |
|
bool |
|
|
str |
引数の |
|
int |
呼び出し後のメニューのバージョン。 |
|
list[dict] |
試行したスロットごとに1要素。要求の順に並びます。スロットの要素 を参照。 |
|
list[str] |
保存を試行しなかったスロットの UID。先に実行したエディターのコールバックが、 これらを変更している場合があります。 |
|
list[dict] |
最初の保存より前に見つかった、要求全体の問題。 |
|
dict |
スロットの順序が変わったときに存在します。 |
|
list[dict] |
|
スロットの要素
キー |
型 |
値 |
|---|---|---|
|
str |
スロットの UID。 |
|
str |
|
|
dict |
呼び出し開始時の スロットのスナップショット。 |
|
dict or None |
呼び出し後のスロットのスナップショット。スロットが存在しなくなった場合は |
|
list |
保存処理が出した |
|
list[dict] |
このスロットの問題と警告。 |
ステータス
|
意味 |
|---|---|
|
1つ以上のスロットが |
|
要求したすべてのスロットが |
|
1つ以上のスロットが確定した後、あるスロットが拒否されました。
後続のスロットは |
|
確定したスロットはありません。原因は |
診断
|
原因と追加のキー |
|---|---|
|
|
|
スロット UID がメニューにありません。 |
|
|
|
|
|
|
|
|
|
Slot Editor の検査が入力を拒否しました。 |
|
ほかの診断なしで保存が拒否されました。 |
|
消去が拒否されました。 |
|
警告: |
|
警告: 保存したアイコン名が既知のアイコンではありません。 |
|
警告: スロットは保存されましたが、入力名で読み戻したスロット
( |
stale_version は常に要求全体の診断です。
slot_not_found、stale_slot、clear_unsupported、structural_slot は、最初の保存より前に見つかった場合は要求全体の診断です。
同じ検査は各スロットの前にも再び行われ、そこで失敗するとそのスロットの要素に入ります。
項目操作の結果¶
add_slot()、remove_slot()、move_slot()、swap_slots() は、
すべてのメニューの種類で次のキーを返します。
キー |
型 |
値 |
|---|---|---|
|
str |
下の ステータス を参照。 |
|
bool |
|
|
str |
引数の |
|
int |
呼び出し後のメニューのバージョン。 |
|
list[dict] |
対象の項目: |
|
list |
常に空。 |
|
list[dict] |
|
|
list[str] |
呼び出し前後の、保存順のスロット UID。 |
|
list[dict] |
スナップショットが変わったほかの項目 ( |
|
dict |
|
Pop-up Dialog と Floating Panel の結果には、次のキーも入ります。 行と挿入位置は レイアウトの行とパネル で説明します。
キー |
型 |
値 |
|---|---|---|
|
int |
呼び出し前後のメニューのバージョン。 |
|
list[dict] or None |
呼び出し前後の行。読み取れなかった場合、 |
|
dict or None |
呼び出し前の保存順で解決した隙間。入れ替え、削除、早期の拒否では |
|
list[str] |
追加した項目、削除した項目、index が変わった項目。 |
|
list[dict] |
実際の行とレイアウト項目の変更。整理による変更を含みます。 |
|
str |
|
ステータス
|
意味 |
|---|---|
|
変更が保存され、バージョンが1回増えました。 |
|
|
|
|
|
何も書き込まれていません。原因は |
|
Pop-up Dialog と Floating Panel: 書き込みが失敗し、保存された項目と順序を復元しました。 |
|
Pop-up Dialog と Floating Panel: 書き込みが失敗し、復元を確認できませんでした。
再試行の前に |
診断
|
原因と追加のキー |
|---|---|
|
|
|
一覧での |
|
一覧での |
|
Pop-up Dialog と Floating Panel: |
|
対象または基準項目の UID がメニューにありません。一覧では |
|
固定枠のメニューでの |
|
メニューの種類がこの操作に対応していません。 メニューの種類ごとのスロット を参照。 |
|
|
|
Pop-up Dialog と Floating Panel 以外のメニューでの |
|
|
|
レイアウト項目は、項目として移動・入れ替えできません。 |
|
項目が Layout Panel のアンカーであるか、ヘッダー位置の指定なしで Layout Panel の行の内側が位置に指定されています。 |
|
Layout Panel のヘッダー位置が不正です。レイアウトの行とパネル を参照。 |
|
|
|
保存されたスロット UID が欠けている、不正、または重複しています。 |
|
|
|
警告: 項目が、Header Layout がオフのヘッダーにあるか、そこへ移ります。
|
|
一覧と固定枠: 通常の操作が変更を拒否しました。 |
|
一覧と固定枠: 変更またはそのエディターのフックが例外を送出し、順序を復元しました。 traceback はコンソールに出力されます。 |
|
書き込みが例外を送出しました。 |
|
書き込み失敗後の復元が例外を送出しました。 |
|
書き込み後に、エディターの画面更新が例外を送出しました。保存結果のステータスは維持されます。 |
|
最後の読み戻しが例外を送出しました。 |
競合の確認¶
expected_version は、read_pm() または前の結果から得る、セッション内でだけ有効なメニューのバージョンです。
PME のバージョン管理された編集操作でだけ変わり、すべての変更を検出するわけではありません。
expected は保存値を比較するため、それらの操作の外で行われた変更も検出します。
stale_* が返ったら、読み直して意図した変更を調整してから再試行してください。
操作 |
競合の確認 |
|---|---|
|
|
|
|
一覧での |
|
Pop-up Dialog と Floating Panel での |
|
一覧での |
|
同じ移送の dry run が返した、両方のメニューを含む完全な |
返された expected は、変更せずにそのまま渡してください。
完全なスナップショットで欠けている項目は補完されません。
関数¶
- pme.editing.slot_fields()¶
update_slots()が受け付ける入力の説明を返します。各説明は次のキーを持ちます。
キー
対象
値
typeすべて
"STRING"、"BOOLEAN"、"ENUM"、"FLOAT"、またはmodal_inputの"mapping"descriptionmodal_input以外のすべてエディターのツールチップの文字列。一部の入力では空。
valuesENUM受け付ける識別子。
modeにはEMPTYが含まれません。length配列の入力
要素数。
button_background_colorでは 3fieldsmodal_inputマッピングの項目名
>>> pme.editing.slot_fields()["menu_presentation"] {'type': 'ENUM', 'description': '', 'values': ['BUTTON', 'SUBMENU', 'INLINE']}
補足
結果はメニューの種類によらず同じです。スロットが使う入力は、 そのモードとメニューの種類によって決まります。
- pme.editing.read_slot_inputs(pm_uid, *, slot_uids=None)¶
update_slots()が受け付ける入力名でスロットを返します。値は、Slot Editor が保存済みのスロットから読み込む値です。 本文は
cmd、prop、customに入り、Menu スロットの接頭辞はexpand_menuとuse_frameに入り、ホットキーはkeyと修飾キーに分かれます。- パラメータ:
- 戻り値:
pm_uidとslots。- 戻り値の型:
- 例外:
ValueError -- メニューの UID が欠けている、不正、曖昧のいずれかであるか、 要求したスロット UID がメニューにありません。
結果
キー
型
値
pm_uidstr
引数の
pm_uid。slotslist[dict]
保存順。スロットごとに
uid、index、edit。editdict or None
スロットの入力フィールド の、
modal_input以外のすべての名前。 Modal Operator のスロットではmodal_inputが加わります。空のスロット、 レイアウト項目 (Regular Menu のラベル、spacer、列区切り。行マーカー、 spacer、Layout Panel のアンカー)、専用エディターを持つメニューの種類ではNone。例
あるスロットの内容を別のスロットへ写します。
inputs = pme.editing.read_slot_inputs(pm_uid, slot_uids=[source_uid]) edit = inputs["slots"][0]["edit"] result = pme.editing.update_slots(pm_uid, {target_uid: edit}) assert result["status"] == "committed", result
補足
editは、同じスロットにも別のスロットにも、そのままupdate_slots()へ渡せます。 元のスロットへ渡すと、書き込まずにunchangedを返します。保存された本文に
anyを含む Hotkey スロットは、any=Trueと読み取られます。editを渡し直す前にFalseにしてください。どのスロットもanyを保存せず、update_slots()はTrueに対してValueErrorを送出します。Regular Menu へリンクする Menu スロットでは、
menu_presentationは保存値です。 保存値がない場合は@接頭辞から読み取った値です。ほかのスロットではBUTTONと読み取られます。何も保存しません。
- pme.editing.resolve_auto_icons(pm_uid, *, slot_uids=None)¶
この Blender セッションで Auto Icon がアイコンを見つけられるかを、スロットごとに報告します。
- パラメータ:
- 戻り値:
pm_uidとslots。- 戻り値の型:
- 例外:
ValueError -- メニューの UID が欠けている、不正、曖昧のいずれかであるか、 要求したスロット UID がメニューにありません。
結果
slotsは保存順にスロットを並べます。各要素は次のキーを持ちます。キー
型
値
uid、indexstr, int
スロットの UID と位置。
auto_iconbool
スロットが Auto Icon をオンにした Command スロットのとき
True。sourcedict or None
コマンドがアイコンの元として指すもの。
auto_iconがFalseの場合、 またはコマンドが単独のツールやブラシの切り替えでない場合はNone。resolvedbool
検索でアイコンが見つかったとき
True。manual_iconstr
保存された
icon。resolvedがFalseのとき、スロットはこれを表示します。sourceは次のキーを持ちます。kindキー
値
"tool"toolbuiltin.knifeなどのツール識別子。"tool"space_typeコマンドが指定するスペースタイプ、または
None。"asset"assetブラシアセットの識別子。ライブラリからの相対です。
"asset"library_type、library_identifierライブラリの種類と識別子。識別子は Custom アセットライブラリの名前です。 検索には両方を使います。
>>> pme.editing.resolve_auto_icons(pm_uid, slot_uids=[slot_uid])["slots"][0] {'uid': 'pmi_2j2ssemr', 'index': 0, 'auto_icon': True, 'source': {'kind': 'tool', 'tool': 'builtin.knife', 'space_type': None}, 'resolved': True, 'manual_icon': ''}
補足
検索は、Preferences のアイコン選択が使うものと同じです。 アイコンのプレビューを読み込むことがあるため、
read_pm()には含まれません。何も保存しません。
- pme.editing.update_slots(pm_uid, edits, *, expected_version=None, expected=None)¶
Slot Editor の保存処理を通して、スロットの内容を1つずつ変更します。
各スロットは
editsの順に、個別に確定します。 最初に拒否されたスロットで呼び出しは止まり、それまでの確定は残ります。- パラメータ:
pm_uid (str) -- メニューの UID。
edits (dict) -- スロット UID から、入力名 と値の辞書への対応。 部分指定です。指定しなかった入力は、読み込んだ値を保ちます。空の辞書、 または保存してもスロットの現在の値と完全に同じになる値では、スロットは
unchangedになります。expected_version (int or None) -- 呼び出しが要求するメニューのバージョン。異なる場合は
stale_versionで拒否されます。expected (dict or None) -- スロット UID から、そのスロットが現在持っているべき保存フィールドの値への対応。 スロットのスナップショット の任意の一部を使います。 どの UID も
editsに含まれている必要があります。 最初の保存の前と、各スロットの前に検査します。 値が異なる場合はstale_slotで拒否されます。
- 戻り値:
- 戻り値の型:
- 例外:
TypeError --
edits、expected、スロットの変更、スロットの期待値のいずれかがマッピングではありません。expected_versionが 0 以上の int ではありません。modal_inputがマッピングではないか、未知の項目を指定しています。ValueError -- メニューの UID が欠けている、不正、曖昧のいずれかです。 メニューの種類が専用エディターを持ちます。
expectedがeditsにないスロットを指定しています。 スロット UID の形式が不正です。入力名が未知、modeが"EMPTY"、anyがTrue、または値が型の検査に失敗しました。modal_inputが有限でない数値を含むか、 Modal Operator ではないメニューに指定されています。スロットの結果のexpand_menuがFalseなのにuse_frameがTrueです。 これらはすべて、最初の保存の前に全スロットについて検査します。
例
pm_uid = pme.create_pm(pme.PmCreationSpec("PMENU", name="Tools Pie")).pm_uid before = pme.editing.read_pm(pm_uid) slot = before["slots"][0] result = pme.editing.update_slots( pm_uid, {slot["uid"]: { "mode": "COMMAND", "name": "Knife", "cmd": "bpy.ops.wm.tool_set_by_id(name='builtin.knife')", "auto_icon": True, }}, expected_version=before["version"], expected={slot["uid"]: slot}, ) assert result["status"] == "committed", result
補足
確定したスロットごとに、メニューのバージョンが1回増えます。
unchangedのスロットは何も書き込みません。 バージョンの変更、エディターのフック、画面更新もありません。 比較には、エディターが後で正規化する前の、保存処理が保存する値を使います。 そのため、正規化で元に戻る値 (たとえば、背景色を使わないメニューの種類での背景色) は保存され、committedと報告されます。 そのbeforeとafterは等しくなります。committedのスロットがslot_value_not_retainedを持つことがあります。 保存は成功したものの、要求した項目が要求どおりに読み戻されないことを示します。statusだけでなく、確定したスロットのdiagnosticsも確認してください。modeなしで編集した空のスロットはCOMMANDとして保存され、slot_mode_normalizedを報告します。 空のnameには、エディターが提案する名前が入ることがあります。 入力が空のまま残ると仮定せず、afterの値を読んでください。エディターは保存したスロットを正規化します。結果は
beforeとafterに示されます。 エディターのコールバックは、Macro のアイコンなど、ほかのスロットを変更することがあります。 空の Layout Panel ヘッダーをオンに切り替えると、スロットが1つ追加されます。 これらの変更はside_effectsとstructure_changesに現れます。Pie Menu と Vector Menu での Command の編集は、ほかのスロットとその順序を保ちます。
アイコンだけを編集する場合は
modeとmenu_target_uidを省きます。 ほかの設定は値を保ちます。Layout Panel のアンカーは Menu スロットです。本文のリンク先がないアンカーへの保存は
editor_validationで拒否されます。保存の開始後に起きた例外は traceback を保ち、確定した UID を示す注記が付きます。 スロットの確定後に画面更新が失敗することがあります。再試行の前に
read_pm()を呼び出してください。この呼び出しは Preferences をディスクに保存せず、Undo ステップを追加せず、 スロットを実行しません。保存フィールドへの直接の書き込みや JSON のインポートとは異なります。
関連項目: 子メニューへリンクし、アイコンのフラグを保つ。
- pme.editing.clear_slots(pm_uid, slot_uids, *, expected_version=None, expected=None)¶
スロットを残したまま、その内容を消去します。
各スロットは UID、位置、
enabledを保ちます。 ほかの保存フィールドは、エディターの通常の Clear を通して空のスロットの値に戻ります。- パラメータ:
pm_uid (str) -- メニューの UID。
slot_uids (iterable of str) -- 消去するスロットの UID。この順に処理します。各 UID は1回だけ指定します。
expected_version (int or None) -- 呼び出しが要求するメニューのバージョン。
expected (dict or None) -- スロット UID から保存フィールドの値への対応。
update_slots()と同じです。
- 戻り値:
- 戻り値の型:
- 例外:
TypeError --
slot_uidsが文字列、bytes、マッピングのいずれかであるか、 空でない文字列ではない値を含みます。そのほかの条件はupdate_slots()と同じです。ValueError -- 同じ UID が2回現れます。そのほかの条件は
update_slots()と同じです。
保存フィールド
Clear 後の値
mode"EMPTY"name、icon、text、target_pm_uid、target_pm_fallback_name、menu_presentation、description""auto_icon、menu_sticky_close、exec_undo、description_is_expr、button_background_color_enabledFalsemenu_expand_width-1.0menu_expand_offset_x、menu_expand_offset_y0.0vector_menu_enum_strategy"global"use_property_split_override"inherit"button_background_color[0.0, 0.0, 0.0]例
before = pme.editing.read_pm(pm_uid, slot_uids=[slot_uid]) result = pme.editing.clear_slots( pm_uid, [slot_uid], expected_version=before["version"], expected={slot_uid: before["slots"][0]}, ) assert result["status"] == "committed", result
補足
update_slots()はmode="EMPTY"を受け付けません。 スロットを空にする方法は Clear だけです。各消去の後に、エディターの remove フックが実行されます。
Regular Menu では、消去した項目は区切り線になります。削除はされません。
レイアウト項目は
structural_slotで拒否されます。レイアウト項目は レイアウトの行とパネル の操作で編集します。 エディターが空のスロットを保存しないメニューの種類ではclear_unsupportedを返します。消去したスロットごとに、すでに空だった場合も含め、メニューのバージョンが1回増えます。 空の
slot_uidsはunchangedを返します。 消去の確定後に画面更新が失敗することがあります。 再試行の前にread_pm()を呼び出してください。この呼び出しは Preferences をディスクに保存せず、Undo ステップも追加しません。
- pme.editing.add_slot(pm_uid, *, kind=None, before_uid=None, after_uid=None, expected_version=None, expected=None, use_spacer=False, dry_run=False, header_anchor_uid=None, edge=None)¶
メニューの通常の Add を通して、既定の項目を1件追加します。
新しい項目の内容は
update_slots()で設定します。 その UID はresult["slots"][0]["uid"]です。- パラメータ:
pm_uid (str) -- メニューの UID。
kind (str or None) -- 項目の種類。下の 種類 を参照。
Noneはエディターの既定を使います。before_uid (str or None) -- この項目の前に挿入します。
after_uid (str or None) -- この項目の後に挿入します。
before_uidとafter_uidは多くとも一方だけ指定します。 どちらも指定しない場合は末尾に追加します。expected_version (int or None) -- 呼び出しが要求するメニューのバージョン。
expected (dict or None) -- 前の呼び出しが返した完全な
expected。 保存されたすべての項目を含むため、バージョン管理された操作の外で行われた変更も検出します。use_spacer (bool) -- Pop-up Dialog と Floating Panel のみ。
Trueは自動の spacer を追加します。基準項目の前では新しい項目、spacer、基準項目の順、 基準項目の後では基準項目、spacer、新しい項目の順です。既定値は Preferences の設定にかかわらずFalse。dry_run (bool) -- 追加を検査し、書き込まずに返します。
header_anchor_uid (str or None) -- Pop-up Dialog と Floating Panel のみ: ヘッダーへ追加するときの Layout Panel のアンカーの UID。
before_uid、after_uid(そのヘッダーの項目)、edgeのうちちょうど1つと組み合わせます。レイアウトの行とパネル を参照。edge (str or None) --
header_anchor_uidが指すヘッダーの"START"または"END"。
- 戻り値:
- 戻り値の型:
- 例外:
TypeError --
kindが文字列でもNoneでもありません。expectedがマッピングではありません。基準となる UID が空でない文字列ではありません。use_spacerまたはdry_runが bool ではありません。expected_versionが 0 以上の int ではありません。ValueError -- メニューの UID が欠けている、不正、曖昧のいずれかです。
before_uidとafter_uidの両方が指定されています。Pop-up Dialog と Floating Panel 以外のメニューにheader_anchor_uidまたはedgeが指定されています。header_anchor_uidなしでedgeが指定されています。 ヘッダー位置の指定がちょうど1つではありません。edgeがSTARTでもENDでもありません。 一覧の基準となる UID の形式が不正です。
種類
メニューの種類
kind追加される項目
Regular Menu
ITEM(既定)名前が
SlotのCOMMANDRegular Menu
LABELラベル:
EMPTY、名前Label、textlabelRegular Menu
SPACEREMPTY、textspacerRegular Menu
SEPARATOREMPTY、空の textRegular Menu
COLUMNEMPTY、textcolumnPop-up Dialog、Floating Panel
NoneまたはBUTTON空の Command ボタン
Macro Operator、Modal Operator、Stack Key
Noneエディターの通常の Add で追加される項目
ほかの種類は
slot_kind_unsupportedで拒否されます。例
先に検査してから、Regular Menu の2番目の項目の後に項目を挿入します。
before = pme.editing.read_pm(pm_uid) anchor_uid = before["slots"][1]["uid"] checked = pme.editing.add_slot( pm_uid, after_uid=anchor_uid, expected_version=before["version"], dry_run=True, ) assert checked["status"] == "validated", checked["diagnostics"] added = pme.editing.add_slot( pm_uid, after_uid=anchor_uid, expected_version=checked["version"], expected=checked["expected"], ) assert added["committed"], added["diagnostics"] new_uid = added["slots"][0]["uid"]
補足
既存の項目は UID と相対順序を保ちます。Add はレイアウトのマーカーを変更しません。
Pop-up Dialog と Floating Panel では、
before_uidとafter_uidは保存上の正確な位置です。 項目の間のマーカーを飛ばしません。 自動の spacer はslotsではなく、created_uids、side_effects、structure_changesに現れます。空のメニューには基準項目なしで追加します。 このとき Pop-up Dialog と Floating Panel に行マーカーは作られません。
固定枠のメニューは
fixed_slotsで拒否されます。clear_slots()を使ってください。 一覧はuse_spacer=Trueをunsupported_positionで拒否します。 Regular Menu のkind="SPACER"は別の項目の種類です。dry run は
slots=[]とともにvalidatedまたはrejectedを返します。 UID を割り当てず、保存値とバージョンを変更せず、エディターのフックも画面更新も実行しません。 ラベル、整理、フックの成否は予測しません。 そのexpectedは、dry_runなしの同じ呼び出しに渡せます。追加の確定後に画面更新が失敗することがあります。 再試行の前に
read_pm()を呼び出してください。 この呼び出しは Preferences をディスクに保存せず、Undo ステップも追加しません。
- pme.editing.remove_slot(pm_uid, slot_uid, *, expected_version=None, expected=None, dry_run=False)¶
メニューの通常の Remove を通して、項目を1件削除します。
- パラメータ:
- 戻り値:
項目操作の結果。 削除した項目の
afterはNone。- 戻り値の型:
- 例外:
TypeError --
slot_uidが空でない文字列ではありません。expectedがマッピングではありません。dry_runが bool ではありません。expected_versionが 0 以上の int ではありません。ValueError -- メニューの UID が欠けている、不正、曖昧のいずれかです。一覧で
slot_uidの形式が不正です。
例
checked = pme.editing.remove_slot(pm_uid, slot_uid, dry_run=True) if checked["status"] == "validated": removed = pme.editing.remove_slot( pm_uid, slot_uid, expected_version=checked["version"], expected=checked["expected"], ) print(removed["status"], removed["after_order"])
補足
dry run の
expectedは、一覧では対象の完全なスナップショット、Pop-up Dialog と Floating Panel では完全なコレクションです。 どちらも、dry_runなしの同じ呼び出しで有効なexpectedの値です。最後の項目も削除でき、空の一覧になります。代わりの行や項目は追加されません。
Pop-up Dialog と Floating Panel: Remove は隣接するマーカーを統合し、該当する行の列が 2つ未満のときは subrow の境界を外します。 Layout Panel のアンカーは
panel_rowで拒否されます。 行全体の削除は レイアウトの行とパネル の操作で行います。 Slot Editor で開いている項目はslot_edit_conflictで拒否されます。 ほかの編集中の内容、選択、 クリップボードは保たれます。一覧: エディターの remove フックが実行されます。 拒否された操作でもコールバックによる変更が残ることがあり、
side_effectsに報告されます。 すべてのコールバックが巻き戻されるわけではありません。固定枠のメニューは
fixed_slotsで拒否されます。clear_slots()を使ってください。dry run は
validatedまたはrejectedを返し、対象を等しいbeforeとafterで示します。 UID の修復、エディターのフック、画面更新を実行せず、バージョンも変更しません。 整理やフックの成否は予測しません。削除の確定後に画面更新が失敗することがあります。 再試行の前に
read_pm()を呼び出してください。 この呼び出しは Preferences をディスクに保存せず、Undo ステップも追加しません。
- pme.editing.move_slot(pm_uid, slot_uid, *, before_uid=None, after_uid=None, expected_version=None, row_ref=None, edge=None, new_row=None, expected=None, use_spacer=False, dry_run=False, header_anchor_uid=None)¶
同じメニュー内で、項目を1件別の位置へ移動します。
位置の形式はちょうど1つ指定します。項目は UID と保存値を保ちます。
- パラメータ:
pm_uid (str) -- メニューの UID。
slot_uid (str) -- 項目の UID。
before_uid (str or None) -- この項目の前へ移動します。
after_uid (str or None) -- この項目の後へ移動します。
expected_version (int or None) -- 呼び出しが要求するメニューのバージョン。
row_ref (dict or None) -- Pop-up Dialog と Floating Panel:
read_pm()["rows"]から得た現在の行参照{"kind": "marker" or "first_item", "slot_uid": ...}。edgeが必要です。レイアウトの行とパネル を参照。edge (str or None) --
row_refが指す行、またはheader_anchor_uidが指すヘッダーの"START"または"END"。new_row (str or None) -- Pop-up Dialog と Floating Panel:
"END"は項目を新しい末尾の行へ移動します。expected (dict or None) -- Pop-up Dialog と Floating Panel のみ: 前の呼び出しが返した完全な
expected。use_spacer (bool) -- Pop-up Dialog と Floating Panel のみ。
Trueは通常の Move の spacer の規則を適用します。既定値は Preferences の設定にかかわらずFalse。dry_run (bool) -- 移動を検査し、書き込まずに返します。
header_anchor_uid (str or None) -- Pop-up Dialog と Floating Panel: ヘッダーへ移動するときの Layout Panel のアンカーの UID。
before_uid、after_uid、edgeのうちちょうど1つと組み合わせます。
- 戻り値:
- 戻り値の型:
- 例外:
TypeError --
slot_uidまたは基準となる UID が空でない文字列ではありません。row_refのキーがちょうどkindとslot_uidではありません。 Pop-up Dialog と Floating Panel 以外のメニューにexpectedが指定されています。use_spacerまたはdry_runが bool ではありません。expected_versionが 0 以上の int ではありません。ValueError -- メニューの UID が欠けている、不正、曖昧のいずれかです。 位置の形式の数が1つではありません。
edgeがない、STARTでもENDでもない、またはrow_refもheader_anchor_uidもなしに指定されています。new_rowが"END"ではありません。row_refのkindが不正です。一覧にheader_anchor_uidが指定されています。一覧で UID の形式が不正です。
例
一覧の最後の項目を、先頭の項目の前へ移動します。
before = pme.editing.read_pm(pm_uid) result = pme.editing.move_slot( pm_uid, before["slots"][-1]["uid"], before_uid=before["slots"][0]["uid"], expected_version=before["version"], ) print(result["status"], result["before_order"], result["after_order"])
補足
すでに指定位置にある項目 (自分自身を基準項目にした場合を含む) は
unchangedを返します。 バージョンは変わらず、画面更新も行いません。ほかの項目は相対順序を保ちます。
一覧: 順序が変わると、エディターの move フックが実行されます。Macro の登録も含みます。 フックが失敗すると順序を復元しますが、コールバックの影響をすべて元に戻すわけではありません。
Pop-up Dialog と Floating Panel:
before_uidとafter_uidは、spacer と列の境界を含む保存上の正確な位置です。 行端、新しい行、項目相対の移動では、通常の Move と同じ空行と spacer の整理を行います。 レイアウト項目と Layout Panel のアンカーは、項目として移動できません。 選択と、Slot Editor で編集中の内容は、それぞれの項目に結び付いたままです。固定枠のメニューは
fixed_slotsで拒否されます。swap_slots()を使ってください。 一覧でのrow_ref、new_row、use_spacer=Trueはunsupported_positionで拒否されます。dry run は、書き込み、フック、画面更新なしで同じ検査を行います。保存値、UID、順序、 バージョン、選択、Slot Editor で編集中の内容を変更しません。
validated、unchanged、rejectedを返します。before/afterと順序は保存状態のままで、移動後を予測しません。位置を予約しません。dry_runなしの呼び出しで改めて検査します。未知の UID と古いバージョンは、移動の前に拒否されます。 移動の確定後に画面更新が失敗することがあります。 再試行の前に
read_pm()を呼び出してください。 この呼び出しは Preferences をディスクに保存せず、Undo ステップも追加しません。
- pme.editing.swap_slots(pm_uid, slot_uid, other_slot_uid, *, expected_version=None, expected=None, dry_run=False)¶
同じメニュー内で、2項目の位置を入れ替えます。
Pie Menu、Vector Menu、Pop-up Dialog、Floating Panel で受け付けます。 各 UID は保存値とともに移動し、間の項目は元の位置に残ります。
- パラメータ:
- 戻り値:
項目操作の結果。
slotsに両方の項目が入ります。- 戻り値の型:
- 例外:
TypeError -- UID が空でない文字列ではありません。
dry_runが bool ではありません。expected_versionが 0 以上の int ではありません。固定枠のメニューにexpectedが指定されています。ValueError -- メニューの UID が欠けている、不正、曖昧のいずれかです。 固定枠のメニューで UID の形式が不正です。
例
before = pme.editing.read_pm(pm_uid) first, third = before["slots"][0]["uid"], before["slots"][2]["uid"] checked = pme.editing.swap_slots( pm_uid, first, third, expected_version=before["version"], dry_run=True, ) if checked["status"] == "validated": result = pme.editing.swap_slots( pm_uid, first, third, expected_version=checked["version"], ) print(result["status"], result["after_order"])
補足
両方の UID と、Menu スロットの最終的な配置を書き込みの前に検査します。 入れ替えが成功すると、バージョンが1回増えます。
同じ UID を2つ指定すると、バージョンを変えずに
unchangedを返します。入れ替えまたはエディターのフックが失敗すると、順序を復元します。 フックによるフィールドの変更は、読み戻しに残ることがあります。
Pop-up Dialog と Floating Panel: 入れ替えは通常の Move を担う処理を使い、Add や Move の整理は行いません。 通常の項目とヘッダーの項目、異なるヘッダーの項目どうしも入れ替えられます。
一覧と Sticky Key は
slot_swap_unsupportedで拒否されます。一覧ではmove_slot()を使ってください。dry run は、書き込み、フック、画面更新なしで
validated、unchanged、rejectedを返します。 結果を予約しません。入れ替えの確定後に画面更新が失敗することがあります。 再試行の前に
read_pm()を呼び出してください。 この呼び出しは Preferences をディスクに保存せず、Undo ステップも追加しません。
- pme.editing.transfer_slot(source_pm_uid, source_slot_uid, destination_pm_uid, *, destination_slot_uid=None, before_uid=None, after_uid=None, row_ref=None, edge=None, new_row=None, use_spacer=False, header_anchor_uid=None, expected=None, dry_run=False)¶
1項目の内容を別のメニューへ移し、両方のメニューを報告します。
enabledを含む内容は、通常の Paste の規則に従います。 両方のメニューを保存してから、エディターのフックを実行します。 2つのメニューは異なる必要があります。同じメニュー内ではmove_slot()またはswap_slots()を使ってください。- パラメータ:
source_pm_uid (str) -- 移動元メニューの UID。
source_slot_uid (str) -- 移す項目の UID。
destination_pm_uid (str) -- 移動先メニューの UID。
destination_slot_uid (str or None) -- 固定枠の移動先: 内容を受け取り、自身の UID を保つ空のスロット。
before_uid (str or None) -- 一覧またはレイアウトの移動先: この項目の前に挿入します。
after_uid (str or None) -- 一覧またはレイアウトの移動先: この項目の後に挿入します。
row_ref (dict or None) -- Pop-up Dialog と Floating Panel の移動先:
edgeと組み合わせる現在の行参照。 通常の行は空でもかまいません。edge (str or None) --
row_ref、またはheader_anchor_uidが指すヘッダーの"START"または"END"。new_row (str or None) --
"END": Pop-up Dialog または Floating Panel の移動先の、新しい末尾の行。use_spacer (bool) --
Trueは、項目相対と行端の位置に通常の Move の spacer の規則を適用します。 新しい末尾の行は既存の行設定の規則を使い、追加の spacer は作りません。 既定値は Preferences の設定にかかわらずFalse。header_anchor_uid (str or None) -- 移動先のヘッダーの Layout Panel のアンカー。
before_uid、after_uid、edgeと組み合わせます。expected (dict or None) -- 同じ移送の dry run が返した完全な
expected。Noneは比較を省きます。 その場合も現在の状態は検査します。dry_run (bool) -- 移送を検査し、書き込まずに返します。
- 戻り値:
下で説明する結果。
- 戻り値の型:
- 例外:
TypeError -- メニューまたはスロットの UID が空でない文字列ではありません。移動先の UID が空でない文字列でも
Noneでもありません。use_spacerまたはdry_runが bool ではありません。row_refのキーがちょうどkindとslot_uidではありません。expectedが誤った型の値、または JSON でない値を含みます。ValueError -- 移動先の形式が2つ以上指定されています。
expectedのキーが移送のスナップショットと一致しないか、バージョンが負です。 レイアウトの位置の形式が不正です。
移動先
移動先
位置
固定枠
空のスロットの
destination_slot_uid。Sticky Key のスロットは、COMMANDで text が空のとき空とみなします。一覧
before_uid/after_uidのちょうど一方。空の一覧ではどちらも指定しません。 新しい項目には新しい UID が付きます。Pop-up Dialog、Floating Panel
before_uid/after_uid、edge付きのrow_ref、またはnew_row="END"。空のメニューでは位置を指定しません。 新しい項目には新しい UID が付きます。Layout Panel のヘッダー
header_anchor_uidと、before_uid/after_uidまたはedge。Header Layout がオンでも必要です。オフのヘッダーはオフのままで、header_layout_disabledを報告します。結果
キー
型
値
statusstr
下の ステータス を参照。
committedbool
statusが"committed"のときだけTrue。moveddict or None
確定後:
fromとto。それぞれpm_uidとslot_uidを持ちます。to.slot_uidは受け取った項目です。expecteddict or None
両方のメニュー、対象の引数、リンク先メニューの情報を含む不透明なスナップショット。 JSON を経由して往復しても有効です。 移動元のスロットが見つかる前に拒否された場合は
None。effectslist[dict]
予測した効果と観測した効果。効果 を参照。
losslist[dict]
移されない値。補足 を参照。
diagnosticslist[dict]
codeと詳細。診断 を参照。from、todict
それぞれ一方の側:
pm_uid、保存された項目のコレクションであるbeforeとafter、changed、version_beforeとversion_after。toにはinsertion_positionが加わります。Pop-up Dialog と Floating Panel の側にはbefore_rowsとafter_rowsが加わります。読み取れないafterの値はNone。ステータス
status意味
validateddry_run=Trueで、移送を受け付けられます。何も書き込まれていません。committed両方のメニューが保存されました。各メニューのバージョンは1回増えました。
rejected何も書き込まれていません。原因は
diagnosticsに示されます。restored_failure書き込みが失敗し、両方の保存された項目のコレクションが以前のスナップショットと一致しています。 Macro の登録は
effectsに報告されます。unknown書き込みが失敗し、復元または読み戻しで以前の状態を確認できませんでした。 判断する前に
read_pm()を呼び出してください。自動で再試行しないでください。効果
kind値
predictiondestination_fields: 移動先が受け取る保存フィールド。enabledを含みます。icon_predictionは、移動先がアイコンを計算する場合は"dynamic"、 それ以外は"known"。registrationMacro Operator の登録。
phaseはbefore、after、recoveryのいずれかで、pm_uidと観測した状態を持ちます。hook実行されたエディターのフック:
pm_uidとhook。recoverysaved_restored: 失敗の後に両方のメニューが復元されたかどうか。診断
code原因と追加のキー
menu_identity_unconfirmedメニューの UID が1つのメニューに解決されません。
same_menu移動元と移動先が同じメニューです。
slot_transfer_unsupportedメニューの種類が専用エディターを持つか、スロットのクリップボードを持ちません。
source_identity_unconfirmedsource_slot_uidが移動元メニューにありません。stale_transferexpectedが現在のスナップショットと異なります。source_has_no_content移動元のスロットが空です。
popup_position_requires_popup_menuPop-up Dialog と Floating Panel 以外の移動先に、レイアウトの位置が指定されています。
sticky_slot_role_invalidSticky Key のスロットが On Press でも On Release でもありません。
paste_mode_unsupported移動先が、このメニューの種類からのこのスロットモードを受け付けません。
destination_identity_unconfirmed、destination_occupieddestination_slot_uidが見つからないか、空ではありません。destination_slot_requires_fixed_menu一覧またはレイアウトの移動先に
destination_slot_uidが指定されています。anchor_identity_unconfirmed、destination_anchor_required基準項目が見つからないか、空でない移動先に位置が指定されていません。
slot_not_found、structural_slot、panel_row、row_not_found、position_not_found、panel_anchor_not_found、header_target_mismatch、header_role_requiredレイアウトの移動元または位置が不正です。 項目操作の結果 と同じです。
menu_reference_slot_incompatible、menu_reference_target_mode_not_allowed、menu_reference_self_reference、menu_reference_presentation_not_supportedMenu スロットの解決済みのリンクが、移動先で有効ではありません。
menu_reference_unresolved警告: リンクが見つからないか曖昧なため、元の値を保ちます。
kind。slot_edit_conflict影響を受ける項目を Slot Editor で開いています。移動元、固定枠の移動先、 または整理によって削除・書き換えされるレイアウト項目です。
header_layout_disabled警告: 関係するヘッダーの Header Layout がオフです。
anchor_uid。slot_transfer_failed書き込みが例外を送出しました。
exception_typeとmessage。slot_transfer_restore_failed、slot_transfer_registration_restore_failed復元が例外を送出しました。
statusはunknown。transfer_snapshot_failed、transfer_cleanup_failedメニューの読み取り、または整理の計画が例外を送出しました。
transfer_readback_failed、transfer_rows_readback_failed呼び出し後に、一方の側の読み取りが例外を送出しました。
side。その側のafterまたはafter_rowsはNoneで、ステータスは維持されます。 確定した移送を繰り返さず、メニューを読み直してください。transfer_refresh_failed呼び出し後に画面更新が例外を送出しました。
operation。 確定したステータスは維持されます。macro_registration_read_failedMacro の登録状態の読み取りが例外を送出しました。
例
先に検査してから、一覧またはレイアウトのメニューの末尾へ項目を移します。
destination = pme.editing.read_pm(destination_pm_uid) position = ({"after_uid": destination["slots"][-1]["uid"]} if destination["slots"] else {}) checked = pme.editing.transfer_slot( source_pm_uid, source_slot_uid, destination_pm_uid, **position, dry_run=True, ) if checked["status"] == "validated": result = pme.editing.transfer_slot( source_pm_uid, source_slot_uid, destination_pm_uid, **position, expected=checked["expected"], ) print(result["status"], result["moved"], result["effects"], result["loss"])
固定枠の移動先では、
positionは{"destination_slot_uid": empty_slot_uid}です。Panel のヘッダーでは{"header_anchor_uid": anchor_uid, "edge": "END"}、通常の行では{"row_ref": row_ref, "edge": "END"}です。補足
固定枠の移動元は消去され、UID と
enabledを保ちます。Sticky Key の移動元は、 さらに On Press または On Release の名前と空のコマンドに戻ります。一覧の移動元は、 最後の項目であっても削除されます。layout_panelは移されません。 固定枠の移動元には残り、削除される一覧の移動元とともに失われます。lossがこれを報告します:kindが"layout_panel"、value、transferred(False)、source_removed。移動先エディターのアイコンの規則が適用されます。 Pop-up Dialog と Floating Panel はアイコンのフラグを保ち、Macro Operator はアイコンを計算し、ほかの種類はフラグを外します。 移動先がボタンの背景色を使わない場合、背景色は消去されます。
Regular Menu のラベルとレイアウトのマーカーは、基準項目にはできますが、移す項目にはできません。 Layout Panel のアンカーは移せません。 そのヘッダーの項目は、オフのヘッダーからでも移せます。
レイアウトの整理は、挿入と削除の境界、および空になった移動元の行を対象にします。 無関係な空行と離れた spacer は残ります。 マーカーのない先頭行が空になると、Move と同じく次の行マーカーを吸収します。 これは
remove_row()とは異なります。 最後の内容を移すと、空のメニューになることがあります。最後のヘッダー項目を移しても、 アンカーとその空のヘッダーは残ります。移送の後は行参照を読み直してください。見つからない、または曖昧なメニューのリンクは、
menu_reference_unresolvedとともに元の値を保ちます。 一意に解決したリンクが移動先で有効でない場合は、書き込みの前に拒否されます。影響を受ける項目を Slot Editor で編集中の場合、呼び出しは拒否されます。 ほかの編集中の内容、クリップボード、選択は保たれます。
dry run は UID を割り当てず、バージョンを初期化せず、エディターのフックも画面更新も実行しません。
beforeとafterは変更前の保存値のままで、整理と新しい UID は予測しません。 Macro のアイコンと登録は、呼び出しの後にだけ観測されます。画面更新が失敗しても、確定したステータスは維持されます。 この呼び出しは Preferences をディスクに保存せず、Undo ステップも追加しません。