Fonctions iPropriétés dans iLogic

iLogic fournit des fonctions de règles pour la définition ou l'obtention des iPropriétés de pièce, d'ensemble et de documents de dessin Inventor. Comme les règles servent à transformer ou modifier des conceptions en nouvelles configurations, conservez les iPropriétés des documents de conception à jour. Les iPropriétés doivent être mises à jour dans la nomenclature pour être correctes. Les règles peuvent également être utilisées pour lire les valeurs des iPropriétés d'un document et réagir en fonction. Par exemple, vous pouvez avoir une règle qui modifie l'épaisseur d'une pièce lorsque la propriété d'une matière change. Une règle peut entraîner des modifications si le volume de la pièce dépasse une valeur maximale ou minimale. Toute iPropriété qui peut être définie manuellement peut être définie ou lue à l'aide d'une règle.

Pour accéder aux fonctions iProperties, développez le noeud iPropriétés sous l'onglet Système de la zone Extraits de code.

iProperties.Value

Syntaxe

iProperties.Value("property tab name", "property name")

Définit ou lit la valeur d'une propriété dans le document qui contient la règle.

iProperties.Value("filename.ipt", "property tab name", "property name")

Fonction utilisée dans une règle d'ensemble pour accéder aux iPropriétés d'une pièce ou d'un sous-ensemble.

Si le nom de fichier de la pièce ou du sous-ensemble est modifié, le texte de la règle doit également être modifié.

Il est préférable d'utiliser le nom de composant (après sa personnalisation) plutôt que le nom de fichier.

iProperties.Value("custom component name", "property tab name", "property name")

Définit ou lit les valeurs de propriété d'un composant. Cette fonction utilise le nom de composant au lieu du nom de fichier. Personnalisez le nom du composant (en changeant son nom par défaut) pour qu'il ne change pas si la référence de fichier est modifiée.

Exemples

Pour définir la valeur d'iPropriété :

iProperties.Value("Project", "Stock Number") = "302A"

Pour lire la valeur d'iPropriété :

MyStringParam = iProperties.Value("Project", "Stock Number")

Pour définir une valeur d'iPropriété personnalisée :

iProperties.Value("Custom", "Age") = 41 'number type
iProperties.Value("Custom", "Company") = "Autodesk, Inc" 'text type
iProperties.Value("Custom", "Date") = CDate("11/1/2008") ' date type
iProperties.Value("Custom", "Insured") = true 'yes or no type

Pour lire une valeur d'iPropriété personnalisée :

age = iProperties.Value("Custom", "Age")
company = iProperties.Value("Custom", "Company")
thedate = CStr(iProperties.Value("Custom", "Date"))
insured = iProperties.Value("Custom", "Insured")

Rappel

Fonctions abandonnées

Les versions précédentes d'iLogic utilisaient les fonctions suivantes pour obtenir les iPropriétés de pièces dans un ensemble :

iProperties.ValueInDoc("filename.ipt", "property tab name", "property name")

Référence le nom du fichier.

iProperties.ValueInComponent("custom component name", "property tab name", "property name")

Référence le nom du composant.

Bien que ces fonctions ne soient pas disponibles dans la zone Extraits de code de la boîte de dialogue Modifier la règle, elles peuvent être utilisées dans une règle. Toutefois, la fonction iProperties.Value est mieux adaptée que ces fonctions plus anciennes.

iProperties.StylesInEnglish

Cette fonction prend en charge l'utilisation du même document dans différentes versions de langue d'Autodesk Inventor. Le modèle est plus portable s'il utilise des noms anglais pour les matières et les couleurs dans les règles. Si vous définissez cette fonction sur VRAI, toute fonction qui renvoie des noms de matière ou de couleur renvoie alors les noms en anglais. Vous pouvez utiliser des noms dans la langue de votre installation d'Autodesk Inventor pour définir une matière ou un nom de couleur. Toutefois, il est recommandé d'utiliser des noms en anglais pour assurer la cohérence. Les fonctions suivantes renvoient des noms en anglais lorsque vous définissez la valeur iProperties.StylesInEnglish sur VRAI :

iProperties.Material

Définit ou lit la matière dans un document.

