Std Open: Difference between revisions

From FreeCAD Documentation
(Removed "In progress".)
(<nowiki>=</nowiki> Instead of {{:=}})
(21 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>
<!--T:9-->
{{Docnav
{{Docnav
|[[Std_New|Std New]]
|[[Std_New|New]]
|[[Std_Close|Std CloseActiveWindow]]
|[[Std_CloseActiveWindow|CloseActiveWindow]]
|[[Std_File_Menu|Std File Menu]]
|[[Std_File_Menu|Std File Menu]]
|IconL=Std_New.svg
|IconL=Std_New.svg
|IconR=
|IconR=Std_CloseActiveWindow.svg
|IconC=Freecad.svg
|IconC=Freecad.svg
}}
}}
Line 17: Line 18:
|Shortcut={{KEY|Ctrl}}+{{KEY|O}}
|Shortcut={{KEY|Ctrl}}+{{KEY|O}}
|SeeAlso=[[Std_Import|Std Import]], [[Std_New|Std New]]
|SeeAlso=[[Std_Import|Std Import]], [[Std_New|Std New]]
|Version=-
}}
}}


==Description== <!--T:2-->
==Description== <!--T:2-->


<!--T:10-->
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|Std Import]] for more information.
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|Std Import]] for more information.


==Usage== <!--T:6-->
==Usage== <!--T:6-->


<!--T:11-->
# There are several ways to invoke the command:
# There are several ways to invoke the command:
#* Press the {{Button|[[Image:Std_Open.svg|16px]] Std Open}} button.
#* Press the {{Button|[[Image:Std_Open.svg|16px]] [[Std_Open|Std Open]]}} button.
#* Select the {{MenuCommand|File → [[Image:Std_Open.svg|16px]] Open...}} option from the menu.
#* Select the {{MenuCommand|File → [[Image:Std_Open.svg|16px]] Open...}} option from the menu.
#* Use the keyboard shortcut: {{KEY|Ctrl}}+{{KEY|O}}.
#* Use the keyboard shortcut: {{KEY|Ctrl}}+{{KEY|O}}.
Line 34: Line 36:
# Press the {{Button|Open}} button.
# Press the {{Button|Open}} button.


==Options== <!--T:12-->
==Preferences==


<!--T:13-->
* Press {{KEY|Esc}} or the {{Button|Cancel}} button to abort the command.

==Preferences== <!--T:14-->

<!--T:15-->
* The last used file location is stored: {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → General → FileOpenSavePath}}.
* The last used file location is stored: {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → General → FileOpenSavePath}}.


==Scripting== <!--T:16-->

<!--T:17-->
{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].

<!--T:18-->
To open a document use the {{incode|open(filepath)}} method or the {{incode|openDocument(filepath, [hidden<nowiki>=</nowiki>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<nowiki>=</nowiki>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]].


<!--T:19-->
{{Docnav
{{Docnav
|[[Std_New|Std New]]
|[[Std_New|New]]
|[[Std_Close|Std CloseActiveWindow]]
|[[Std_CloseActiveWindow|CloseActiveWindow]]
|[[Std_File_Menu|Std File Menu]]
|[[Std_File_Menu|Std File Menu]]
|IconL=Std_New.svg
|IconL=Std_New.svg
|IconR=
|IconR=Std_CloseActiveWindow.svg
|IconC=Freecad.svg
|IconC=Freecad.svg
}}
}}

Revision as of 03:45, 4 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 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.