インタフェース: defaultActions

defaultActions Core インタフェースは、一部のシステムイベントに対して既定値のアクションを公開します。

3ds Max 2008 以降 で使用可能です。

Interface: defaultActions

メソッド:

<boolean>defaultActions.getAction <enum>eventID <&enum array>action   

eventID enums: {#missingExtFiles | #missingDLLs | #missingXRefs | #missingUVW | #unsupportedRendereffect | #invalidXRefFiles} 
action enums: {#logToFile | #logmsg | #abort} 
action is Out parameter

1 番目の引数として指定されたイベント ID で既定値のアクションを取得し、2 番目の参照引数に返します。

成功した場合は true、指定された ID でアクションが見つからなかった場合は false を返します。

<boolean>defaultActions.setAction <enum>eventID <&enum array>action title:<string> oldAction:<&enum array> 

eventID enums: {#missingExtFiles | #missingDLLs | #missingXRefs | #missingUVW | #unsupportedRendereffect | #invalidXRefFiles} 
action enums: {#logToFile | #logmsg | #abort} 
action is In parameter 
title default value: undefined 
oldAction enums: {#logToFile | #logmsg | #abort} 
oldAction default value: #() 
oldAction is Out parameter

1 番目の引数として指定されたイベント ID の既定値のアクションを、2 番目の引数で指定されたアクションに設定します。

オプションの title: 文字列はアクションセットアップに名前を付けるために使用されます。

古いアクションはオプションの oldAction: 引数に返されます。

古いアクションが見つかった場合は true、その ID で以前に定義された古いアクションがなかった場合には false を返します。

例:

--get the default action for missing UVW:
defaultActions.getAction #missingUVW &actions
false
actions --see the result - there are no actions defined
#()
--now set the default action to Log to File:
defaultActions.setAction #missingUVW #(#logToFile) oldAction:oldActionsArray
true
oldActionsArray --see what the previous actions were
#()
--check to see if the new actions are defined:
defaultActions.getAction #missingUVW &actions
true
actions --yes, the default action was set correctly
#(#logToFile)

<boolean>defaultActions.deleteAction <enum>eventID 

eventID enums: {#missingExtFiles | #missingDLLs | #missingXRefs | #missingUVW | #unsupportedRendereffect | #invalidXRefFiles}

1 番目の引数として指定されたイベント ID の既定値のアクションを削除します。

成功の場合は true、削除するアクションが見つからなかった場合は false を返します。

例(上記の例から続きます)

--get the default action for missing UVW:
defaultActions.deleteAction #missingUVW
true
defaultActions.getAction #missingUVW &actions
false
actions --see the content of the actions array - there are none
#()

<integer>defaultActions.getActionCount()

既定値のアクションの数を返します。

<Stringby value>defaultActions.getActionTitle <enum>eventID 

eventID enums: {#missingExtFiles | #missingDLLs | #missingXRefs | #missingUVW | #unsupportedRendereffect | #invalidXRefFiles}

指定されたイベント ID で定義されているアクションのタイトルを返します。

<Stringby value>defaultActions.getActionTitleByIndex <index>index

タイトルが定義されていない場合は空の文字列 "" を返します。

<enum>defaultActions.getActionIDByIndex <index>index 

getActionIDByIndex enums: {#missingExtFiles | #missingDLLs | #missingXRefs | #missingUVW | #unsupportedRendereffect | #invalidXRefFiles}

アクションのタイトルをインデックスによって返します。

<boolean>defaultActions.logEntry <enum>eventID <string>message 

eventID enums: {#missingExtFiles | #missingDLLs | #missingXRefs | #missingUVW | #unsupportedRendereffect | #invalidXRefFiles}

タイトルが定義されていない場合は空の文字列 "" を返します。成功した場合は true、失敗した場合は false を返します。

<void>defaultActions.MsgLogClear <enum>eventID 

eventID enums: {#missingExtFiles | #missingDLLs | #missingXRefs | #missingUVW | #unsupportedRendereffect | #invalidXRefFiles}

アクション ID をインデックスによって返します。

<integer>defaultActions.getMsgLogCount <enum>eventID 

eventID enums: {#missingExtFiles | #missingDLLs | #missingXRefs | #missingUVW | #unsupportedRendereffect | #invalidXRefFiles}

1 番目の引数で指定されたイベント ID に対し、2 番目の引数で指定されたメッセージをログ記録します。

<TSTR by value>defaultActions.getMsgLogMsg <enum>eventID <index>index 

eventID enums: {#missingExtFiles | #missingDLLs | #missingXRefs | #missingUVW | #unsupportedRendereffect | #invalidXRefFiles}

1 番目の引数で指定されたイベント ID に対してログ記録されているインデックス付きのメッセージを返します。

<TSTR by value array>defaultActions.getMsgLogMsgs <enum>eventID 

eventID enums: {#missingExtFiles | #missingDLLs | #missingXRefs | #missingUVW | #unsupportedRendereffect | #invalidXRefFiles}

1 番目の引数で指定されたイベント ID に対するすべてのメッセージを含む配列を返します。

<enum>defaultActions.getMsgLogID <index>index 

getMsgLogID enums: {#missingExtFiles | #missingDLLs | #missingXRefs | #missingUVW | #unsupportedRendereffect | #invalidXRefFiles}

1 番目の引数で指定されたインデックス付きメッセージのログ ID を返します。

<integer>defaultActions.setMsgLogMaxCount <integer>count

メッセージログ内のメッセージの最大数を設定します。