Std Group/fr: Difference between revisions

From FreeCAD Documentation
mNo edit summary
No edit summary
 
(111 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav/fr
{{Docnav/fr
|[[Std Part/fr|Pièce Std]]
|[[Std_Part/fr|Part]]
|[[PartDesign Body/fr|Corps PartDesign]]
|[[Std_LinkMake/fr|Créer un lien]]
|[[PartDesign_Workbench/fr|Atelier PartDesign]]
|[[Std_Base/fr|Std Base]]
|IconL=Std_Part.png
|IconL=Std_Part.svg
|IconR=Std_LinkMake.svg
|IconC=Workbench_PartDesign.svg
|IconC=Freecad.svg
|IconR=PartDesign Body.png
}}
}}


{{GuiCommand/fr
{{GuiCommand/fr
|Name=Std Group
|Name=Std Group
|Name/fr=Créer un groupe Std
|Name/fr=Std Groupe
|MenuLocation=Arbre de construction → Clic droit sur le nom du document
|MenuLocation=[[Tree_view/fr|Vue arborescente]] → Clic droit sur le nom du document → Créer un groupe...
|Workbenches=Tous
|Workbenches=Tous
|Shortcut=
|Shortcut=
|Version=
|SeeAlso=[[Draft_SelectGroup/fr|Atelier Draft : Sélectionner un groupe]] ; [[Draft_AddToGroup/fr| Atelier Draft : Ajouter au groupe]]
|SeeAlso=[[Std_Part/fr|Std Part]], [[Draft_SelectGroup/fr|Draft Sélection groupée]], [[Draft_AddToGroup/fr|Draft Ajouter au groupe]]
}}
}}


==Description==
==Description==


[[Std_Group/fr|Std Groupe]] (appelé en interne [[App_DocumentObjectGroup/fr|App DocumentObjectGroup]]) est un conteneur à usage général qui vous permet de regrouper différents types d'objets dans la [[Tree_view/fr|vue en arborescence]], quel que soit leur type de données. Il est utilisé comme un simple dossier pour classer et organiser les objets dans votre modèle afin de conserver une structure logique. Les Std Groupes peuvent être imbriqués dans d'autres Std Groupes.
Cette commande vous permet de créer un groupe dans l'arborescence.
<br />
Il peut être utilisé pour organiser la structure de votre modèle.


