Formula Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Formule unique.
Cette classe est disponible dans Office 2007 et versions ultérieures.
Lorsque l’objet est sérialisé au format xml, son nom qualifié est v :f.
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(26, "f")]
public class Formula : DocumentFormat.OpenXml.OpenXmlLeafElementpublic class Formula : DocumentFormat.OpenXml.OpenXmlLeafElement[DocumentFormat.OpenXml.SchemaAttr(26, "f")]
public class Formula : DocumentFormat.OpenXml.OpenXmlLeafElement[DocumentFormat.OpenXml.SchemaAttr("v:f")]
public class Formula : DocumentFormat.OpenXml.OpenXmlLeafElement[DocumentFormat.OpenXml.SchemaAttr("v:f")]
public class Formula : DocumentFormat.OpenXml.TypedOpenXmlLeafElement[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class Formula : DocumentFormat.OpenXml.OpenXmlLeafElement[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(26, "f")>]
type Formula = class
inherit OpenXmlLeafElementtype Formula = class
inherit OpenXmlLeafElement[<DocumentFormat.OpenXml.SchemaAttr(26, "f")>]
type Formula = class
inherit OpenXmlLeafElement[<DocumentFormat.OpenXml.SchemaAttr("v:f")>]
type Formula = class
inherit OpenXmlLeafElement[<DocumentFormat.OpenXml.SchemaAttr("v:f")>]
type Formula = class
inherit TypedOpenXmlLeafElement[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type Formula = class
inherit OpenXmlLeafElementPublic Class Formula
Inherits OpenXmlLeafElementPublic Class Formula
Inherits TypedOpenXmlLeafElement- Héritage
- Héritage
- Attributs
Remarques
[ISO/IEC 29500-1 1st Edition]
f (Formule unique)
Cet élément définit une valeur unique comme résultat de l’évaluation d’une expression. L’expression est définie par l’attribut eqn et a la forme générale d’une opération suivie d’un maximum de trois arguments, qui se composent de valeurs d’ajustement (voir l’attribut adj de l’élément shape (§14.1.2.19)), les résultats des formules antérieures, des nombres fixes ou des valeurs prédéfinies. Chaque valeur f est référencée à l’aide de « @ » suivi d’un nombre correspondant à l’index de base zéro pour cette valeur dans la liste des éléments f. [Exemple : Par exemple, la valeur du deuxième élément f est référencée en tant que « @2 ». Fin de l’exemple]
[Exemple : Les éléments suivants définissent une flèche bleue pointant vers la droite :
<v:shape coordsize="21600,21600" adj="18000,5400,10800"
path="m @0,0 l @0,@1 0,@1 0,@3 @0,@3 @0,21600 21600,10800 x e"
style='left:50pt;top:50pt;width:90pt;height:30pt'
fillcolor="#4f81bd" strokecolor="#4f81bd" strokeweight="2pt">
<v:formulas>
<v:f eqn="val #0"/>
<v:f eqn="val #1"/>
<v:f eqn="val #2"/>
<v:f eqn="sum height 0 #1"/>
<v:f eqn="sum #2 0 #1"/>
<v:f eqn="sum width 0 #0"/>
<v:f eqn="prod @5 @4 #2"/>
<v:f eqn="sum width 0 @6"/>
</v:formulas>
</v:shape>
La forme ressemble à ceci :
Fin de l’exemple]
| Éléments parents |
|---|
| formules (§14.1.2.6) |
| Attributs | Description |
|---|---|
| eqn (Équation) | Spécifie une formule unique, qui se compose d’une opération nommée suivie de trois paramètres maximum, généralement décrits comme v, P1 et P2. Jusqu’à 128 formules peuvent être spécifiées. Ces opérations sont définies (la précision du calcul est décrite ci-dessous) : Opération Description Val v Retourne la valeur fournie. Exacte. Somme Addition et soustraction. Exacte. Produit Multiplication et division. Arrondit vers le haut. Milieu Moyenne simple. Arrondit en tendant vers zéro. Abs Valeur absolue. Exacte. Min La moins élevée de deux valeurs. Exacte. Max Valeur la plus élevée de deux valeurs. Exacte. Si Sélection conditionnelle. Exacte. Mod Module. Inexacte. atan2 Tangente d’arc trigonométrique d’un quotient. Le résultat est en unités « fd » ou degrés fractionnaires - degrés . Inexacte. Péché Sinus. L’argument est en unités « fd » ou degrés fractionnaires - degrés . Inexacte. Cos Cosinus. L’argument est en unités « fd » ou degrés fractionnaires - degrés . Inexacte. cosatan2 Conserve la précision totale dans le calcul intermédiaire. Inexacte. sinatan2 Conserve la précision totale dans le calcul intermédiaire. Inexacte. Sqrt Racine carrée. Le résultat est positif et arrondit à la baisse. Inexacte. sumangle Ajoute un angle existant en unités fd (v) à deux autres angles spécifiés en degrés. P1 et P2 sont mis à l’échelle par . Exacte. Ellipse Formule d’excentricité pour une ellipse, où v est la longueur de l’axe des demi-points et P1 la longueur de l’axe semi-virgule. Inexacte. Tan Tangente. L’argument est en unités « fd » ou degrés fractionnaires - degrés . Inexacte. Les formules sont évaluées avec une précision totale, mais le résultat est toujours un entier 32 bits. Les auteurs de formules doivent éviter les formules discontinues : non seulement la plupart des opérations trigonométriques sont inexactes, mais les transformations dans les espaces de coordonnées sont également inexactes. Cela peut signifier qu’un ensemble de formules discontinues donne des valeurs de chemin très différentes avec la même entrée sur deux systèmes différents. Lorsqu’une opération est marquée comme exacte, une implémentation conforme génère toujours la réponse arithmétique correcte (sauf si les calculs débordent en interne). L’opération de produit est nécessaire pour arrondir à l’entier le plus proche. Si le résultat est exactement 0,5, il doit être arrondi à l’entier numériquement supérieur suivant. L’opération intermédiaire est nécessaire pour arrondir vers 0. Toutes les autres opérations sont inexactes, mais l’implémentation arrondit les valeurs non intégrales vers le bas (vers -infinity) et doit effectuer des calculs internes avec cette forme d’arrondi. Les arguments utilisés dans l’évaluation d’une formule sont normalement des nombres fixes, le résultat de l’évaluation d’une formule précédente ou une valeur d’ajustement ( la valeur de l’entrée correspondante dans l’attribut shape adj). Les nombres fixes doivent être des valeurs intégrales positives comprises entre 0 et 65535 (nombres 16 bits non signés). Les valeurs nommées suivantes sont définies : Valeur Description @n Valeur de la formule n, où n est l’index de base zéro de la formule dans la liste des formules. n doit être inférieur à l’index de formule actuel. #n Valeur d’ajustement (adj) n. n doit être comprise entre 0 et 7. width Largeur définie par l’attribut coordsize. height Hauteur définie par l’attribut coordsize. xcenter X ordinate du centre de l’espace de coordonnées défini par coordorigin et coordsize. ycenter Ordonnée y du centre de l’espace de coordonnées défini par coordorigin et coordsize. xlimo Valeur x de l’attribut limo (voir également l’élément path (§14.1.2.14)). ylimo Valeur y de l’attribut limo (voir également l’élément path (§14.1.2.14)). hasstroke 1 si la forme a une opération de trait, 0 si ce n’est pas le cas, comme déterminé par l’attribut on de l’élément trait (§14.1.2.21). hasfill 1 si la forme a une opération de remplissage, 0 si ce n’est pas le cas, comme déterminé par l’attribut on de l’élément fill (§14.1.2.5). pixellinewidth Largeur de ligne en pixels de l’appareil de sortie. Il est utilisé pour faire sortir les lignes du bord d’un rectangle en supposant que l’implémentation dessine le pixel inférieur droit de préférence vers le pixel supérieur gauche lorsqu’une ligne se trouve sur une limite de pixels. pixelwidth Largeur de la forme en pixels de l’appareil (c’est-à-dire, la largeur de coordsize transformée en espace de l’appareil). pixelheight Hauteur du coordsize en pixels de l’appareil. emuwidth Largeur du coordsize dans les unités emu. emuheight Hauteur de la taille du coordsize dans les unités d’emu. emuwidth2 La moitié de la largeur du coordsize dans les unités emu. emuheight2 La moitié de la hauteur du coordsize dans les unités d’emu. L’EMU, ou unité de métrique anglaise, est la plus petite unité de mesure dans VML et correspond à 914400 EMU par pouce ou 12 700 EMU par point. Voir l'exemple ci-dessus. Les valeurs possibles de cet attribut sont définies par le type de données string du schéma W3C XML. |
[Remarque : La définition de schéma XML W3C du modèle de contenu de cet élément (CT_F) se trouve dans §A.6.1. Fin de la remarque]
ISO/IEC29500 : 2008.
Constructeurs
| Formula() |
Initialise une nouvelle instance de la classe Formula. |
Propriétés
| ChildElements |
Obtient tous les nœuds enfants de l’élément actuel. (Hérité de OpenXmlElement) |
| Equation |
Équation Représente l’attribut suivant dans le schéma : eqn |
| ExtendedAttributes |
Obtient tous les attributs étendus (attributs non définis dans le schéma) de l’élément actuel. (Hérité de OpenXmlElement) |
| Features |
Obtient un IFeatureCollection pour l’élément actuel. Cette collection de fonctionnalités sera en lecture seule, mais héritera des fonctionnalités de sa partie parente et de son package, le cas échéant. (Hérité de OpenXmlElement) |
| FirstChild |
Obtient le premier enfant de l’élément OpenXmlElement. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement de ce type. (Hérité de OpenXmlElement) |
| HasAttributes |
Obtient une valeur indiquant si l’élément actuel a des attributs. (Hérité de OpenXmlElement) |
| HasChildren |
Obtient une valeur qui indique si l’élément actuel a des éléments enfants. (Hérité de OpenXmlLeafElement) |
| InnerText |
Obtient ou définit les valeurs concaténées du nœud et de tous ses enfants. (Hérité de OpenXmlElement) |
| InnerXml |
Obtient ou définit le balisage qui représente uniquement les éléments enfants de l’élément actuel. (Hérité de OpenXmlLeafElement) |
| LastChild |
Obtient le dernier enfant de l’élément OpenXmlElement. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement de ce type. (Hérité de OpenXmlElement) |
| LocalName |
Formule unique. Cette classe est disponible dans Office 2007 et versions ultérieures. Lorsque l’objet est sérialisé au format xml, son nom qualifié est v :f. |
| LocalName |
Obtient le nom local de l’élément actuel. (Hérité de OpenXmlElement) |
| MCAttributes |
Obtient ou définit les attributs de compatibilité du balisage. Retourne null si aucun attribut de compatibilité de balisage n’est défini pour l’élément actuel. (Hérité de OpenXmlElement) |
| NamespaceDeclarations |
Obtient toutes les déclarations d’espace de noms définies dans l’élément actuel. Retourne un énumérateur vide s’il n’y a pas de déclaration d’espace de noms. (Hérité de OpenXmlElement) |
| NamespaceUri |
Obtient l’URI d’espace de noms de l’élément actuel. (Hérité de OpenXmlElement) |
| OpenXmlElementContext |
Obtient l’élément OpenXmlElementContext de l’élément actuel. (Hérité de OpenXmlElement) |
| OuterXml |
Obtient le balisage qui représente l’élément actuel et tous ses éléments enfants. (Hérité de OpenXmlElement) |
| Parent |
Obtient l’élément parent de l’élément actuel. (Hérité de OpenXmlElement) |
| Prefix |
Obtient le préfixe d’espace de noms de l’élément actuel. (Hérité de OpenXmlElement) |
| XmlQualifiedName |
Obtient le nom qualifié de l’élément actuel. (Hérité de OpenXmlElement) |
| XName |
Obtient le nom qualifié de l’élément actuel. (Hérité de OpenXmlElement) |
Méthodes
| AddAnnotation(Object) |
Ajoute un objet à la liste d’annotations de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement) |
| AddNamespaceDeclaration(String, String) |
Ajoute une déclaration d’espace de noms au nœud actuel. (Hérité de OpenXmlElement) |
| Ancestors() |
Énumère tous les ancêtres de l’élément actuel. (Hérité de OpenXmlElement) |
| Ancestors<T>() |
Énumère uniquement les ancêtres de l’élément actuel qui ont le type spécifié. (Hérité de OpenXmlElement) |
| Annotation(Type) |
Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement) |
| Annotation<T>() |
Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement) |
| Annotations(Type) |
Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement) |
| Annotations<T>() |
Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement) |
| Append(IEnumerable<OpenXmlElement>) |
Ajoute chaque élément d’une liste d’éléments à la fin de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement) |
| Append(OpenXmlElement[]) |
Ajoute chaque élément d’un tableau d’éléments à la fin de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement) |
| AppendChild<T>(T) |
Ajoute l’élément spécifié à la fin de la liste des nœuds enfants de l’élément actuel. (Hérité de OpenXmlElement) |
| ClearAllAttributes() |
Efface tous les attributs, y compris les attributs connus et les attributs étendus. (Hérité de OpenXmlElement) |
| Clone() |
Crée un doublon du nœud actuel. (Hérité de OpenXmlElement) |
| CloneNode(Boolean) |
Crée un doublon de ce nœud. |
| Descendants() |
Énumère tous les descendants de l’élément actuel. (Hérité de OpenXmlElement) |
| Descendants<T>() |
Énumérez tous les descendants de l’élément actuel de type T. (Hérité de OpenXmlElement) |
| Elements() |
Énumère tous les enfants de l’élément actuel. (Hérité de OpenXmlElement) |
| Elements<T>() |
Énumère uniquement les enfants de l’élément actuel qui ont le type spécifié. (Hérité de OpenXmlElement) |
| ElementsAfter() |
Énumère tous les éléments frères qui suivent l’élément actuel et ont le même parent que l’élément actuel. (Hérité de OpenXmlElement) |
| ElementsBefore() |
Énumère tous les éléments frères qui précèdent l’élément actuel et ont le même parent que l’élément actuel. (Hérité de OpenXmlElement) |
| GetAttribute(String, String) |
Obtient un attribut Open XML avec le nom de balise et l’URI d’espace de noms spécifiés. (Hérité de OpenXmlElement) |
| GetAttributes() |
Obtient une liste qui contient une copie de tous les attributs. (Hérité de OpenXmlElement) |
| GetEnumerator() |
Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement) |
| GetFirstChild<T>() |
Recherche le premier élément enfant de type T. (Hérité de OpenXmlElement) |
| InsertAfter<T>(T, OpenXmlElement) |
Insère l’élément spécifié immédiatement après l’élément de référence spécifié. (Hérité de OpenXmlElement) |
| InsertAfterSelf<T>(T) |
Insère l’élément spécifié immédiatement après l’élément actuel. (Hérité de OpenXmlElement) |
| InsertAt<T>(T, Int32) |
Insère l’élément spécifié à l’index spécifié dans la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement) |
| InsertBefore<T>(T, OpenXmlElement) |
Insère l’élément spécifié juste avant l’élément de référence spécifié. (Hérité de OpenXmlElement) |
| InsertBeforeSelf<T>(T) |
Insère l’élément spécifié juste avant l’élément actuel. (Hérité de OpenXmlElement) |
| IsAfter(OpenXmlElement) |
Détermine si l’élément actuel apparaît après un élément spécifié dans l’ordre du document. (Hérité de OpenXmlElement) |
| IsBefore(OpenXmlElement) |
Détermine si l’élément actuel apparaît avant un élément spécifié dans l’ordre du document. (Hérité de OpenXmlElement) |
| LookupNamespace(String) |
Résout le préfixe d’espace de noms dans le contexte du nœud actuel. (Hérité de OpenXmlElement) |
| LookupPrefix(String) |
Recherche le préfixe correspondant pour un URI d’espace de noms dans l’étendue de l’élément actuel. (Hérité de OpenXmlElement) |
| NextSibling() |
Obtient l’élément OpenXmlElement qui suit immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement suivant. (Hérité de OpenXmlElement) |
| NextSibling<T>() |
Obtient l’élément OpenXmlElement avec le type spécifié qui suit l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’y a pas d’élément OpenXmlElement suivant. (Hérité de OpenXmlElement) |
| PrependChild<T>(T) |
Insère l’élément spécifié au début de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement) |
| PreviousSibling() |
Obtient l’élément OpenXmlElement qui précède immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic ) s’il n’existe aucun élément OpenXmlElement précédent. (Hérité de OpenXmlElement) |
| PreviousSibling<T>() |
Obtient l’élément OpenXmlElement avec le type spécifié qui précède l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement précédent. (Hérité de OpenXmlElement) |
| Remove() |
Supprime l’élément actuel de son parent. (Hérité de OpenXmlElement) |
| RemoveAllChildren() |
Supprime tous les éléments enfants de l’élément actuel. (Hérité de OpenXmlLeafElement) |
| RemoveAllChildren<T>() |
Supprimez tous les éléments enfants de l’élément actuel qui sont de type T. (Hérité de OpenXmlElement) |
| RemoveAnnotations(Type) |
Supprime les annotations du type spécifié de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement) |
| RemoveAnnotations<T>() |
Supprime les annotations avec le type spécifié de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement) |
| RemoveAttribute(String, String) |
Supprime l’attribut de l’élément actuel. (Hérité de OpenXmlElement) |
| RemoveChild<T>(T) |
Supprime l’élément enfant spécifié de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement) |
| RemoveNamespaceDeclaration(String) |
Supprime la déclaration d’espace de noms pour le préfixe spécifié. Ne supprime rien s’il n’y a pas de préfixe. (Hérité de OpenXmlElement) |
| ReplaceChild<T>(OpenXmlElement, T) |
Remplace un élément enfant par un autre élément enfant dans la liste d’éléments enfants de l’élément actuel. (Hérité de OpenXmlElement) |
| SetAttribute(OpenXmlAttribute) |
Définit un attribut sur l’élément spécifié. Si l’attribut est un attribut connu, la valeur de l’attribut est définie. Si l’attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus. (Hérité de OpenXmlElement) |
| SetAttributes(IEnumerable<OpenXmlAttribute>) |
Définit un certain nombre d’attributs à l’élément . Si un attribut est un attribut connu, la valeur de l’attribut est définie. Si un attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus. (Hérité de OpenXmlElement) |
| WriteTo(XmlWriter) |
Enregistre le nœud actuel dans le XmlWriter spécifié. (Hérité de OpenXmlElement) |
Implémentations d’interfaces explicites
| IEnumerable.GetEnumerator() |
Formule unique. Cette classe est disponible dans Office 2007 et versions ultérieures. Lorsque l’objet est sérialisé au format xml, son nom qualifié est v :f. (Hérité de OpenXmlElement) |
| IEnumerable<OpenXmlElement>.GetEnumerator() |
Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement) |