Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Formula - Classe

Office 2013 et versions ultérieures

Cette documentation est préliminaire et peut changer.

Formule unique. Lorsque l'objet est sérialisé en XML, son nom qualifié est v: f.

Espace de noms :  DocumentFormat.OpenXml.Vml
Assembly :  DocumentFormat.OpenXml (dans DocumentFormat.OpenXml.dll)

public class Formula : OpenXmlLeafElement

[ISO/IEC 29500-1 1st Edition]

f (formule)

Cet élément définit une seule valeur comme le 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 de suivi jusqu'à trois arguments, qui se composent de valeurs d'ajustement (voir l'attribut adj de l'élément de forme (§14.1.2.19)), les résultats des formules ci-dessus, fixe de nombres ou de valeurs prédéfinies. Chaque valeur de f est référencée à l'aide de « @ » suivi d'un numéro correspondant à l'index de base zéro de la valeur dans la liste des éléments de f. [Exemple: par exemple, la valeur du deuxième élément de f est référencée en tant que « @2 ». exemple de fin]

[Exemple: suivantes définit 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, décrites en général sous la forme v, P1 et P2. Jusqu'à 128 formules peuvent être spécifiées. Ces opérations sont définies (précision de calcul est décrite ci-dessous) :

Déroulement de l'opération

Description

Val

v

Retourne la valeur fournie. Exacte.

Somme

Addition et soustraction. Exacte.

Produit

La multiplication et la division. Arrondit.

STXT

Moyenne simple. Arrondi vers zéro.

ABS

Valeur absolue. Exacte.

MIN

La plus petite des deux valeurs. Exacte.

MAX :

La plus grande des deux valeurs. Exacte.

Condition

Sélection conditionnelle. Exacte.

Mod

Modulo. Inexact.

atan2

Tangente trigonométrique de l'arc d'un quotient. Résultat est exprimé en unités « fd » ou fractionnaires degrés - degrés. Inexact.

SIN

Sinus. Argument est en unités « fd » ou en degrés fractionnaires - degrés. Inexact.

COS

Cosinus. Argument est en unités « fd » ou en degrés fractionnaires - degrés. Inexact.

cosatan2

Préserve la précision complète dans le calcul intermédiaire. Inexact.

sinatan2

Préserve la précision complète dans le calcul intermédiaire. Inexact.

SQRT

Racine carrée. Résultat est positif et arrondit le résultat. Inexact.

sumangle

Ajoute un angle existant en unités fd (v) à deux autres angles spécifiées en degrés. P1 et P2 sont mis à l'échelle par. Exacte.

Ellipse.

La formule de l'excentricité d'une ellipse, où v est la longueur de l'axe semiminor et P1 est la longueur de l'axe semimajor. Inexact.

Brun roux

Tangente. Argument est en unités « fd » ou en degrés fractionnaires - degrés. Inexact.

Les formules sont évalués à plus de précision, mais le résultat est toujours un entier de 32 bits. Formules auteurs doivent éviter les formules qui sont discontinues - non seulement de nombreuses opérations trigonométriques inexactes, les transformations dans les espaces de coordonnées sont également inexactes. Cela peut signifier qu'un jeu de formules qui est discontinu évalue pour donner les valeurs de chemin d'accès très différent avec la même entrée sur deux systèmes différents.

Lorsqu'une opération est marquée comme exacte puis une réalisation conforme doit toujours générer la bonne réponse arithmétique (sauf si les calculs de dépassement de capacité en interne). Le fonctionnement du produit est nécessaire pour arrondir à l'entier le plus proche. Si le résultat est exactement 0,5, puis il est arrondi à l'entier supérieur numériquement. L'opération mid est nécessaire pour arrondir vers 0.

Toutes les autres opérations sont inexactes, mais la mise en oeuvre doit arrondir les valeurs non intégrales (vers - infini) et doit effectuer les calculs internes avec cette forme d'arrondi.

Les arguments utilisés dans l'évaluation d'une formule sont normalement que soit 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 adj de forme.  Numéros fixes doivent être positifs valeurs intégrales de la plage de 0 à 65535 (nombres 16 bits non signés). Les valeurs nommées suivantes sont définies :

Valeur

Description

@n

La valeur de 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 la formule en cours.

#n

Ajustement (adj) valeur n.  n doit être dans la plage 0 à 7.

width

La largeur est définie par l'attribut coordsize.

Hauteur

La hauteur définie par l'attribut coordsize.

xCenter

L'ordonnée x du centre de l'espace de coordonnées définie par coordorigin et coordsize.

yCenter

L'ordonnée y du centre de l'espace de coordonnées définie par coordorigin et coordsize.

xlimo

La valeur de x de l'attribut limo (voir également l'élément de tracé (§14.1.2.14)).

ylimo

La valeur de l'attribut limo y (voir également l'élément de tracé (§14.1.2.14)).

hasstroke

1 si la forme est une opération de tracé, 0 si elle ne le fait pas, telle que déterminée par l'attribut activé de l'élément de tracé (§14.1.2.21).

hasfill

1 si la forme est une opération de remplissage 0 dans ce cas, tel que déterminé par l'attribut activé de l'élément de remplissage (§14.1.2.5).

pixellinewidth

La largeur du trait en pixels de périphérique de sortie. Cela est utilisé pour les lignes de départ à partir du bord d'un rectangle sur l'hypothèse que la mise en oeuvre dessine à pixel inférieur droit plutôt que le pixel supérieur gauche lorsqu'une ligne est sur une limite de pixel.

propriétés PixelWidth

La largeur de la forme en pixels de périphérique (par exemple, la largeur coordsize transformée en espace de périphérique).

PixelHeight

La hauteur de la coordsize en pixels de périphérique.

emuwidth

La largeur de la coordsize en EMU.

emuheight

La hauteur de la coordsize en EMU.

emuwidth2

Moitié de la largeur de la coordsize en EMU.

emuheight2

La moitié de la hauteur de la coordsize en EMU.

L'UME, ou l'unité de mesure en anglais, est la plus petite unité de mesure dans le langage VML et correspond à 914400 UME par pouce ou 12700 EMU par point.

Pour obtenir un exemple, voir ci-dessus.

Les valeurs possibles pour cet attribut sont définies par le type de données chaîne W3C XML Schema.

[Remarque: le W3C XML Schema definition de cet élément modèle de contenu (CT_F) se trouve dans §A.6.1. fin de la Remarque]

© ISO/IEC29500: 2008.

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.
Afficher: