## Preferences.SetPreferenceValue

### Description

Sets a value for a specified preference.
Note: The "Interaction.autoinspect" preference cannot be changed permanently through scripting. For more information, see Property Editor Automatic Inspection.

### C# Syntax

    Preferences.SetPreferenceValue( String in_bstrPrefName, Object in_pVal );

### Scripting Syntax

    Preferences.SetPreferenceValue( PreferenceName, Value );

### Parameters

Parameter | Type | Description
--- | --- | ---
PreferenceName | String | The name of the preference to get. The syntax for specifying an individual preference is: "category.preference".
Value | Variant | The value to set.

### Examples

#### 1. Python Example

    #
    # 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.Preferences.GetPreferenceValue("Interaction.autoinspect") )
    # Toggle the orginal value and re-log the value
    app.Preferences.SetPreferenceValue(
            "Interaction.autoinspect",
            not( app.Preferences.GetPreferenceValue("Interaction.autoinspect") )
    );
    app.LogMessage( app.Preferences.GetPreferenceValue("Interaction.autoinspect") )
    # 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. JScript Example

    var app = Application;
    app.LogMessage( app.Preferences.GetPreferenceValue("data_management.projects_auto_import_enable") );
    app.Preferences.SetPreferenceValue("data_management.projects_auto_import_enable", true);
    app.LogMessage( app.Preferences.GetPreferenceValue("data_management.projects_auto_import_enable") );
    app.Preferences.SetPreferenceValue("data_management.projects_auto_import_enable", false);
    app.LogMessage( app.Preferences.GetPreferenceValue("data_management.projects_auto_import_enable") );
    // This script will log something like this:
    // INFO : False
    // INFO : True
    // INFO : False

### See Also

Preferences.GetPreferenceValue SetUserPref Preferences.Categories Preferences.Import Preferences.Export Preferences.RestoreDefault Preferences.SaveChanges