Built-in Mathematica Symbol

PrivateNotebookOptions

This function has not been fully integrated into the long-term Mathematica system, and is subject to change.

PrivateNotebookOptions->{opt₁->val₁, opt₂->val₂, ...}
is an option for notebooks that specifies various low-level notebook settings.

"BackgroundPostScriptRendering"	False	whether graphics are rendered during idle time, even if they are not currently visible on screen
"ColorPalette"	{"RGBColor", 128}	the number of colors used in the screen display when using a screen with 8-bit or lower resolution.
"DoubleBuffer"	True	whether double buffering, a method of reducing flicker while a notebook is being edited, is used for a notebook
"RealTimeMarginAdjustment"	True	whether the size of margins in a notebook is adjusted in real time when the margin settings are changed by dragging the tab on the ruler toolbar
"RealTimeWindowMove"	False	whether the screen display of a notebook is updated in real time as it is dragged across the screen using the mouse
"RealTimeWindowResize"	False	whether the screen display of a notebook is updated in real time while you resize it using the mouse
"SafeFileOpen"	None	whether Mathematica should take any special precautions before opening a notebook
"SafeFileSave"	Prescan	whether Mathematica should take any special precautions before saving the notebook
"ShortBoxForm"	False(Trueon Unix)	whether box expressions, which are used to represent two-dimensional forms in a notebook, are translated into a more compact notation when the notebook is saved

With the default setting "BackgroundPostScriptRendering"->False, graphics are rendered only when they first appear on the screen.

With the setting "BackgroundPostScriptRendering"->True, all unrendered graphics present in a notebook are rendered when the notebook is opened, regardless of whether the graphic is currently displayed on the screen. Rendering occurs concurrently with other activities and generally does not interfere with normal use of the front end. However, it consumes processor resources and may slow down kernel evaluations and other background operations.

With the default setting "DoubleBuffer"->True, two copies of the rendered notebook are stored in memory at all times. While the screen display of the notebook is being updated, the backup copy is displayed on the screen, reducing the flicker caused by the editing changes.

With the default setting "RealTimeMarginAdjustment"->True, cells are adjusted and redrawn in real time as the margin is adjusted. This allows you to see exactly where word wrapping will occur while the adjustment is being made. However, it may be unacceptably slow in some situations.

With the setting "RealTimeMarginAdjustment"->False, the margins are adjusted only after you finish dragging the tab on the ruler toolbar.

With the setting "RealTimeWindowMove"->True, the screen display of a notebook is updated in real time as its position changes.

With the default setting "RealTimeWindowMove"->False, the display of a notebook is updated only after you finish dragging it and release the mouse button.

With the setting "RealTimeWindowResize"->True, the screen display of a notebook is updated in real time while you resize it.

With the default setting "RealTimeWindowResize"->False, the display of a notebook is updated only after you finish resizing it and release the mouse button.

With the setting "SafeFileOpen"->IgnoreCache, Mathematica ignores the file outline cache when opening a notebook. The file outline cache contains information about the structure of the notebook and reduces the time taken to open large notebooks. With the IgnoreCache setting, you can open a notebook even if its file outline cache has become corrupted. This setting has the same effect as the Parse and Load Entire Notebook into Memory before Opening option of the Notebook Options dialog.

With the setting "SafeFileOpen"->Prescan, Mathematica scans the expression for each cell in the notebook to confirm that it starts with the text Cell[. This is a quick way to check for one common sign of file corruption.

With the setting "SafeFileOpen"->None, Mathematica does not take any special precautions before opening a notebook. Use this setting if you want to minimize the time taken to open a notebook.

With the default setting "SafeFileSave"->Prescan, Mathematica estimates the number of bytes in the notebook and checks if adequate disk space is available before saving it. If there is not enough disk space, a message is displayed.

With the setting "SafeFileSave"->TempFile, Mathematica creates and saves a separate copy of the file instead of overwriting the existing copy. This ensures that if you run out of disk space, the last saved version of the file is still available. Once the new copy is successfully saved, the previous copy is deleted.

The TempFile setting is relevant for multiple-user platforms like Unix and Windows 2000. On such platforms, a file save operation may fail even with adequate disk space on the machine if the user's disk quota is exceeded

With the setting "SafeFileSave"->None, Mathematica does not take any special precautions before saving a notebook. Use this setting if you are sure you have adequate disk space for your files.

With the setting "ShortBoxForm"->True, box expressions are saved in a more compact notation called "ShortBoxForm". This reduces the disk space needed to store the notebook.

With the setting "ShortBoxForm"->False, the notation for box expressions is not converted to "ShortBoxForm" when the notebook is saved. "ShortBoxForm", though more compact, is less intuitive, which makes it harder to read and interpret. Hence the conventional notation is preferred when viewing and editing expressions in a notebook from within Mathematica.

For example, an input cell containing the expression a²+b² would be displayed as: Cell[BoxData[\(a\^2 + b\^2\)], "Input"] with "ShortBoxForm"->True, and as Cell[BoxData[RowBox[{SuperscriptBox["a", "2"], "+", SuperscriptBox["b", "2"]}]], "Input"] with "ShortBoxForm"->False.

New in 4.0