Formula Klasse

Definition

Namespace:

DocumentFormat.OpenXml.Vml

Assembly:

DocumentFormat.OpenXml.dll

Paket:

DocumentFormat.OpenXml v3.0.1

Einzelne Formel.

Diese Klasse ist in Office 2007 und höher verfügbar.

Wenn das Objekt als XML serialisiert wird, lautet der qualifizierte Name v:f.

public class Formula : DocumentFormat.OpenXml.OpenXmlLeafElement

type Formula = class
    inherit OpenXmlLeafElement

Public Class Formula
Inherits OpenXmlLeafElement

Vererbung

Object

OpenXmlElement

OpenXmlLeafElement

Formula

Hinweise

[ISO/IEC 29500-1 1. Auflage]

f (Einzelne Formel)

Dieses Element definiert einen einzelnen Wert als Ergebnis der Auswertung eines Ausdrucks. Der Ausdruck wird durch das eqn-Attribut definiert und weist die allgemeine Form eines Vorgangs auf, gefolgt von bis zu drei Argumenten, die aus Anpassungswerten bestehen (siehe adj-Attribut des Shape-Elements (§14.1.2.19)), den Ergebnissen früherer Formeln, fester Zahlen oder vordefinierter Werte. Auf jeden f-Wert wird mit "@" gefolgt von einer Zahl verwiesen, die dem nullbasierten Index für diesen Wert in der Liste der f-Elemente entspricht. [Beispiel: Auf den Wert des zweiten f-Elements wird beispielsweise als "@2" verwiesen. Ende des Beispiels]

[Beispiel: Im Folgenden wird ein blauer Pfeil definiert, der nach rechts zeigt:

<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>  

Die Form sieht wie folgt aus:

Ende des Beispiels]

Übergeordnete Elemente
Formeln (§14.1.2.6)

Attribute

Beschreibung

eqn (Formel)