L'outil Std Groupe n'est pas défini par un atelier particulier mais par le système de base ; il se trouve donc dans la {{MenuCommand|barre d'outils de structure}} qui est disponible dans tous les [[Workbenches/fr|ateliers]].
==Utilisation==


Pour regrouper des objets 3D en une seule unité, avec l'intention de créer des assemblages, utilisez plutôt [[Std_Part/fr|Std Part]].
Faites un clic droit sur le nom de votre document FreeCAD dans l'arborescence et choisissez "créer un groupe".
<br />
Un groupe sera créé automatiquement et donnera l'icône d'un répertoire et un nom choisi automatiquement.
<br />
Vous pouvez renommer le groupe en faisant un clic droit sur le groupe et en choisissant "renommer" ou en utilisant "F2" sur votre clavier.
<br />
Poussez des objets FreeCAD dans le groupe ou sortez-les du groupe en cliquant sur l'objet désiré,
<br />
Maintenez le bouton gauche de la souris enfoncé et utilisez le glisser-déposer pour faire glisser l'objet vers le nouvel emplacement souhaité.
<br />
Tant qu'il y a un symbole du genre "cercle avec une ligne diagonale" sous le curseur, vous ne pouvez pas déposer votre objet à cet emplacement.
<br />
Dès que le signe devient le symbole "plus", il est possible de déposer votre objet à cet emplacement.
<br />


[[File:Std_Group_example.png]]
# Faites un clic droit sur le document actif ou sur un groupe existant dans la [[Document structure/fr|Vue arborescente]] et sélectionnez {{KEY | Créer un groupe ...}}
# Faites glisser des objets dans le groupe.


{{Caption|Divers éléments à l'intérieur de Std Groupes dans la vue en arborescence.}}


<span id="Usage"></span>
[[Image:group_with_objects.png|300px]]
==Utilisation==


# Effectuez l'une des opérations suivantes :
==Options==
#* Cliquez avec le bouton droit de la souris sur le nom du document dans la [[Tree_view/fr|vue en arborescence]] et dans le menu contextuel, choisissez {{MenuCommand|Créer un groupe...}}.

#* Appuyez sur le {{Button|[[Image:Std_Group.svg|16px]] [[Std_Group/fr|Créer un groupe]]}}.
* Pour renommer un groupe, sélectionnez le groupe et pressez sur la touche {{KEY|F2}}, ou faites clic droit et sélectionnez {{KEY|Renommer}}
# Un groupe vide est créé.
# Pour ajouter des objets au groupe, sélectionnez-les dans la [[Tree_view/fr|vue en arborescence]] et faites un glisser/déposer dans le groupe.
# Pour supprimer des objets du groupe, faites-les glisser hors du groupe et déposez-les sur l'étiquette du document en haut de [[Tree_view/fr|vue en arborescence]].
# Vous pouvez également ajouter et supprimer des objets en modifiant la propriété {{PropertyData|Group}} du groupe.


<span id="Properties"></span>
==Propriétés==
==Propriétés==


[[Std_Group/fr|Std Groupe]], appelé en interne [[App_DocumentObjectGroup/fr|App DocumentObjectGroup]] (classe {{incode|App::DocumentObjectGroup}}), est dérivé de l'objet de base [[App_DocumentObject/fr|App DocumentObject]] (classe {{incode|App::DocumentObject}}) et hérite de toutes ses propriétés.
* {{PropertyData/fr|Label}}: Nom du groupe


Std Groupe a les mêmes propriétés que [[App_FeaturePython/fr#Propri.C3.A9t.C3.A9s|App FeaturePython]], qui est l'instance la plus basique d'un [[App_DocumentObject/fr|App DocumentObject]]. Il possède également les propriétés supplémentaires suivantes dans l'éditeur de propriétés de l'[[Property_editor/fr|éditeur de propriétés]]. Les propriétés cachées peuvent être affichées à l'aide de la commande {{MenuCommand|Tout afficher}} du menu contextuel de l'[[Property_editor/fr|éditeur de propriétés]].

<span id="Data"></span>
=== Données ===

{{TitleProperty|Base}}

* {{PropertyData|Group|LinkList}} : liste d'objets référencés. Par défaut vide {{value|[]}}.
* {{PropertyData|_ Group Touched|Bool|Hidden}} : indique si le groupe est touché ou non.

<span id="Scripting"></span>
==Script==
==Script==


{{Emphasis|Voir aussi :}} [[FreeCAD_Scripting_Basics/fr|Débuter avec les scripts]] et [[Scripted_objects/fr|Objets créés par script]].
La commande suivante ajoute un nouveau groupe au document actif:

Voir [[Part_Feature/fr|Part Feature]] pour les informations générales sur l'ajout d'objets au document.

Std Groupe ([[App_DocumentObjectGroup/fr|App DocumentObjectGroup]]) est créé avec la méthode {{incode|addObject()}} du document. Une fois qu'un groupe existe, d'autres objets peuvent y être ajoutés avec les méthodes {{incode|addObject()}} ou {{incode|addObjects()}}.


{{Code|code=
{{Code|code=
import FreeCAD as App
App.ActiveDocument.addObject("App::DocumentObjectGroup","Group")

doc = App.newDocument()
group = App.ActiveDocument.addObject("App::DocumentObjectGroup", "Group")

obj1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
obj2 = App.ActiveDocument.addObject("Part::Box", "Box")

group.addObjects([obj1, obj2])
App.ActiveDocument.recompute()
}}
}}
==Limitations==


{{incode|App::DocumentObjectGroup}} de base n'a pas d'objet Proxy, il ne peut donc pas être entièrement utilisé pour la sous-classification.
La commande a besoin d'un document FreeCAD ouvert pour fonctionner.


Pour la sous-classification de [[Python/fr|Python]], vous devez créer l'objet {{incode|App::DocumentObjectGroupPython}}.

{{Code|code=
import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::DocumentObjectGroupPython", "Name")
obj.Label = "Custom label"
}}

Par exemple, une [[FEM Analysis/fr|analyse FEM]] est un objet {{incode|App::DocumentObjectGroupPython}} avec une icône personnalisée et des propriétés supplémentaires.

<span id="Links"></span>
==Liens==
==Liens==


* [[Arch_tutorial/fr#Organiser_votre_mod.C3.A8le|Cas d'utilisation dans Arch Tutorial]]
* [[Arch_tutorial/fr#Organiser_votre_mod.C3.A8le|Cas d'utilisation dans le tutoriel Arch]]
* [[Document_structure/fr|Structure du document]]
* [[Document_structure/fr|Structure du document]]
* [[Arch_tutorial/fr#Organiser_votre_mod.C3.A8le|Organisation de votre modèle]]
* [[Arch_tutorial/fr#Organiser_votre_mod.C3.A8le|Organisation de votre modèle]]
* [[Ways_To_Organize_Objects/fr|Organiser les objets dans le document]]

==Notes==




{{Docnav/fr
{{Docnav/fr
|[[Std Part/fr|Pièce Std]]
|[[Std_Part/fr|Part]]
|[[PartDesign Body/fr|Corps PartDesign]]
|[[Std_LinkMake/fr|Créer un lien]]
|[[PartDesign_Workbench/fr|Atelier PartDesign]]
|[[Std_Base/fr|Std Base]]
|IconL=Std_Part.png
|IconL=Std_Part.svg
|IconR=Std_LinkMake.svg
|IconC=Workbench_PartDesign.svg
|IconC=Freecad.svg
|IconR=PartDesign Body.png
}}
}}


{{Std_Base_navi{{#translation:}}}}
<div class="mw-translate-fuzzy">
{{Userdocnavi{{#translation:}}}}
{{PartDesign Tools navi/fr}}
</div>

{{Userdocnavi/fr}}

Latest revision as of 10:34, 19 January 2024

Std Groupe

Emplacement du menu
Vue arborescente → Clic droit sur le nom du document → Créer un groupe...
Ateliers
Tous
Raccourci par défaut
Aucun
Introduit dans la version
-
Voir aussi
Std Part, Draft Sélection groupée, Draft Ajouter au groupe

Description

Std Groupe (appelé en interne App DocumentObjectGroup) est un conteneur à usage général qui vous permet de regrouper différents types d'objets dans la vue en arborescence, quel que soit leur type de données. Il est utilisé comme un simple dossier pour classer et organiser les objets dans votre modèle afin de conserver une structure logique. Les Std Groupes peuvent être imbriqués dans d'autres Std Groupes.

L'outil Std Groupe n'est pas défini par un atelier particulier mais par le système de base ; il se trouve donc dans la barre d'outils de structure qui est disponible dans tous les ateliers.

Pour regrouper des objets 3D en une seule unité, avec l'intention de créer des assemblages, utilisez plutôt Std Part.

Divers éléments à l'intérieur de Std Groupes dans la vue en arborescence.

Utilisation

  1. Effectuez l'une des opérations suivantes :
    • Cliquez avec le bouton droit de la souris sur le nom du document dans la vue en arborescence et dans le menu contextuel, choisissez Créer un groupe....
    • Appuyez sur le Créer un groupe.
  2. Un groupe vide est créé.
  3. Pour ajouter des objets au groupe, sélectionnez-les dans la vue en arborescence et faites un glisser/déposer dans le groupe.
  4. Pour supprimer des objets du groupe, faites-les glisser hors du groupe et déposez-les sur l'étiquette du document en haut de vue en arborescence.
  5. Vous pouvez également ajouter et supprimer des objets en modifiant la propriété DonnéesGroup du groupe.

Propriétés

Std Groupe, appelé en interne App DocumentObjectGroup (classe App::DocumentObjectGroup), est dérivé de l'objet de base App DocumentObject (classe App::DocumentObject) et hérite de toutes ses propriétés.

Std Groupe a les mêmes propriétés que App FeaturePython, qui est l'instance la plus basique d'un App DocumentObject. Il possède également les propriétés supplémentaires suivantes dans l'éditeur de propriétés de l'éditeur de propriétés. Les propriétés cachées peuvent être affichées à l'aide de la commande Tout afficher du menu contextuel de l'éditeur de propriétés.

Données

Base

  • DonnéesGroup (LinkList) : liste d'objets référencés. Par défaut vide [].
  • Données (Hidden)_ Group Touched (Bool) : indique si le groupe est touché ou non.

Script

Voir aussi : Débuter avec les scripts et Objets créés par script.

Voir Part Feature pour les informations générales sur l'ajout d'objets au document.

Std Groupe (App DocumentObjectGroup) est créé avec la méthode addObject() du document. Une fois qu'un groupe existe, d'autres objets peuvent y être ajoutés avec les méthodes addObject() ou addObjects().

import FreeCAD as App

doc = App.newDocument()
group = App.ActiveDocument.addObject("App::DocumentObjectGroup", "Group")

obj1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
obj2 = App.ActiveDocument.addObject("Part::Box", "Box")

group.addObjects([obj1, obj2])
App.ActiveDocument.recompute()

App::DocumentObjectGroup de base n'a pas d'objet Proxy, il ne peut donc pas être entièrement utilisé pour la sous-classification.

Pour la sous-classification de Python, vous devez créer l'objet App::DocumentObjectGroupPython.

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::DocumentObjectGroupPython", "Name")
obj.Label = "Custom label"

Par exemple, une analyse FEM est un objet App::DocumentObjectGroupPython avec une icône personnalisée et des propriétés supplémentaires.

Liens