Object name/fr

Introduction
Tous les objets du programme ont un object name qui les identifie de manière unique dans un document donné.

Ces informations s'appliquent à tous les objets dérivés de App DocumentObject (classe ), qui comprend essentiellement tous les objets qu'il est possible de créer dans un document.

Les Names
Il existe différentes propriétés pour les noms:
 * Le ne peut contenir que des caractères alphanumériques simples et le trait de soulignement,.
 * Le ne peut pas commencer par un nombre. Il doit commencer par une lettre ou le trait de soulignement,.
 * Le est attribué au moment de la création de l'objet ensuite, il n'est plus modifiable. L'objet ne peut jamais être renommé.
 * Le doit être unique dans tout le document. Peu importe si deux objets sont de types complètement différents, par exemple, l'un est un PartDesign Cavité et l'autre est un Arch Mur. Ils doivent avoir des noms différents.
 * Lors de la création d'un objet du même type, normalement le nom est augmenté d'un numéro séquentiel par exemple, , etc.... Cela permet d'éviter la collusion des noms..
 * Une fois l'objet supprimé, son devient disponible pour être utilisé par un objet nouvellement créé. Cela signifie que si,  et  existent et que nous supprimons le premier élément, la boîte suivante créée avec Part Cube ne sera pas , ce sera à nouveau , cette chaîne étant disponible pour être réutilisée. Notez qu'il n'est pas possible de renommer  ou  en  car leurs noms sont fixes.

En résumé, agit essentiellement comme un identifiant unique (UID) pour un objet. Puisqu'un unique est très restrictif, tous les objets ont également une propriété  qui permet de "renommer" l'objet en quelque chose de plus descriptif. Le interne reste en fait fixe, mais le  modifiable par l'utilisateur peut être utilisé dans la plupart des situations où le  serait utilisé. Dans l'utilisation courante dans le programme et la documentation, "renommer" signifie changer le et non le  réel de l'objet.

Les Labels
Il existe différentes propriétés pour les étiquettes:
 * Le peut accepter n'importe quelle chaîne UTF8, y compris les accents et les espaces.
 * La vue en arborescence affiche en fait le de l'objet et pas le . Par conséquent, chaque fois qu'un nouvel objet est créé, il est recommandé de remplacer  par une chaîne plus descriptive. Pour renommer l'objet, sélectionnez-le dans l'arborescence et appuyez sur  (ou plutôt  sur macOS), ou ouvrez le menu contextuel (clic droit) et choisissez.
 * Même après qu'un objet a été renommé (ré-étiqueté), le interne sera toujours déclaré à de nombreux endroits, par exemple, dans la Barre d'état ou dans la Fenêtre de sélection lorsque l'objet est sélectionné.
 * Étant donné que les fonctions internes du programme font référence aux objets par, de nombreuses boîtes de dialogue affichent le en premier suivi de l'étiquette  modifiable par l'utilisateur entre parenthèses, par exemple,.
 * Par défaut, le est unique, tout comme le . Cependant, ce comportement peut être modifié dans éditeur de préférences, . Cela signifie qu'en général,  n'est pas unique dans le document et peut en fait être répété. Cependant, la recommandation est de garder le  unique, car c'est probablement ce qui est le plus utile pour identifier différents objets. Lors de l'écriture de fonctions personnalisées qui manipulent des objets, les méthodes doivent utiliser le  de l'objet plutôt que son  pour garantir que l'objet correct est utilisé.
 * Lors de l'utilisation des expressions, par exemple, dans l'Éditeur de propriétés ou dans une feuille de calcul, l'étiquette peut être référencé à l'aide de doubles crochets constitués de symboles "moins que" et "plus que".

Label2
Cette propriété a été introduite dans la version 0.19. Il s'agit d'une chaîne simple qui peut contenir du texte arbitraire et peut donc être utilisée pour documenter (décrire plus en détail) l'objet créé.
 * Dans la vue en arborescence, modifiez le champ à côté de l'icône, sous "Description", en cliquant dessus et en appuyant sur (ou plutôt  sur macOS).
 * Vous pouvez également modifier cette propriété en modifiant l'attribut à partir de la console Python.
 * L'attribut est normalement masqué dans Éditeur de propriétés mais peut être rendu visible en ouvrant le menu contextuel (clic droit) et en sélectionnant.

Script
Débuter avec les scripts et Objets créés par script.

Tout objet du logiciel est créé en interne avec la méthode du document. La majorité des objets 2D et 3D que l'utilisateur verra dans la vue 3D sont dérivés d'un Part Feature. Dans l'exemple suivant, l'objet créé est une Part Box.

Name (Nom)
La fonction a deux arguments de chaîne de base.


 * Le premier argument indique le type d'objet, dans ce cas,.
 * Le deuxième argument est une chaîne qui définit l'attribut . S'il n'est pas fourni, il utilise par défaut le même nom que la classe de l'objet, c'est-à-dire où les deux symboles invalides, les deux-points, sont remplacé par deux traits de soulignement.
 * Le ne peut contenir que des caractères alphanumériques simples et le trait de soulignement, . Si d'autres symboles sont donnés, ils seront convertis en traits de soulignement; par exemple,  est converti en.
 * Le ne peut pas commencer par un nombre; il doit commencer par une lettre ou le trait de soulignement, . Par exemple,  est converti en.
 * Le est fixe au moment de la création; il ne peut pas être modifié par la suite.
 * Le doit être unique dans tout le document. Si le même  est utilisé, un numéro séquentiel sera ajouté automatiquement afin que les noms résultants soient uniques; par exemple, si  existe déjà, les nouveaux objets seront appelés, , {{incode|"Name003"} } etc...

Label (Etiquette)
est une propriété de l'objet créé et peut être changé en un texte plus significatif.
 * Lors de la création de l'objet, le est le même que le.
 * Cependant, contrairement au, peut accepter n'importe quelle chaîne UTF8 y compris les accents et les espaces.
 * Le peut être modifié à tout moment en affectant simplement la chaîne souhaitée,



Accéder à un objet par Name ou Label
Tous les objets d'un document sont des attributs de données de l'objet Document correspondant. Le nom de l'attribut correspond à interne de l'objet.

Cela équivaut à utiliser la méthode de document.

Cependant, il est également possible d'obtenir l'objet par davantage descriptif.

Étant donné que n'est en général pas unique, la méthode  renvoie une liste avec tous les objets trouvés avec cette. Cependant, si est unique dans le document, le premier élément de cette liste doit être l'objet souhaité.