RunProperties Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
RunProperties() |
Initialisiert eine neue instance der RunProperties-Klasse. |
RunProperties(OpenXmlElement[]) |
Initialisiert einen neuen instance der RunProperties-Klasse mit den angegebenen untergeordneten Elementen. |
RunProperties(IEnumerable<OpenXmlElement>) |
Initialisiert einen neuen instance der RunProperties-Klasse mit den angegebenen untergeordneten Elementen. |
RunProperties(String) |
Initialisiert eine neue instance der RunProperties-Klasse aus äußerem XML. |
RunProperties()
Initialisiert eine neue instance der RunProperties-Klasse.
public RunProperties ();
Public Sub New ()
Beispiele
Im folgenden Codebeispiel wird ein Textverarbeitungsdokument erstellt und mithilfe bestimmter Schriftarten Text in das Dokument geschrieben. Nachdem Sie das Beispiel ausgeführt haben, überprüfen Sie die erstellte Testdatei, um den Text anzuzeigen.
using System;
using System.Collections.Generic;
using DocumentFormat.OpenXml;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Wordprocessing;
namespace RunPropertiesEx
{
class Program
{
static void Main(string[] args)
{
// This example creates a word processing document and writes
// some text into it using specific fonts.
string filepath = @"C:\Users\Public\Documents\RunPropertiesEx.docx";
using (WordprocessingDocument source =
WordprocessingDocument.Create(filepath, WordprocessingDocumentType
.Document))
{
// Create a Document, Body, and Paragraph objects.
MainDocumentPart mainPart = source.AddMainDocumentPart();
mainPart.Document = new Document();
Body body = mainPart.Document.AppendChild(new Body());
Paragraph paragraph = body.AppendChild(new Paragraph());
// Append a run as source and set its Attributes.
Run srcRunElem = paragraph.AppendChild(new Run(new
Text("Hello, World!")));
RunProperties rPr1 = new RunProperties(new RunFonts()
{ Ascii = "Palace Script MT",
Hint = FontTypeHintValues.ComplexScript },
new Color() { Val = "FF0000" }, new FontSize()
{ Val = "84" });
// Prepend the RunProperties to the Run.
srcRunElem.PrependChild<RunProperties>(rPr1);
// Append another run as target and set its Attributes.
Run targetRun = paragraph.AppendChild(new Run(new Text
("Hello again")));
RunProperties rPr2 = new RunProperties(new RunFonts()
{ Ascii = "Algerian" }, new Color() { Val = "FF00FF" },
new FontSize() { Val = "64" });
// Prepend the RunProperties to the Run.
targetRun.PrependChild<RunProperties>(rPr2);
// Get the SlideSize RunFonts form source and target.
RunFonts srcRunFontsElem = srcRunElem.RunProperties.RunFonts;
RunFonts tgtRunFontsElem = targetRun.RunProperties.RunFonts;
// Retrieve Attributes of the source element.
IList<OpenXmlAttribute> srcRunFontsAttrs = srcRunFontsElem.GetAttributes();
Console.WriteLine("Source Fonts:");
foreach (OpenXmlAttribute a in srcRunFontsAttrs)
{
Console.WriteLine("{0}: {1}", a.LocalName, a.Value);
}
// Call SetAttributes on target RunFonts, changes will be accpeted to target.
// Ascii is updated. And Hint which didn't exist in target, is appended.
tgtRunFontsElem.SetAttributes(srcRunFontsAttrs);
Console.WriteLine("Target Fonts after setting:");
foreach (OpenXmlAttribute a in tgtRunFontsElem.GetAttributes())
{
Console.WriteLine("{0}: {1}", a.LocalName, a.Value);
}
Console.WriteLine("All done. Press a key.");
Console.ReadKey();
}
}
}
}
//Output:
//Source Fonts:
//hint: cs
//ascii: Palace Script MT
//Target Fonts after setting:
//hint: cs
//ascii: Palace Script MT
//All done. Press a key.
Imports System.Collections.Generic
Imports DocumentFormat.OpenXml
Imports DocumentFormat.OpenXml.Packaging
Imports DocumentFormat.OpenXml.Wordprocessing
Module Module1
Sub Main(ByVal args As String())
' This example creates a word processing document and writes
' some text into it using specific fonts.
Dim filepath As String = "C:\Users\Public\Documents\RunPropertiesEx.docx"
Using source As WordprocessingDocument = WordprocessingDocument.Create(filepath, WordprocessingDocumentType.Document)
' Create a Document, Body, and Paragraph objects.
Dim mainPart As MainDocumentPart = source.AddMainDocumentPart()
mainPart.Document = New Document()
Dim body As Body = mainPart.Document.AppendChild(New Body())
Dim paragraph As Paragraph = body.AppendChild(New Paragraph())
' Append a run as source and set its Attributes.
Dim srcRunElem As Run = paragraph.AppendChild(New Run(New Text("Hello, World!")))
Dim rPr1 As New RunProperties(New RunFonts() With { _
.Ascii = "Palace Script MT", _
.Hint = FontTypeHintValues.ComplexScript _
}, New Color() With { _
.Val = "FF0000" _
}, New FontSize() With { _
.Val = "84" _
})
' Prepend the RunProperties to the Run.
srcRunElem.PrependChild(Of RunProperties)(rPr1)
' Append another run as target and set its Attributes.
Dim targetRun As Run = paragraph.AppendChild(New Run(New Text("Hello again")))
Dim rPr2 As New RunProperties(New RunFonts() With { _
.Ascii = "Algerian" _
}, New Color() With { _
.Val = "FF00FF" _
}, New FontSize() With { _
.Val = "64" _
})
' Prepend the RunProperties to the Run.
targetRun.PrependChild(Of RunProperties)(rPr2)
' Get the SlideSize RunFonts form source and target.
Dim srcRunFontsElem As RunFonts = srcRunElem.RunProperties.RunFonts
Dim tgtRunFontsElem As RunFonts = targetRun.RunProperties.RunFonts
' Retrieve Attributes of the source element.
Dim srcRunFontsAttrs As IList(Of OpenXmlAttribute) = srcRunFontsElem.GetAttributes()
Console.WriteLine("Source Fonts:")
For Each a As OpenXmlAttribute In srcRunFontsAttrs
Console.WriteLine("{0}: {1}", a.LocalName, a.Value)
Next
' Call SetAttributes on target RunFonts, changes will be accpeted to target.
' Ascii is updated. And Hint which didn't exist in target, is appended.
tgtRunFontsElem.SetAttributes(srcRunFontsAttrs)
Console.WriteLine("Target Fonts after setting:")
For Each a As OpenXmlAttribute In tgtRunFontsElem.GetAttributes()
Console.WriteLine("{0}: {1}", a.LocalName, a.Value)
Next
Console.WriteLine("All done. Press a key.")
Console.ReadKey()
End Using
End Sub
End Module
'Output:
'Source Fonts:
'hint: cs
'ascii: Palace Script MT
'Target Fonts after setting:
'hint: cs
'ascii: Palace Script MT
'All done. Press a key.
Gilt für:
RunProperties(OpenXmlElement[])
Initialisiert einen neuen instance der RunProperties-Klasse mit den angegebenen untergeordneten Elementen.
public RunProperties (params DocumentFormat.OpenXml.OpenXmlElement[] childElements);
new DocumentFormat.OpenXml.Wordprocessing.RunProperties : DocumentFormat.OpenXml.OpenXmlElement[] -> DocumentFormat.OpenXml.Wordprocessing.RunProperties
Public Sub New (ParamArray childElements As OpenXmlElement())
Parameter
- childElements
- OpenXmlElement[]
Gibt die untergeordneten Elemente an.
Gilt für:
RunProperties(IEnumerable<OpenXmlElement>)
Initialisiert einen neuen instance der RunProperties-Klasse mit den angegebenen untergeordneten Elementen.
public RunProperties (System.Collections.Generic.IEnumerable<DocumentFormat.OpenXml.OpenXmlElement> childElements);
new DocumentFormat.OpenXml.Wordprocessing.RunProperties : seq<DocumentFormat.OpenXml.OpenXmlElement> -> DocumentFormat.OpenXml.Wordprocessing.RunProperties
Public Sub New (childElements As IEnumerable(Of OpenXmlElement))
Parameter
- childElements
- IEnumerable<OpenXmlElement>
Gibt die untergeordneten Elemente an.
Gilt für:
RunProperties(String)
Initialisiert eine neue instance der RunProperties-Klasse aus äußerem XML.
public RunProperties (string outerXml);
new DocumentFormat.OpenXml.Wordprocessing.RunProperties : string -> DocumentFormat.OpenXml.Wordprocessing.RunProperties
Public Sub New (outerXml As String)
Parameter
- outerXml
- String
Gibt den äußeren XML-Code des Elements an.