Preference options are retrieved from the GetPreference method of the SpssClient
class
and set from the SetPreference method of that class. The option
identifiers have the form SpssClient.PreferenceOptions.<option>
,
where the available option values are listed below--for example, SpssClient.PreferenceOptions.VariableListDisplay
.
All of the settings are strings.
Table 1. General Options
Option |
Valid Settings |
VariableListDisplay |
"labels", "names" |
VariableListSort |
"alphabetical", "file", "measurement" |
MeasurementSystem |
"points", "inches", "centimeters" |
Language |
"Russian", "French", "German", "English", "Italian", "Japanese",
"Korean", "Polish", "SChinese", "Spanish", "TChinese", |
AutoRaise |
"true", "false" |
OutputScroll |
"true", "false" |
OutputSound |
"system_beep", "none", "sound" |
OutputSoundFile |
Path to a custom sound file |
ScientificNotation |
"true", "false" |
DigitGrouping |
Option associated with SET/SHOW DIGITGROUPING. Settings are
"true" or "false". |
OpenSyntaxAtStartup |
"true", "false" |
OnlyOneDataset |
"true", "false" |
OXMLVersion |
Option associated with SET/SHOW XVERSION. Settings are "default"
or the Output XML schema version. |
OutputAttributes |
Option associated with SET/SHOW OATTRS. Settings are "olang",
"eng", or "both". |
Table 2. Viewer Options
Option |
Valid Settings |
TitleFont |
Font name, e.g. "Serif" |
TitleFontSize |
Character representation of integer |
TitleFontBold |
"true", "false" |
TitleFontItalic |
"true", "false" |
TitleFontUnderline |
"true", "false" |
TitleFontColor |
Character representation of integer color |
PageTitleFont |
Font name, e.g. "Serif" |
PageTitleFontSize |
Character representation of integer |
PageTitleFontBold |
"true", "false" |
PageTitleFontItalic |
"true", "false" |
PageTitleFontUnderline |
"true", "false" |
PageTitleFontColor |
Character representation of integer color |
TextOutputFont |
Font name, e.g. "Serif" |
TextOutputFontSize |
Character representation of integer |
TextOutputFontBold |
"true", "false" |
TextOutputFontItalic |
"true", "false" |
TextOutputFontUnderline |
"true", "false" |
TextOutputFontColor |
Character representation of integer color |
DisplayCommandsLog |
"Off", "On" |
LogContents |
"hidden", "shown" |
WarningsContents |
"hidden", "shown" |
WarningsJustification |
"align_left", "align_center", "align_right" |
NotesContents |
"hidden", "shown" |
NotesJustification |
"align_left", "align_center", "align_right" |
TitleContents |
"hidden", "shown" |
TitleJustification |
"align_left", "align_center", "align_right" |
PageTitleContents |
"hidden", "shown" |
PageTitleJustification |
"align_left", "align_center", "align_right" |
PivotTableContents |
"hidden", "shown" |
PivotTableJustification |
"align_left", "align_center", "align_right" |
ChartContents |
"hidden", "shown" |
ChartJustification |
"align_left", "align_center", "align_right" |
TextOutputContents |
"hidden", "shown" |
TreeModelContents |
"hidden", "shown" |
GenericJustification |
"align_left", "align_center", "align_right" |
Orientation |
1 (portrait), 2 (landscape) |
LeftMargin |
Character representation of positive number in units of MeasurementSystem |
RightMargin |
Character representation of positive number in units of MeasurementSystem |
TopMargin |
Character representation of positive number in units of MeasurementSystem |
BottomMargin |
Character representation of positive number in units of MeasurementSystem |
Table 3. Data Options
Option |
Valid Settings |
TransformationMergeOptions |
"calculate_before_used", "calculate_immediately" |
RandomNumberGenerator |
"MC" (compatible with SPSS 12 and earlier), "MT" (Mersenne
Twister) |
DisplayFormatWidth |
Character representation of integer between 1 and 40. |
DisplayFormatDecimal |
Character representation of integer between 0and 15. |
ReadingExternalData |
Character representation of integer between 1 and 40. |
CenturyRangeValue |
"Automatic", "custom" |
CenturyRangeBeginYear |
Character representation of integer between 1582 and 9900. |
Table 4. File Locations
Option |
Valid Settings |
RecordSyntax |
"false", "true" |
RecordMode |
"append", "overwrite" |
SessionJournalFile |
Path to journal file |
TempDir |
Path to temp directory |
RecentFiles |
Recently used file list. Character representation of integer
between 0 and 9. |
DataFiles |
Path to startup folder for data files on Open and Save dialogs |
OtherFiles |
Path to startup folder for other files on Open and Save dialogs |
SpecifiedAndLastFolder |
"true" (last folder used), "false" (specified folder) |
Table 5. Currency Options
Option |
Valid Settings |
CustomOutputFormat |
"CCA", "CCB", "CCC", "CCD", "CCE" |
AllValuesPrefix |
All values prefix |
AllValuesSuffix |
All values suffix |
NegativeValuesPrefix |
Negative values prefix |
NegativeValuesSuffix |
Negative values suffix |
DecimalSeparator |
"comma", "period" |
Table 6. Output Options
Option |
Valid Settings |
OutlineVariables |
"Names", "Labels", "Both" |
OutlineVariableValues |
"Values", "Labels", "Both" |
PivotTableVariables |
"Names", "Labels", "Both" |
PivotTableVariableValues |
"Values", "Labels", "Both" |
OutputDisplay |
"ModelViewer", "Tables" |
Table 7. Chart Options
Option |
Valid Settings |
ChartTemplate |
"On", "Off" |
ChartTemplateFile |
Path to chart template file |
ChartAspectRatio |
Chart aspect ratio |
ChartFont |
Font name, e.g. "Arial" |
ChartFrameInner |
"true", "false" |
ChartFrameOuter |
"true", "false" |
GridLineScale |
"true", "false" |
GridLineCategory |
"true", "false" |
StyleCyclePref |
"ColorsOnly", "PatternsOnly" |
Table 8. Pivot Table Options
Option |
Valid Settings |
ColumnWidth |
"Labels", "Both" (labels and data) |
EditingMode |
"all_tables", "large_tables", "open_tables_window" |
TableRender |
"full", "fast", "light" (alias for "fast") |
Note: For the TableRender
option, "light"
is
deprecated for release 20 and higher, and has the same effect as "fast"
.