Std Open: Difference between revisions

From FreeCAD Documentation
No edit summary
(Removed the "Preferences" paragraph.)
 
(51 intermediate revisions by 10 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=Std_Open|Workbenches=All|SeeAlso=[[Std_Save]],[[Std_Export]]}}
<translate>
Synopsis


<!--T:9-->
Description of what the command is doing,
{{Docnav
Description of what the command is doing,
|[[Std_New|New]]
Description of what the command is doing,
|[[Std_RecentFiles|RecentFiles]]
Description of what the command is doing,
|[[Std_File_Menu|Std File Menu]]
Description of what the command is doing,
|IconL=Std_New.svg
Description of what the command is doing,
|IconR=
Description of what the command is doing,
|IconC=Freecad.svg
Description of what the command is doing,
}}
Description of what the command is doing,
Description of what the command is doing,
Description of what the command is doing,
Description of what the command is doing,
Description of what the command is doing,
Description of what the command is doing,
Description of what the command is doing,
Description of what the command is doing,
Description of what the command is doing,
Description of what the command is doing,
Description of what the command is doing,
Description of what the command is doing,
Description of what the command is doing,
Description of what the command is doing,
Description of what the command is doing,


<!--T:1-->
{{GuiCommand
|Name=Std Open
|MenuLocation=File → Open...
|Workbenches=All
|Shortcut={{KEY|Ctrl}}+{{KEY|O}}
|SeeAlso=[[Std_Import|Std Import]], [[Std_New|Std New]]
}}


==Description== <!--T:2-->
{{Template:UnfinishedDocu}}

<!--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.

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

<!--T:11-->
# There are several ways to invoke the command:
#* Press the {{Button|[[Image:Std_Open.svg|16px]] [[Std_Open|Open...]]}} button.
#* Select the {{MenuCommand|File → [[Image:Std_Open.svg|16px]] Open...}} option from the menu.
#* Use the keyboard shortcut: {{KEY|Ctrl}}+{{KEY|O}}.
# Optionally select the correct file format in the dialog box.
# Select a file.
# Press the {{Button|Open}} button.

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

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

==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
|[[Std_New|New]]
|[[Std_RecentFiles|RecentFiles]]
|[[Std_File_Menu|Std File Menu]]
|IconL=Std_New.svg
|IconR=
|IconC=Freecad.svg
}}

</translate>
{{Std_Base_navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 19:43, 20 April 2024

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 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.

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.