Std Open: Difference between revisions

From FreeCAD Documentation
(Marked this version for translation)
({{:=}} Should not be used inside incode template.)
Line 52: Line 52:


<!--T:18-->
<!--T:18-->
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-->
<!--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-->
<!--T:21-->

Revision as of 22:59, 3 February 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 {{{1}}} 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 {{{1}}} 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.