Std Group/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(35 intermediate revisions by 3 users not shown)
Line 11: Line 11:
{{GuiCommand/fr
{{GuiCommand/fr
|Name=Std Group
|Name=Std Group
|Name/fr=Std Group
|Name/fr=Std Groupe
|MenuLocation=[[Tree_view/fr|Vue arborescente]] → 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=
|Version=
|SeeAlso=[[Std_Part/fr|Std Part]], [[Draft_SelectGroup/fr|Draft Sélectionner un groupe]], [[Draft_AddToGroup/fr|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 Group]] (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 par aborescence]], 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.
[[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.


L'outil Std Group 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]].
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]].


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]].
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]].
Line 29: Line 29:
[[File:Std_Group_example.png]]
[[File:Std_Group_example.png]]


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


<span id="Usage"></span>
==Utilisation==
==Utilisation==


# Effectuez l'une des opérations suivantes :
# Cliquez sur le nom du document dans la [[tree_view|vue en arborescence]], ouvrez le menu contextuel (clic droit) et choisissez {{Button|Créer un groupe}}.
#* 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...}}.
# Vous pouvez également appuyer sur le bouton {{Button|[[Image:Std_Group.svg|16px]] [[Std_Group/fr|Group]]}} dans la barre d'outils de structure. Un groupe vide est créé.
#* Appuyez sur le {{Button|[[Image:Std_Group.svg|16px]] [[Std_Group/fr|Créer un groupe]]}}.
# Pour ajouter des objets à un groupe, sélectionnez-les dans la [[tree_view/fr|vue en arborescence]] puis faites-les glisser et déposez-les sur le groupe.
# Un groupe vide est créé.
# Pour supprimer des objets d'un groupe, faites-les glisser hors du groupe et sur l'étiquette du document en haut de la [[tree_view/fr|vue en arborescence]].
# 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]].
=== Remarques ===
# Vous pouvez également ajouter et supprimer des objets en modifiant la propriété {{PropertyData|Group}} du groupe.

* L'objet Group n'affecte pas les positions dans la [[3D_view/fr|vue 3D]] des éléments qu'il contient ; il s'agit essentiellement d'un dossier qui permet d'organiser la [[tree_view|vue en arborescence]].
* Le groupe peut également être créé à partir de la [[Python console/fr|console Python]], et sous-classé pour créer des "groupes" spéciaux, comme indiqué dans la section [[Std_Group/fr#Script|Script]].


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


Un [[Std_Group/fr|Std Group]] est appelé en interne [[App_DocumentObjectGroup/fr|App DocumentObjectGroup]] (classe {{incode|App::DocumentObjectGroup}}) et dérive de [[App_DocumentObject/fr|App DocumentObject]] (classe {{incode|App::DocumentObject}}). Il partage donc toutes les propriétés de ce dernier.
[[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.


En plus des propriétés décrites dans [[App_FeaturePython/fr|App FeaturePython]], qui est l'instance la plus élémentaire d'un [[App_DocumentObject/fr|App DocumentObject]], App DocumentObjectGroup a la propriété {{PropertyData|Group}}.
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]].

Ce sont les propriétés disponibles dans l'[[property editor/fr|éditeur de propriétés]]. Les propriétés masquées peuvent être affichées en utilisant la commande {{MenuCommand|Show all}} dans le menu contextuel de l'[[property editor/fr|éditeur de propriétés]].


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


{{TitleProperty|Base}}
{{TitleProperty|Base}}


* {{PropertyData/fr|Label|String}} : nom modifiable par l'utilisateur de cet objet, c'est une chaîne UTF8 arbitraire.
* {{PropertyData|Group|LinkList}} : liste d'objets référencés. Par défaut vide {{value|[]}}.
* {{PropertyData/fr|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>
==== Propriétés cachées de Données ====
==Script==


{{Emphasis|Voir aussi :}} [[FreeCAD_Scripting_Basics/fr|Débuter avec les scripts]] et [[Scripted_objects/fr|Objets créés par script]].
* {{PropertyData/fr|Proxy|PythonObject}} : classe personnalisée associée à cet objet. Cela n'existe que pour la version [[Python/fr|Python]]. Voir [[Std_Group/fr#Script|Script]].

=== Vue ===

{{TitleProperty|Base}}

Voir [[App_FeaturePython/fr|App FeaturePython]] pour les propriétés d'affichage de base.

==== Propriétés cachées de Vue ====

* {{PropertyView/fr|Proxy|PythonObject}} : classe personnalisée associée à cet objet. Cela n'existe que pour la version [[Python/fr|Python]]. Voir [[Std_Group/fr#Script|Script]].

== Héritage ==

Un [[Std Group|Std Group]] est formellement une instance de la classe {{incode|App::DocumentObjectGroup}} dont le parent est le [[App_DocumentObject/fr|App DocumentObject]] ({{incode|App::DocumentObject}} class) et est complété par une extension de groupe.

[[File:FreeCAD_core_objects.svg|800px]]

{{Caption|Diagramme simplifié des relations entre les objets centraux du programme. La classe {{incode|App::DocumentObjectGroup}} est un groupe simple qui utilise l'extension Groupe pour pouvoir contenir tout type d'objet.}}

==Script==


Voir [[Part_Feature/fr|Part Feature]] pour les informations générales sur l'ajout d'objets au document.
{{Emphasis|Voir aussi :}} [[FreeCAD Scripting Basics/fr|Débuter avec les scripts]] et [[scripted objects/fr|Objets créés par script]].


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()}}.
Voir [[Part_Feature/fr|Part Feature]] pour les informations générales sur l'ajout d'objets au document.


Un Std Group ([[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()}} de ce groupe.
{{Code|code=
{{Code|code=
import FreeCAD as App
import FreeCAD as App


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


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


obj.addObjects([bod1, bod2])
group.addObjects([obj1, obj2])
App.ActiveDocument.recompute()
App.ActiveDocument.recompute()
}}
}}
Line 102: Line 81:
{{incode|App::DocumentObjectGroup}} de base n'a pas d'objet Proxy, il ne peut donc pas être entièrement utilisé pour la sous-classification.
{{incode|App::DocumentObjectGroup}} de base n'a pas d'objet Proxy, il ne peut donc pas être entièrement utilisé pour la sous-classification.


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


{{Code|code=
{{Code|code=
Line 112: Line 91:
}}
}}


Par exemple, [[FEM Analysis/fr|Analyse FEM]] est un objet {{incode|App::DocumentObjectGroupPython}} avec une icône personnalisée et des propriétés supplémentaires.
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]]
Line 130: Line 110:
}}
}}


{{Std Base navi{{#translation:}}}}
{{Std_Base_navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

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