Std Group/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
Line 43: Line 43:
==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.
<div class="mw-translate-fuzzy">
Un [[Std_Group/fr|Std Groupe]] 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.
</div>


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">

Revision as of 16:11, 23 February 2022

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 des 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 Template:Bouton.
  2. Un groupe vide est créé.
  3. Pour ajouter des objets au groupe, sélectionnez-les dans la Vue en arborescence, et faites-les glisser et déposez-les 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 l'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.

En plus des propriétés décrites dans App FeaturePython, qui est l'instance la plus élémentaire d'un App DocumentObject, App DocumentObjectGroup a la propriété DonnéesGroup.

Données

Base

  • DonnéesLabel (String) : nom modifiable par l'utilisateur de cet objet, c'est une chaîne UTF8 arbitraire.
  • DonnéesGroup (LinkList) : liste d'objets référencés. Par défaut vide [].

Script

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

Un 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() de ce groupe.

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.

Par conséquent, pour la sous-classe 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, Analyse FEM est un objet App::DocumentObjectGroupPython avec une icône personnalisée et des propriétés supplémentaires.

Liens