Property/fr: Difference between revisions
(établi -> atelier (french for workbench)) |
Renatorivo (talk | contribs) No edit summary |
||
(36 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
|||
Une '''propriété''' est une pièce d'information comme un nombre ou une chaîne de texte, qui est rattachée à un document FreeCAD ou un objet dans un document. Les propriétés peuvent être affichées et - si c'est permis - modifiées avec l'[[property editor/fr|éditeur de propriétés]]. |
|||
== Introduction == |
|||
Les propriétés jouent un rôle important dans FreeCAD, puisqu'il est conçu dès le départ pour travailler avec des objets paramétriques, qui sont des objets définis seulement par leurs propriétés. |
|||
Une [[Property/fr|propriété]] est une information, telle qu'un nombre ou une chaîne de texte, attachée à un document FreeCAD ou à un objet d'un document. Les propriétés peuvent être visualisées et modifiées avec l'[[Property editor/fr|éditeur de propriétés]]. |
|||
Les [[scripted objects/fr|objets scriptés]] personnalisés dans FreeCAD peuvent avoir des propriétés des types suivants : |
|||
Les propriétés jouent un rôle très important dans FreeCAD. Comme les objets dans FreeCAD sont "paramétriques", cela signifie que leur comportement est défini par leurs propriétés et par la manière dont ces propriétés sont utilisées comme entrée pour leurs méthodes de classe. |
|||
Boolean |
|||
Float |
|||
FloatList |
|||
FloatConstraint |
|||
Angle |
|||
Distance |
|||
Integer |
|||
IntegerConstraint |
|||
Percent |
|||
Enumeration |
|||
IntegerList |
|||
String |
|||
StringList |
|||
Link |
|||
LinkList |
|||
Matrix |
|||
Vector |
|||
VectorList |
|||
Placement |
|||
PlacementLink |
|||
Color |
|||
ColorList |
|||
Material |
|||
Path |
|||
File |
|||
FileIncluded |
|||
PartShape |
|||
FilletContour |
|||
Circle |
|||
== Tous les types de propriétés == |
|||
Les [[scripted objects/fr|Objets créés par script]] personnalisés dans FreeCAD peuvent avoir des propriétés des types suivants : |
|||
{{docnav/fr|Personnaliser l'interface|Travailler avec les ateliers}} |
|||
{{Code|code= |
|||
Bool |
|||
Float |
|||
FloatList |
|||
FloatConstraint |
|||
Angle |
|||
Distance |
|||
ExpressionEngine |
|||
Integer |
|||
IntegerConstraint |
|||
Percent |
|||
Enumeration |
|||
IntegerList |
|||
String |
|||
StringList |
|||
Length |
|||
Link |
|||
LinkList |
|||
LinkSubList |
|||
Matrix |
|||
Vector |
|||
VectorList |
|||
VectorDistance |
|||
Placement |
|||
PlacementLink |
|||
PythonObject |
|||
Color |
|||
ColorList |
|||
Material |
|||
Path |
|||
File |
|||
FileIncluded |
|||
PartShape |
|||
FilletContour |
|||
Circle |
|||
}} |
|||
En interne, le nom de la propriété est préfixé par {{incode|App::Property}}: |
|||
{{languages/fr | {{en|Property}} {{es|Property/es}} {{de|Property/de}} {{pl|Property/pl}} {{se|Property/se}} {{ru|Property/ru}} }} |
|||
{{Code|code= |
|||
App::PropertyBool |
|||
App::PropertyFloat |
|||
App::PropertyFloatList |
|||
... |
|||
}} |
|||
Rappelez-vous qu'il s'agit de propriétés {{Emphasis|types}}. Un même objet peut avoir plusieurs propriétés du même type, mais avec des noms différents. |
|||
[[Category:User Documentation/fr]] |
|||
par exemple: |
|||
{{Code|code= |
|||
obj.addProperty("App::PropertyFloat", "Length") |
|||
obj.addProperty("App::PropertyFloat", "Width") |
|||
obj.addProperty("App::PropertyFloat", "Height") |
|||
}} |
|||
Cela indique un objet avec trois propriétés de type "Float", nommées respectivement "Length", "Width" et "Height". |
|||
== Scrip == |
|||
{{Emphasis|See also:}} [[FreeCAD Scripting Basics/fr|FreeCAD scrip de base]] |
|||
Un [[scripted objects/fr|objet scripté]] est créé en premier, puis les propriétés lui sont attribuées. |
|||
{{Code|code= |
|||
obj = App.ActiveDocument.addObject("Part::Feature", "CustomObject") |
|||
obj.addProperty("App::PropertyFloat", "Velocity", "Parameter", "Body speed") |
|||
obj.addProperty("App::PropertyBool", "VelocityEnabled", "Parameter", "Enable body speed") |
|||
}} |
|||
En général, les propriétés {{Emphasis|Data}} sont affectées à l'aide de la méthode {{incode|addProperty()}} de l'objet. D'autre part, les propriétés {{Emphasis|View}} sont normalement fournies automatiquement par l'objet parent à partir duquel l'objet scripté est dérivé. |
|||
Par exemple: |
|||
* Dériver de {{incode|App::FeaturePython}} fournit uniquement 4 propriétés {{Emphasis|View}}: "Display Mode", "On Top When Selected", "Show In Tree" et "Visibility". |
|||
* Dériver de {{incode|Part::Feature}} fournit 17 propriétés {{Emphasis|View}}: les quatre précédentes, plus "Angular Deflection", "Zone de sélection", "Deviation", "Draw Style", "Lighting", "Line Color", "Line Width", "Point Color", "Point Size", "Selectable", "Selection Style", "Shape Color", et "Transparency". |
|||
Néanmoins, les propriétés {{Emphasis|View}} peuvent également être affectées à l'aide de la méthode {{incode|addProperty()}} de l'objet fournisseur de vue. |
|||
{{Code|code= |
|||
obj.ViewObject.addProperty("App::PropertyBool", "SuperVisibility", "Base", "Make the object glow") |
|||
}} |
|||
{{docnav/fr|[[Interface_Customization/fr|Personnalisation de l'interface]]|[[Workbenches/fr|Ateliers]]}} |
|||
{{Userdocnavi/fr}} |
|||
[[Category:Base/fr]] |
|||
{{clear}} |
Revision as of 20:23, 1 February 2020
Introduction
Une propriété est une information, telle qu'un nombre ou une chaîne de texte, attachée à un document FreeCAD ou à un objet d'un document. Les propriétés peuvent être visualisées et modifiées avec l'éditeur de propriétés.
Les propriétés jouent un rôle très important dans FreeCAD. Comme les objets dans FreeCAD sont "paramétriques", cela signifie que leur comportement est défini par leurs propriétés et par la manière dont ces propriétés sont utilisées comme entrée pour leurs méthodes de classe.
Tous les types de propriétés
Les Objets créés par script personnalisés dans FreeCAD peuvent avoir des propriétés des types suivants :
Bool
Float
FloatList
FloatConstraint
Angle
Distance
ExpressionEngine
Integer
IntegerConstraint
Percent
Enumeration
IntegerList
String
StringList
Length
Link
LinkList
LinkSubList
Matrix
Vector
VectorList
VectorDistance
Placement
PlacementLink
PythonObject
Color
ColorList
Material
Path
File
FileIncluded
PartShape
FilletContour
Circle
En interne, le nom de la propriété est préfixé par App::Property
:
App::PropertyBool
App::PropertyFloat
App::PropertyFloatList
...
Rappelez-vous qu'il s'agit de propriétés types. Un même objet peut avoir plusieurs propriétés du même type, mais avec des noms différents.
par exemple:
obj.addProperty("App::PropertyFloat", "Length")
obj.addProperty("App::PropertyFloat", "Width")
obj.addProperty("App::PropertyFloat", "Height")
Cela indique un objet avec trois propriétés de type "Float", nommées respectivement "Length", "Width" et "Height".
Scrip
See also: FreeCAD scrip de base
Un objet scripté est créé en premier, puis les propriétés lui sont attribuées.
obj = App.ActiveDocument.addObject("Part::Feature", "CustomObject")
obj.addProperty("App::PropertyFloat", "Velocity", "Parameter", "Body speed")
obj.addProperty("App::PropertyBool", "VelocityEnabled", "Parameter", "Enable body speed")
En général, les propriétés Data sont affectées à l'aide de la méthode addProperty()
de l'objet. D'autre part, les propriétés View sont normalement fournies automatiquement par l'objet parent à partir duquel l'objet scripté est dérivé.
Par exemple:
- Dériver de
App::FeaturePython
fournit uniquement 4 propriétés View: "Display Mode", "On Top When Selected", "Show In Tree" et "Visibility". - Dériver de
Part::Feature
fournit 17 propriétés View: les quatre précédentes, plus "Angular Deflection", "Zone de sélection", "Deviation", "Draw Style", "Lighting", "Line Color", "Line Width", "Point Color", "Point Size", "Selectable", "Selection Style", "Shape Color", et "Transparency".
Néanmoins, les propriétés View peuvent également être affectées à l'aide de la méthode addProperty()
de l'objet fournisseur de vue.
obj.ViewObject.addProperty("App::PropertyBool", "SuperVisibility", "Base", "Make the object glow")
- Démarrer avec FreeCAD
- Installation : Téléchargements, Windows, Linux, Mac, Logiciels supplémentaires, Docker, AppImage, Ubuntu Snap
- Bases : À propos de FreeCAD, Interface, Navigation par la souris, Méthodes de sélection, Objet name, Préférences, Ateliers, Structure du document, Propriétés, Contribuer à FreeCAD, Faire un don
- Aide : Tutoriels, Tutoriels vidéo
- Ateliers : Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test, Web