Gibt eine einzelne Formel an, die aus einem benannten Vorgang gefolgt von bis zu drei Parametern besteht, die in der Regel als v, P1 und P2 beschrieben werden. Es können bis zu 128 Formeln angegeben werden. Diese Vorgänge sind definiert (die Berechnungsgenauigkeit wird unten erläutert): Vorgang Beschreibung Val v Gibt den angegebenen Wert zurück. Genaue. Summe Addition und Subtraktion. Genaue. Produkt Multiplikation und Division. Rundet auf. Mitte Einfacher Durchschnitt. Runden in Richtung Null Abs Absoluter Wert. Genaue. Min Der geringere von zwei Werten. Genaue. Max Der größere von zwei Werten. Genaue. Wenn Bedingte Auswahl. Genaue. Mod Modul. Ungenau. atan2 Trigonometrischer Bogentangens eines Quotienten. Das Ergebnis ist "fd"-Einheiten oder Bruchgrade - Grad . Ungenau. Sünde Sinus. Das Argument befindet sich in "fd"-Einheiten oder Gradbruchteilen – Grad . Ungenau. Cos Kosinus. Das Argument befindet sich in "fd"-Einheiten oder Gradbruchteilen – Grad . Ungenau. cosatan2 Behält die volle Genauigkeit in der Zwischenberechnung bei. Ungenau. sinatan2 Behält die volle Genauigkeit in der Zwischenberechnung bei. Ungenau. Sqrt Quadratwurzel. Das Ergebnis ist positiv und rundet ab. Ungenau. sumangle Fügt einen vorhandenen Winkel in fd-Einheiten (v) zu zwei anderen Winkeln hinzu, die in Grad angegeben sind. P1 und P2 werden von skaliert. Genaue. Ellipse Die Exzentrizitätsformel für eine Ellipse, wobei v die Länge der Semiminorachse und P1 die Länge der Semimajorachse ist. Ungenau. Tan Tangente. Das Argument befindet sich in "fd"-Einheiten oder Gradbruchteilen – Grad . Ungenau. Formeln werden mit voller Genauigkeit ausgewertet, aber das Ergebnis ist immer eine 32-Bit-Ganzzahl. Formelautoren sollten Formeln vermeiden, die diskontinuierlich sind. Viele der trigonometrischen Vorgänge sind nicht nur ungenau, auch die Transformationen innerhalb der Koordinatenräume sind ungenau. Dies kann bedeuten, dass eine Reihe von Formeln, die diskontinuierlich sind, sehr unterschiedliche Pfadwerte mit der gleichen Eingabe auf zwei verschiedenen Systemen ergibt. Wenn ein Vorgang als genau gekennzeichnet ist, muss eine entsprechende Implementierung immer die richtige arithmetische Antwort generieren (es sei denn, die Berechnungen überlaufen intern). Der Produktvorgang muss auf die nächste ganze Zahl gerundet werden. Wenn das Ergebnis genau 0,5 ist, wird es auf die nächste numerisch größere ganze Zahl aufgerundet. Der Mid-Vorgang muss in Richtung 0 gerundet werden. Alle anderen Vorgänge sind ungenau, aber die Implementierung soll nicht integrale Werte nach unten (in Richtung -unendlich) abrunden und interne Berechnungen mit dieser Form der Rundung durchführen. Die bei der Auswertung einer Formel verwendeten Argumente sind normalerweise entweder feste Zahlen, das Ergebnis der Auswertung einer vorherigen Formel oder ein Anpassungswert – der Wert des entsprechenden Eintrags im shape adj-Attribut. Feste Zahlen müssen positive Ganzzahlwerte im Bereich von 0 bis 65535 sein (16-Bit-Zahlen ohne Vorzeichen). Die folgenden benannten Werte werden definiert: Wert Beschreibung @n Der Wert von Formel n, wobei n der nullbasierte Index der Formel in der Liste der Formeln ist. n muss kleiner als der aktuelle Formelindex sein. #n Anpassungswert (adj) n. n muss im Bereich von 0 bis 7 liegen. width Die durch das coordsize-Attribut definierte Breite. height Die durch das Coordsize-Attribut definierte Höhe. xcenter Die x-Ordinate des Mittelpunkts des Koordinatenraums, der durch Koordorigin und Koordsize definiert wird. ycenter Die y-Ordinate des Mittelpunkts des Koordinatenraums, der durch Koordorigin und Koordsize definiert wird. xlimo Der x-Wert des limo-Attributs (siehe auch pfadelement (§14.1.2.14)). ylimo Der y-Wert des limo-Attributs (siehe auch pfadelement (§14.1.2.14)). hasstroke 1, wenn die Form über einen Strichvorgang verfügt, 0, wenn dies nicht der Fall ist, wie durch das on-Attribut des Strichelements bestimmt (§14.1.2.21). hasfill 1, wenn die Form über einen Füllvorgang verfügt, 0, wenn dies nicht der Fall ist, wie durch das on-Attribut des Füllelements bestimmt (§14.1.2.5). pixellinewidth Die Linienbreite in Den Pixeln des Ausgabegeräts. Dies wird verwendet, um Linien vom Rand eines Rechtecks ausgehend von der Annahme zu starten, dass die Implementierung nach unten rechts vor dem oberen linken Pixel zeichnet, wenn sich eine Linie auf einer Pixelgrenze befindet. Pixelwidth Die Breite der Form in Gerätepixeln (d. h. die In Gerätebereich transformierte Koordsize-Breite). Pixelheight Die Höhe der Koordsize in Gerätepixeln. emuwidth Die Breite der Koordsize in EMUs. emuheight Die Höhe der Koordsize in EMUs. emuwidth2 Die halbe Breite der Koordsize in EMUs. emuheight2 Die Hälfte der Höhe der Koordsize in EMUs. Die EMU oder englische Metrikeinheit ist die kleinste Maßeinheit in VML und entspricht 914400 EMU pro Zoll oder 12700 WWU pro Punkt. Ein Beispiel sehen Sie oben. Die möglichen Werte für dieses Attribut sind durch den string-Datentyp des W3C XML-Schemas definiert.

[Hinweis: Die W3C-XML-Schemadefinition des Inhaltsmodells (CT_F) dieses Elements befindet sich in §A.6.1. Ende des Hinweises]

ISO/IEC29500: 2008.

Konstruktoren

Formula()

Initialisiert eine neue instance der Formula-Klasse.

Eigenschaften

