Std Groupe

From FreeCAD Documentation
This page is a translated version of the page Std Group and the translation is 100% complete.

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