SetUserPref

導入

v1.0

詳細

ユーザ プリファレンスを設定し、以前の設定値を戻します。 これらのユーザ プリファレンス設定の一部は[ユーザ設定]ダイアログ ボックスの設定と同じです。また、その一部にはメイン コントロール パネルから設定できる項目もあります。 使用できる設定のリストについては、UserPreference を参照してください。

注: 「AutoInspectEnabled」(siAutoInspect)プリファレンスを、スクリプティングによって永続的にに変更することはできません。 詳細については、「プロパティ エディタの自動検証」を参照してください。

スクリプト構文

oVariant = SetUserPref( Target, Value );

戻り値

以前の値(更新直前の値)を Variant として戻します。

パラメータ

パラメータ タイプ 説明
Target UserPreference 設定するユーザ プリファレンス。
Value Variant ユーザ プリファレンスの新しい値。 これらの値は、UserPreference パラメータに指定する値により異なります。

各 UserPreference 設定に有効な値タイプのリストについては、UserPreference を参照してください。

1. Python の例

# 

# This example demonstrates how to temporarily change the user's

# AutoInspect preference (if enabled, property pages always pop

# up for objects newly created via command). It also illustrates

# how Softimage automatically reverts any scripting change to this 

# preference after the script runs.

# 

from win32com.client import constants as cns

app = Application

# Current value of AutoInspect

app.LogMessage( app.GetUserPref(cns.siAutoInspect) )

# Toggle the orginal value and re-log the value

app.SetUserPref( cns.siAutoInspect, not(app.GetUserPref(cns.siAutoInspect)) )

app.LogMessage( app.GetUserPref(cns.siAutoInspect) )

# If your AutoInspect preference was enabled originally, the History Log 

# would display the following:

# INFO : True

# INFO : False

# VERBOSE : Restoring preference changed by script: Interaction.autoinspect

# If your AutoInspect preference was disabled originally, the History Log 

# would display the following:

# INFO : False

# INFO : True

# VERBOSE : Restoring preference changed by script: Interaction.autoinspect

2. VBScript の例

' Current value of AutoInspect

Application.LogMessage GetUserPref(siAutoInspect)

' Save old setting while turning on AutoInspect and display the new value

dim prevval

prevval = SetUserPref(siAutoInspect, False)

Application.LogMessage GetUserPref(siAutoInspect)

' Restore former setting and display its value again (explicitly reverting

' back to the original value isn't necessary, as Softimage will do that automatically

' after the script has run its course)

SetUserPref siAutoInspect, prevval

Application.LogMessage GetUserPref(siAutoInspect)

' If your AutoInspect preference was enabled originally, the History Log 

' would display the following:

' 'INFO : "True"

' 'INFO : "False"

' 'INFO : "True"

3. JScript の例

// Get a sphere and switch into T, Local and X/Z modes

CreatePrim("Sphere", "NurbsSurface");

TranslateTool();

SetUserPref("3D_TRANSFO_REFERENTIAL_CHANGED", 2);

SetUserPref("3D_TRANSFO_EDITED_AXIS_CHANGED", 5);

関連項目

GetUserPref Preferences.SetPreferenceValue