Visitar URL original
NotebookObject—Wolfram Documentation

WOLFRAM

Wolfram Language & System Documentation Center

NotebookObject[id]

is an object that represents an open notebook in the front end.

Details
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Properties & Relations  
Possible Issues  
See Also
Tech Notes
Related Guides
Related Workflows
History
Cite this Page

NotebookObject

NotebookObject[id]

is an object that represents an open notebook in the front end.

Details

  • NotebookObject expressions are typically generated by kernel commands such as InputNotebook, EvaluationNotebook, and Notebooks.
  • id is a string that gives a UUID for the notebook that is globally unique. id typically corresponds to the notebook's ExpressionUUID.
  • NotebookObject[id,instance] includes a second UUID for instance that allows distinguishing notebooks using identical values of id, as may happen when working with a copied file.
  • NotebookObject may contain additional, implementation-dependent arguments.
  • In StandardForm and OutputForm, notebook objects are printed so as to indicate the current title of the window that would be used to display the notebook.
  • Functions such as NotebookPrint and NotebookClose take NotebookObject as their argument.
  • Within any open notebook, there is always a current selection. The current selection can be modified by applying functions such as SelectionMove to NotebookObject.
  • A NotebookObject typically remains valid if a notebook is closed and reopened.
  • Information for a NotebookObject may include the following properties:
  • "WindowTitle"notebook's window title
    "MemoryModificationTime"modification time stamp
    "ModifiedInMemory"whether the notebook has been modified since last save
    "StorageSystem"storage location for notebook
    "DocumentType"notebook type
    "MIMEType"application MIME type

Examples

open all close all

Basic Examples  (1)

Functions that create notebooks return NotebookObject expressions:

Wolfram Language code: nb = CreateDocument[{1, x, x ^ 2}]

Functions that act on notebooks take a notebook object as an argument:

Wolfram Language code: SetOptions[nb, WindowTitle -> "Powers"]

Retitling a notebook changes the way the NotebookObject expression is displayed:

Wolfram Language code: nb

The NotebookObject expression itself has not changed:

Wolfram Language code: nb === %1

Scope  (4)

There are several ways to obtain a NotebookObject:

Wolfram Language code: CreateDialog[{TextCell["Click OK to close"], DefaultButton[]}, WindowTitle -> "a dialog"]
Wolfram Language code: InputNotebook[]
Wolfram Language code: First[Notebooks[]]

Open a notebook from a file:

Wolfram Language code: file = FileNameJoin[{$InstallationDirectory, "Documentation", "English", "System", "ExampleData", "document.nb"}];
Wolfram Language code: nb = NotebookOpen[file]

Use the NotebookObject to refer to the notebook in notebook operations:

Wolfram Language code: SelectionMove[nb, Next, Cell]

Read selected data from the notebook:

Wolfram Language code: NotebookRead[nb]

Set options for the notebook:

Wolfram Language code: SetOptions[nb, Magnification -> 1.25]

Set options for the selected cell:

Wolfram Language code: SetOptions[NotebookSelection[nb], CellMargins -> 0]

Insert new material into the notebook:

Wolfram Language code: SelectionMove[nb, After, Cell];NotebookWrite[nb, "2+2"]

Save the notebook:

Wolfram Language code: temp = CreateFile[] <> ".nb"; NotebookSave[nb, temp]

Close the notebook and delete the temporary file:

Wolfram Language code: NotebookClose[nb]; DeleteFile[temp];

Get Information on a notebook object:

Wolfram Language code: Information[EvaluationNotebook[]]

Use NotebookGet to get the underlying notebook expression:

Wolfram Language code: nb = NotebookCreate[]; NotebookGet[nb]

Properties & Relations  (2)

The FullForm of a NotebookObject uses UUIDs to reference the cell:

Wolfram Language code: EvaluationNotebook[]//FullForm

Functions that create or open notebooks typically return the notebook's NotebookObject:

Wolfram Language code: CreateDialog["fish", WindowSize -> Medium]
Wolfram Language code: CreatePalette["fowl", WindowSize -> Medium]
Wolfram Language code: GenerateDocument["ExampleData/BasicTemplate.nb", <|"author" -> "Henry Jones"|>]
Wolfram Language code: NotebookOpen[FileNameJoin[{$InstallationDirectory, "Documentation", "English", "System", "ExampleData", "document.nb"}]]

Possible Issues  (1)

After a notebook has been closed, the NotebookObject can no longer be manipulated:

Wolfram Language code: nb = CreateDocument[{1, x, x ^ 2}]
Wolfram Language code: NotebookClose@nb
Wolfram Language code: NotebookInformation[nb]
Wolfram Research (1996), NotebookObject, Wolfram Language function, https://reference.wolfram.com/language/ref/NotebookObject.html (updated 2022).

Text

Wolfram Research (1996), NotebookObject, Wolfram Language function, https://reference.wolfram.com/language/ref/NotebookObject.html (updated 2022).

CMS

Wolfram Language. 1996. "NotebookObject." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2022. https://reference.wolfram.com/language/ref/NotebookObject.html.

APA

Wolfram Language. (1996). NotebookObject. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/NotebookObject.html

BibTeX

@misc{reference.wolfram_2026_notebookobject, author="Wolfram Research", title="{NotebookObject}", year="2022", howpublished="\url{https://reference.wolfram.com/language/ref/NotebookObject.html}", note=[Accessed: 14-November-2026]}

BibLaTeX

@online{reference.wolfram_2026_notebookobject, organization={Wolfram Research}, title={NotebookObject}, year={2022}, url={https://reference.wolfram.com/language/ref/NotebookObject.html}, note=[Accessed: 14-November-2026]}