Std Open: Difference between revisions

From FreeCAD Documentation
mNo edit summary
(Marked this version for translation)
Line 54: Line 54:
To open a document use the {{incode|open(filepath)}} method or the {{incode|openDocument(filepath, [hidden{{:=}}False])}} method of the FreeCAD application.
To open a document use the {{incode|open(filepath)}} method or the {{incode|openDocument(filepath, [hidden{{:=}}False])}} method of the FreeCAD application.


<!--T:20-->
These methods create and return a document and load a project file into it. The {{incode|filepath}} argument must be a string pointing to an existing file. If the file doesn't exist or the file cannot be loaded an I/O exception is thrown. In this case the created document is kept, but will be empty. If {{incode|hidden{{:=}}True}} is used, the document won't be displayed in the GUI and no tab will appear for it. This allows performing automatic operations on a document and closing it without disrupting the user interface.
These methods create and return a document and load a project file into it. The {{incode|filepath}} argument must be a string pointing to an existing file. If the file doesn't exist or the file cannot be loaded an I/O exception is thrown. In this case the created document is kept, but will be empty. If {{incode|hidden{{:=}}True}} is used, the document won't be displayed in the GUI and no tab will appear for it. This allows performing automatic operations on a document and closing it without disrupting the user interface.


<!--T:21-->
For a scripting example see [[Std_New#Scripting|Std New]].
For a scripting example see [[Std_New#Scripting|Std New]].



Revision as of 16:00, 23 January 2021

Std Open

Menu location
File → Open...
Workbenches
All
Default shortcut
Ctrl+O
Introduced in version
-
See also
Std Import, Std New

Description

The Std Open command opens a file. If the file is not a native FreeCAD file (*.FCStd) its geometry will be imported into a new document. See Std Import for more information.

Usage

  1. There are several ways to invoke the command:
    • Press the Std Open button.
    • Select the File → Open... option from the menu.
    • Use the keyboard shortcut: Ctrl+O.
  2. Optionally select the correct file format in the dialog box.
  3. Select a file.
  4. Press the Open button.

Options

  • Press Esc or the Cancel button to abort the command.

Preferences

  • The last used file location is stored: Tools → Edit parameters... → BaseApp → Preferences → General → FileOpenSavePath.

Scripting

See also: FreeCAD Scripting Basics.

To open a document use the open(filepath) method or the openDocument(filepath, [hidden=False]) method of the FreeCAD application.

These methods create and return a document and load a project file into it. The filepath argument must be a string pointing to an existing file. If the file doesn't exist or the file cannot be loaded an I/O exception is thrown. In this case the created document is kept, but will be empty. If hidden=True is used, the document won't be displayed in the GUI and no tab will appear for it. This allows performing automatic operations on a document and closing it without disrupting the user interface.

For a scripting example see Std New.