App FeaturePython/fr

Introduction
Un objet App FeaturePython, ou officiellement, est une simple instance de App DocumentObject dans Python.

Il s'agit d'un objet simple qui, par défaut, n'a pas beaucoup de propriétés, par exemple, pas de Positionnement ni forme topologique. Cet objet est destiné à un usage général, et en lui donnant des propriétés. Il peut être utilisé pour gérer différents types de données.



Utilisation
App FeaturePython est un objet interne. Il ne peut donc pas être créé à partir de l'interface graphique. Il est censé être sous-classé par des classes qui géreront différents types de données.

Voir Script pour plus d'informations.

Propriétés
Une classe App FeaturePython ( classe) est dérivée de la classe de base App DocumentObject ( classe).Elle partage toutes les propriétés de cette dernière.

En plus des propriétés décrites dans App DocumentObject, FeaturePython possède un fournisseur de vues de base, il apparaît donc dans la vue arborescente.

Voir Propriétés pour tous les types de propriétés que les objets scriptés peuvent avoir.

Ce sont les propriétés disponibles dans l'éditeur de propriétés. Les propriétés masquées peuvent être affichées en utilisant la commande dans le menu contextuel de l'éditeur de propriétés.

Données

 * : une classe personnalisée associée à cet objet.
 * : le nom modifiable par l'utilisateur de cet objet, c'est une chaîne UTF8 arbitraire.
 * : une description plus longue et modifiable par l'utilisateur de cet objet, c'est une chaîne UTF8 arbitraire qui peut inclure des retours à la ligne. Par défaut, c'est une chaîne vide.
 * : une liste d'expressions. Par défaut vide.
 * : affiche ou non l'objet.

Vue
Ces propriétés correspondent aux propriétés basique de la base viewprovider,, qui est héritée par tous les viewprovider du logiciel.


 * : une classe de fournisseur de vue personnalisée associée à cet objet. Cette propriété n'existe que pour les classes capables d'attribuer une classe personnalisée.


 * : il est vide par défaut.
 * : la valeur par défaut est, auquel cas l'objet apparaîtra dans la Vue en arborescence sinon l'objet sera masqué dans l'arborescence. Une fois qu'un objet de l'arborescence est invisible, vous pouvez le revoir en ouvrant le menu contextuel sur le nom du document (clic droit) et en sélectionnant . Ensuite, l'élément masqué peut être choisi et peut être rétabli à.
 * : par défaut, dans ce cas l'objet sera visible dans la Vue 3D s'il a une Shape sinon il sera invisible. Par défaut, cette propriété peut être activée et désactivée en sélectionnant l'objet et en appuyant sur la barre du clavier.


 * : il contrôle la manière dont la sélection s'effectue dans la Vue 3D si l'objet a une Shapeet s'il y a de nombreux objets partiellement couverts par d'autres. La valeur par défaut est, ce qui signifie qu'aucune mise en évidence spéciale ne se produira; signifie que l'objet apparaîtra au-dessus de tout autre objet lorsqu'il est sélectionné;  signifie que l'objet n'apparaîtra en haut que si l'objet entier est sélectionné dans la Vue en arborescence;  signifie que l'objet n'apparaîtra en haut que si un sous-élément (sommet, arête, face) est sélectionné dans la Vue 3D.
 * : il contrôle la façon dont l'objet est mis en évidence s'il a une Shape. Si c'est, la forme entière (sommets, arêtes et faces) sera mise en surbrillance dans la Vue 3D; s'il s'agit de , un cadre de délimitation apparaîtra autour de l'objet et sera mis en surbrillance.

Script
Notions de base sur les scripts FreeCAD, et Objets scriptés.

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

Un App FeaturePython est créé avec la méthode du document.

Par exemple, les éléments Draft Text, Draft Dimension et Proxy pour plan de travail de l'Atelier Draft sont des objets avec une icône personnalisée et des propriétés additionnelles. Ils contiennent des données mais pas une Part TopoShape réelle.

Si l'objet souhaité doit avoir un placement, une forme, une pièce jointe ou d'autres propriétés complexes, il est préférable de créer l'une des classes les plus complexes, par exemple, App GeoFeature, Part Feature ou Part Part2DObject.