ChildElements	Ruft alle untergeordneten Knoten des aktuellen Elements ab. (Geerbt von OpenXmlElement)
Equation	Gleichung Stellt das folgende Attribut im Schema dar: eqn
ExtendedAttributes	Ruft alle erweiterten Attribute (Attribute, die im Schema nicht definiert sind) des aktuellen Elements ab. (Geerbt von OpenXmlElement)
Features	Ruft ein IFeatureCollection für das aktuelle Element ab. Diese Featuresammlung ist schreibgeschützt, erbt jedoch Features von ihrem übergeordneten Teil und Paket, falls verfügbar. (Geerbt von OpenXmlElement)
FirstChild	Ruft das erste untergeordnete Element des OpenXmlElement-Elements ab. Gibt null (Nothing in Visual Basic) zurück, wenn kein solches OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
HasAttributes	Ruft einen Wert ab, der angibt, ob das aktuelle Element über Attribute verfügt. (Geerbt von OpenXmlElement)
HasChildren	Ruft einen Wert ab, der angibt, ob das aktuelle Element über untergeordnete Elemente verfügt. (Geerbt von OpenXmlLeafElement)
InnerText	Ruft die verketteten Werte des Knotens und aller untergeordneten Elemente ab oder legt diese fest. (Geerbt von OpenXmlElement)
InnerXml	Ruft das Markup ab, das nur untergeordnete Elemente des aktuellen Elements darstellt, oder legt dieses fest. (Geerbt von OpenXmlLeafElement)
LastChild	Ruft das letzte untergeordnete Element des OpenXmlElement-Elements ab. Gibt null (Nothing in Visual Basic) zurück, wenn kein solches OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
LocalName	Ruft den lokalen Namen des aktuellen Elements ab. (Geerbt von OpenXmlElement)
MCAttributes	Ruft die Markupkompatibilitätsattribute ab oder legt sie fest. Gibt NULL zurück, wenn für das aktuelle Element keine Markupkompatibilitätsattribute definiert sind. (Geerbt von OpenXmlElement)
NamespaceDeclarations	Ruft alle im aktuellen Element definierten Namespacedeklarationen ab. Gibt einen leeren Enumerator zurück, wenn keine Namespacedeklaration vorhanden ist. (Geerbt von OpenXmlElement)
NamespaceUri	Ruft den Namespace-URI des aktuellen Elements ab. (Geerbt von OpenXmlElement)
OpenXmlElementContext	Ruft den OpenXmlElementContext des aktuellen Elements ab. (Geerbt von OpenXmlElement)
OuterXml	Ruft das Markup ab, das das aktuelle Element und alle untergeordneten Elemente darstellt. (Geerbt von OpenXmlElement)
Parent	Ruft das übergeordnete Element des aktuellen Elements ab. (Geerbt von OpenXmlElement)
Prefix	Ruft das Namespacepräfix des aktuellen Elements ab. (Geerbt von OpenXmlElement)
XmlQualifiedName	Ruft den qualifizierten Namen des aktuellen Elements ab. (Geerbt von OpenXmlElement)
XName	Ruft den qualifizierten Namen des aktuellen Elements ab. (Geerbt von OpenXmlElement)

Methoden