Lors de la définition de la matière; utilisez le nom de la matière (en respectant la casse) telle qu'il apparaît dans la liste des propriétés de matières standard active. Les valeurs de matière sont toujours des chaînes de texte, placées entre guillemets.

Exemples

Pour définir la matière :

iProperties.Material = "Gold"

Pour lire la matière :

MyStringParam = iProperties.Material

iProperties.Material(“filename.ipt”)

Définit ou lit la matière d'une pièce dans un ensemble, en précisant le nom de fichier.

iProperties.Material(“componentName:1”)

Dans une règle de niveau d'ensemble, permet d'accéder à la matière d'une pièce dans l'ensemble, en spécifiant le nom du composant.

iProperties.PartColor

Définit ou lit la couleur d'une pièce. Les valeurs de couleur de pièce sont des chaînes de texte entre guillemets. La modification de la couleur n'a pas d'incidence sur la valeur de matière actuelle.

Cette fonction s'applique aux pièces uniquement.

Exemples

Pour définir la couleur :

iProperties.PartColor = "Green"
iProperties.PartColor = "As Material"

Pour lire la couleur :

MyStringParam = iProperties.PartColor

iProperties.Mass

Lit ou écrit la masse dans le fichier pièce ou ensemble contenant la règle.

Si vous écrivez sur la masse, la masse calculée est remplacée. Pour rétablir la valeur calculée, définissez la masse sur -1.

iProperties.Mass(“filename.ipt”)

Lit ou écrit la masse d'une pièce ou d'un sous-ensemble dans un ensemble, en précisant le nom de fichier.

iProperties.Mass(“component name:1”)

Lit ou écrit la masse d'un composant dans un ensemble, en spécifiant le nom du composant. Cette fonction peut également être utilisée pour lire et écrire sur la masse d'un composant virtuel.

Exemples

Pour lire la masse :

MyMassParam = iProperties.Mass
MyMassParam = iProperties.Mass("component:1")
MyMassParam = iProperties.Mass("mypart.ipt")

Pour définir la masse (et remplacer automatiquement la valeur calculée) :

iProperties.Mass = 3 kg
iProperties.Mass("virtual_component") = 233 g
iProperties.Mass("mypart.ipt") = 4.2 lb
massiProperties.Mass = -1 'set the mass back to automatic calculation

iProperties.Volume

Lit ou écrit le volume dans le document contenant la règle.

iProperties.Volume(“filename.ipt”)

Lit ou écrit le volume d'une pièce ou d'un sous-ensemble qui contient la règle, en précisant le nom de fichier.

iProperties.Volume(“component:1”)

Lit ou écrit le volume d'un composant dans un ensemble, en spécifiant le nom du composant. Cette fonction peut également être utilisée pour lire et écrire sur le volume d'un composant virtuel.

Exemples

Pour lire le volume :

MyVolumeParam = iProperties.Volume
MyVolumeParam = iProperties.Volume("component:1")
MyVolumeParam = iProperties.Volume("mypart.ipt")

Pour définir le volume (et remplacer automatiquement la valeur calculée) :

iProperties.Volume = 12.4 in^3
iProperties.Volume("virtual_component") = 542 cm^3
iProperties.Volume("mypart.ipt") = 12.8 in^3
iProperties.Volume = -1 'set it back to automatic calculation

iProperties.CenterOfGravity

Lit le centre de gravité du modèle dans le document contenant la règle.

Syntaxe

pt = iProperties.CenterOfGravity

pt est de type Inventor.Point, fonction décrite dans l'aide sur l'API Inventor. Vous pouvez lire les valeurs X, Y et Z du point, exprimées dans les unités du document contenant la règle :

cx = pt.X
cy = pt.Y
cz = pt.Z

pt = iProperties.CenterOfGravity("component")

Lit le centre de gravité d'un composant dans un ensemble, indiquant le nom du composant.

iProperties.Area

Affiche l'aire de la surface du modèle dans le document contenant la règle.

Syntaxe

surfaceArea = iProperties.Area

surfaceArea = iProperties.Area(“component:1”)

Affiche l'aire de la surface d'un composant dans un ensemble, en spécifiant le nom du composant.