AddAnnotation(Object)	Fügt der Liste der Anmerkungen des aktuellen OpenXmlElement-Elements ein -Objekt hinzu. (Geerbt von OpenXmlElement)
AddNamespaceDeclaration(String, String)	Fügt dem aktuellen Knoten eine Namespacedeklaration hinzu. (Geerbt von OpenXmlElement)
Ancestors()	Listet alle Vorgängerelemente des aktuellen Elements auf. (Geerbt von OpenXmlElement)
Ancestors<T>()	Listet nur die Vorgänger des aktuellen Elements auf, die den angegebenen Typ aufweisen. (Geerbt von OpenXmlElement)
Annotation(Type)	Ruft das erste Anmerkungsobjekt des angegebenen Typs aus dem aktuellen OpenXmlElement-Element ab. (Geerbt von OpenXmlElement)
Annotation<T>()	Ruft das erste Anmerkungsobjekt des angegebenen Typs aus dem aktuellen OpenXmlElement-Element ab. (Geerbt von OpenXmlElement)
Annotations(Type)	Ruft eine Auflistung von Anmerkungen mit dem angegebenen Typ für das aktuelle OpenXmlElement-Element ab. (Geerbt von OpenXmlElement)
Annotations<T>()	Ruft eine Auflistung von Anmerkungen mit dem angegebenen Typ für das aktuelle OpenXmlElement-Element ab. (Geerbt von OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Fügt jedes Element aus einer Liste von Elementen an das Ende der Liste der untergeordneten Elemente des aktuellen Elements an. (Geerbt von OpenXmlElement)
Append(OpenXmlElement[])	Fügt jedes Element aus einem Array von Elementen an das Ende der Liste der untergeordneten Elemente des aktuellen Elements an. (Geerbt von OpenXmlElement)
AppendChild<T>(T)	Fügt das angegebene Element am Ende der Liste der untergeordneten Knoten des aktuellen Elements an. (Geerbt von OpenXmlElement)
ClearAllAttributes()	Löscht alle Attribute, einschließlich bekannter und erweiterter Attribute. (Geerbt von OpenXmlElement)
Clone()	Erstellt ein Duplikat des aktuellen Knotens. (Geerbt von OpenXmlElement)
CloneNode(Boolean)	Erstellt ein Duplikat dieses Knotens.
Descendants()	Listet alle Nachfolger des aktuellen Elements auf. (Geerbt von OpenXmlElement)
Descendants<T>()	Listet alle Nachfolger des aktuellen Elements vom Typ T auf. (Geerbt von OpenXmlElement)
Elements()	Listet alle untergeordneten Elemente des aktuellen Elements auf. (Geerbt von OpenXmlElement)
Elements<T>()	Listet nur die untergeordneten Elemente des aktuellen Elements auf, die den angegebenen Typ aufweisen. (Geerbt von OpenXmlElement)
ElementsAfter()	Listet alle gleichgeordneten Elemente auf, die dem aktuellen Element folgen und dasselbe übergeordnete Element wie das aktuelle Element haben. (Geerbt von OpenXmlElement)
ElementsBefore()	Listet alle gleichgeordneten Elemente auf, die dem aktuellen Element vorausgehen und dasselbe übergeordnete Element wie das aktuelle Element haben. (Geerbt von OpenXmlElement)
GetAttribute(String, String)	Ruft ein Open XML-Attribut mit dem angegebenen Tagnamen und Namespace-URI ab. (Geerbt von OpenXmlElement)
GetAttributes()	Ruft eine Liste ab, die eine Kopie aller Attribute enthält. (Geerbt von OpenXmlElement)
GetEnumerator()	Gibt einen Enumerator zurück, der die untergeordnete Auflistung durchläuft. (Geerbt von OpenXmlElement)
GetFirstChild<T>()	Sucht das erste untergeordnete Element im Typ T. (Geerbt von OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Fügt das angegebene Element unmittelbar nach dem angegebenen Verweiselement ein. (Geerbt von OpenXmlElement)
InsertAfterSelf<T>(T)	Fügt das angegebene Element unmittelbar nach dem aktuellen Element ein. (Geerbt von OpenXmlElement)
InsertAt<T>(T, Int32)	Fügt das angegebene Element am angegebenen Index in die Liste der untergeordneten Elemente des aktuellen Elements ein. (Geerbt von OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Fügt das angegebene Element unmittelbar vor dem angegebenen Verweiselement ein. (Geerbt von OpenXmlElement)
InsertBeforeSelf<T>(T)	Fügt das angegebene Element unmittelbar vor dem aktuellen Element ein. (Geerbt von OpenXmlElement)
IsAfter(OpenXmlElement)	Bestimmt, ob das aktuelle Element nach einem angegebenen Element in Dokumentreihenfolge angezeigt wird. (Geerbt von OpenXmlElement)
IsBefore(OpenXmlElement)	Bestimmt, ob das aktuelle Element vor einem angegebenen Element in Dokumentreihenfolge angezeigt wird. (Geerbt von OpenXmlElement)
LookupNamespace(String)	Löst das Namespacepräfix im Kontext des aktuellen Knotens auf. (Geerbt von OpenXmlElement)
LookupPrefix(String)	Sucht das entsprechende Präfix für einen Namespace-URI im aktuellen Elementbereich. (Geerbt von OpenXmlElement)
NextSibling()	Ruft das OpenXmlElement-Element ab, das unmittelbar auf das aktuelle OpenXmlElement-Element folgt. Gibt null (Nothing in Visual Basic) zurück, wenn kein nächstes OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
NextSibling<T>()	Ruft das OpenXmlElement-Element mit dem angegebenen Typ ab, der auf das aktuelle OpenXmlElement-Element folgt. Gibt null (Nothing in Visual Basic) zurück, wenn kein nächstes OpenXmlElement vorhanden ist. (Geerbt von OpenXmlElement)
PrependChild<T>(T)	Fügt das angegebene Element am Anfang der Liste der untergeordneten Elemente des aktuellen Elements ein. (Geerbt von OpenXmlElement)
PreviousSibling()	Ruft das OpenXmlElement-Element ab, das unmittelbar vor dem aktuellen OpenXmlElement-Element steht. Gibt null (Nothing in Visual Basic ) zurück, wenn kein vorangehendes OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
PreviousSibling<T>()	Ruft das OpenXmlElement-Element mit dem angegebenen Typ ab, der dem aktuellen OpenXmlElement vorangestellt ist. Gibt null (Nothing in Visual Basic) zurück, wenn kein vorheriges OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
Remove()	Entfernt das aktuelle Element aus dem übergeordneten Element. (Geerbt von OpenXmlElement)
RemoveAllChildren()	Entfernt alle untergeordneten Elemente des aktuellen Elements. (Geerbt von OpenXmlLeafElement)
RemoveAllChildren<T>()	Entfernen Sie alle untergeordneten Elemente des aktuellen Elements vom Typ T. (Geerbt von OpenXmlElement)
RemoveAnnotations(Type)	Entfernt die Anmerkungen des angegebenen Typs aus dem aktuellen OpenXmlElement-Element. (Geerbt von OpenXmlElement)
RemoveAnnotations<T>()	Entfernt die Anmerkungen mit dem angegebenen Typ aus dem aktuellen OpenXmlElement-Element. (Geerbt von OpenXmlElement)
RemoveAttribute(String, String)	Entfernt das Attribut aus dem aktuellen Element. (Geerbt von OpenXmlElement)
RemoveChild<T>(T)	Entfernt das angegebene untergeordnete Element aus der Liste der untergeordneten Elemente des aktuellen Elements. (Geerbt von OpenXmlElement)
RemoveNamespaceDeclaration(String)	Entfernt die Namespacedeklaration für das angegebene Präfix. Entfernt nichts, wenn kein Präfix vorhanden ist. (Geerbt von OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Ersetzt ein untergeordnetes Element durch ein anderes untergeordnetes Element in der Liste der untergeordneten Elemente des aktuellen Elements. (Geerbt von OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Legt ein Attribut auf das angegebene Element fest. Wenn das Attribut ein bekanntes Attribut ist, wird der Wert des Attributs festgelegt. Wenn es sich bei dem Attribut um ein erweitertes Attribut handelt, wird das "openxmlAttribute" der Liste der erweiterten Attribute hinzugefügt. (Geerbt von OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Legt eine Reihe von Attributen für das -Element fest. Wenn ein Attribut ein bekanntes Attribut ist, wird der Wert des Attributs festgelegt. Wenn ein Attribut ein erweitertes Attribut ist, wird das "openxmlAttribute" der Liste der erweiterten Attribute hinzugefügt. (Geerbt von OpenXmlElement)
WriteTo(XmlWriter)	Speichert den aktuellen Knoten im angegebenen XmlWriter. (Geerbt von OpenXmlElement)

Explizite Schnittstellenimplementierungen

IEnumerable.GetEnumerator()	Einzelne Formel. Diese Klasse ist in Office 2007 und höher verfügbar. Wenn das Objekt als XML serialisiert wird, lautet der qualifizierte Name v:f. (Geerbt von OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Gibt einen Enumerator zurück, der die untergeordnete Auflistung durchläuft. (Geerbt von OpenXmlElement)