FormattedText Klas

Definitie

Naamruimte:: System.Windows.Media

Assembly:: PresentationCore.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Biedt besturingselementen op laag niveau voor het tekenen van tekst in Windows Presentation Foundation (WPF)-toepassingen.

public ref class FormattedText

public class FormattedText

type FormattedText = class

Public Class FormattedText

Overname: Object
FormattedText

Voorbeelden

In het volgende voorbeeld wordt een FormattedText object gemaakt en worden vervolgens verschillende opmaakstijlen toegepast op de tekst.

protected override void OnRender(DrawingContext drawingContext)
{
    string testString = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor";

    // Create the initial formatted text string.
    FormattedText formattedText = new FormattedText(
        testString,
        CultureInfo.GetCultureInfo("en-us"),
        FlowDirection.LeftToRight,
        new Typeface("Verdana"),
        32,
        Brushes.Black);

    // Set a maximum width and height. If the text overflows these values, an ellipsis "..." appears.
    formattedText.MaxTextWidth = 300;
    formattedText.MaxTextHeight = 240;

    // Use a larger font size beginning at the first (zero-based) character and continuing for 5 characters.
    // The font size is calculated in terms of points -- not as device-independent pixels.
    formattedText.SetFontSize(36 * (96.0 / 72.0), 0, 5);

    // Use a Bold font weight beginning at the 6th character and continuing for 11 characters.
    formattedText.SetFontWeight(FontWeights.Bold, 6, 11);

    // Use a linear gradient brush beginning at the 6th character and continuing for 11 characters.
    formattedText.SetForegroundBrush(
                            new LinearGradientBrush(
                            Colors.Orange,
                            Colors.Teal,
                            90.0),
                            6, 11);

    // Use an Italic font style beginning at the 28th character and continuing for 28 characters.
    formattedText.SetFontStyle(FontStyles.Italic, 28, 28);

    // Draw the formatted text string to the DrawingContext of the control.
    drawingContext.DrawText(formattedText, new Point(10, 0));
}

Protected Overrides Sub OnRender(ByVal drawingContext As DrawingContext)
    Dim testString As String = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor"

    ' Create the initial formatted text string.
    Dim formattedText As New FormattedText(testString, CultureInfo.GetCultureInfo("en-us"), FlowDirection.LeftToRight, New Typeface("Verdana"), 32, Brushes.Black)

    ' Set a maximum width and height. If the text overflows these values, an ellipsis "..." appears.
    formattedText.MaxTextWidth = 300
    formattedText.MaxTextHeight = 240

    ' Use a larger font size beginning at the first (zero-based) character and continuing for 5 characters.
    ' The font size is calculated in terms of points -- not as device-independent pixels.
    formattedText.SetFontSize(36 * (96.0 / 72.0), 0, 5)

    ' Use a Bold font weight beginning at the 6th character and continuing for 11 characters.
    formattedText.SetFontWeight(FontWeights.Bold, 6, 11)

    ' Use a linear gradient brush beginning at the 6th character and continuing for 11 characters.
    formattedText.SetForegroundBrush(New LinearGradientBrush(Colors.Orange, Colors.Teal, 90.0), 6, 11)

    ' Use an Italic font style beginning at the 28th character and continuing for 28 characters.
    formattedText.SetFontStyle(FontStyles.Italic, 28, 28)

    ' Draw the formatted text string to the DrawingContext of the control.
    drawingContext.DrawText(formattedText, New Point(10, 0))
End Sub

Opmerkingen

Met FormattedText het object kunt u tekst met meerdere regels tekenen, waarin elk teken in de tekst afzonderlijk kan worden opgemaakt. In het volgende voorbeeld ziet u tekst waarop verschillende indelingen zijn toegepast.

Tekst die wordt weergegeven met het object FormattedText Voorbeeld van een opgemaakte tekenreeks

Wat tekstfuncties in WPF betreft, wordt FormattedText beschouwd als 'laag niveau', omdat deze tekst verwerkt als grafische elementen. Andere aspecten van tekst in WPF tekst verwerken in de context van besturingselementen die zijn toegewezen aan tekst (TextBlock, TextBox) implementeert u het stroomdocumentmodel (zie Stroomdocumentoverzicht) of ondersteunt u het XPS-documentmodel (zie Documents in WPF).

Veel van de settermethoden hebben FormattedText overeenkomsten met gekoppelde eigenschappen die worden ondersteund door TextElement, maar de TextElement gekoppelde eigenschappen zijn van toepassing op de tekstondersteuning op een hoger niveau voor stroom of XPS.

Constructors

Name	Description
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, Double)	Initialiseert een nieuw exemplaar van de FormattedText klasse met de opgegeven tekst, cultuur, stroomrichting, lettertype, tekengrootte, voorgrondborstel en pixelsPerDip-waarde.
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, Double)	Initialiseert een nieuw exemplaar van de FormattedText klasse met de opgegeven tekst, cultuur, stroomrichting, lettertype, tekengrootte, voorgrondborstel, gedrag voor nummervervanging en pixelsPerDip-waarde.
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode, Double)	Initialiseert een nieuw exemplaar van de FormattedText klasse met de opgegeven tekst, cultuur, stroomrichting, lettertype, tekengrootte, voorgrondborstel, gedrag voor nummervervanging en pixelsPerDip-waarde.
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode)	Verouderd. Initialiseert een nieuw exemplaar van de FormattedText klasse met de opgegeven tekst, cultuur, stroomrichting, lettertype, tekengrootte, penseel, nummervervangingsgedrag en de modus voor tekstopmaak.
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution)	Verouderd. Initialiseert een nieuw exemplaar van de FormattedText klasse met de opgegeven tekst, cultuur, stroomrichting, lettertypegrootte, penseel en nummervervanging.
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush)	Verouderd. Initialiseert een nieuw exemplaar van de FormattedText klasse met de opgegeven tekst, cultuur, stroomrichting, lettertype, tekengrootte en kwast.

Eigenschappen

Name	Description
Baseline	Hiermee wordt de afstand van de bovenkant van de eerste regel naar de basislijn van de eerste regel van een FormattedText object opgehaald.
Extent	Hiermee haalt u de afstand op van de bovenste getekende pixel van de eerste lijn tot de onderste getekende pixel van de laatste lijn.
FlowDirection	Hiermee wordt het FlowDirection object opgehaald FormattedText of ingesteld.
Height	Hiermee wordt de afstand van de bovenkant van de eerste regel naar de onderkant van de laatste regel van het FormattedText object opgehaald.
LineHeight	Hiermee haalt u de regelhoogte of regelafstand op tussen regels tekst.
MaxLineCount	Hiermee kunt u het maximum aantal regels ophalen of instellen dat moet worden weergegeven. Tekst die de MaxLineCount tekst overschrijdt, wordt niet weergegeven.
MaxTextHeight	Hiermee haalt u de maximale hoogte van een tekstkolom op of stelt u deze in.
MaxTextWidth	Hiermee haalt u de maximale tekstbreedte (lengte) voor een tekstregel op of stelt u deze in.
MinWidth	Hiermee haalt u de kleinste tekstbreedte op die de opgegeven tekstinhoud volledig kan bevatten.
OverhangAfter	Hiermee wordt de afstand van de onderkant van de laatste tekstregel naar de onderste getekende pixel opgehaald.
OverhangLeading	Hiermee wordt de maximale afstand van het voorloopuitlijningspunt naar de getekende pixel van een lijn opgehaald.
OverhangTrailing	Hiermee haalt u de maximale afstand op van de afsluitende pixel naar het uitlijningspunt van een lijn.
PixelsPerDip	De PixelsPerDip ophalen of instellen waarop de tekst moet worden weergegeven.
Text	Hiermee wordt de tekenreeks opgehaald die moet worden weergegeven.
TextAlignment	Hiermee wordt de uitlijning van tekst binnen een FormattedText object opgehaald of ingesteld.
Trimming	Hiermee haalt u de middelen op waarmee het weglaten van tekst wordt aangegeven.
Width	Hiermee haalt u de breedte op tussen de voorloop- en volguitlijningspunten van een lijn, met uitzondering van eventuele volgspaties.
WidthIncludingTrailingWhitespace	Hiermee haalt u de breedte op tussen de voorloop- en volguitlijningspunten van een lijn, inclusief eventuele volgspaties.

Methoden

Name	Description
BuildGeometry(Point)	Retourneert een Geometry object dat de opgemaakte tekst vertegenwoordigt, inclusief alle glyphs en tekstdecoraties.
BuildHighlightGeometry(Point, Int32, Int32)	Hiermee wordt een Geometry object geretourneerd dat het begrenzingsvak voor een opgegeven subtekenreeks van de opgemaakte tekst vertegenwoordigt.
BuildHighlightGeometry(Point)	Hiermee wordt een Geometry object geretourneerd dat het begrenzingsvak van de opgemaakte tekst voorstelt.
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetMaxTextWidths()	Hiermee wordt een matrix met tekstbreedten opgehaald. Elk element in de matrix vertegenwoordigt de maximale tekstbreedte van opeenvolgende regels tekst.
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
SetCulture(CultureInfo, Int32, Int32)	Hiermee stelt u de CultureInfo voor een opgegeven subset tekens in het FormattedText object in.
SetCulture(CultureInfo)	Hiermee stelt u de CultureInfo voor de volledige set tekens in het FormattedText object in.
SetFontFamily(FontFamily, Int32, Int32)	Hiermee stelt u de lettertypefamilie in voor een opgegeven subset tekens in het FormattedText object.
SetFontFamily(FontFamily)	Hiermee stelt u de lettertypefamilie voor een FormattedText object in.
SetFontFamily(String, Int32, Int32)	Hiermee stelt u de lettertypefamilie in voor een opgegeven subset tekens in het FormattedText object.
SetFontFamily(String)	Hiermee stelt u de lettertypefamilie in voor de hele set tekens in het FormattedText object.
SetFontSize(Double, Int32, Int32)	Hiermee stelt u de tekengrootte in voor een opgegeven subset tekens in het FormattedText object.
SetFontSize(Double)	Hiermee stelt u de tekengrootte in voor de volledige set tekens in het FormattedText object.
SetFontStretch(FontStretch, Int32, Int32)	Hiermee stelt u de tekenreekswaarde in voor een opgegeven subset van tekens in het FormattedText object.
SetFontStretch(FontStretch)	Hiermee stelt u de tekenreekswaarde in voor de volledige set tekens in het FormattedText object.
SetFontStyle(FontStyle, Int32, Int32)	Hiermee stelt u de tekenstijl in voor een opgegeven subset tekens in het FormattedText object.
SetFontStyle(FontStyle)	Hiermee stelt u de tekenstijl in voor de volledige set tekens in het FormattedText object.
SetFontTypeface(Typeface, Int32, Int32)	Hiermee stelt u het lettertypetype in voor een opgegeven subset tekens in het FormattedText object.
SetFontTypeface(Typeface)	Hiermee stelt u het lettertype in voor de volledige set tekens in het FormattedText object.
SetFontWeight(FontWeight, Int32, Int32)	Hiermee wijzigt u de FontWeight voor opgegeven tekst in een FormattedText object.
SetFontWeight(FontWeight)	Hiermee stelt u het tekengewicht in voor de volledige set tekens in het FormattedText object.
SetForegroundBrush(Brush, Int32, Int32)	Hiermee wijzigt u de voorgrond Brush voor de opgegeven tekst in een FormattedText object.
SetForegroundBrush(Brush)	Hiermee wijzigt u de voorgrond Brush voor een heel FormattedText object.
SetMaxTextWidths(Double[])	Hiermee stelt u een matrix in van maximale tekstbreedten binnen de FormattedText, per regel. Elk element in de matrix vertegenwoordigt de maximale tekstbreedte van opeenvolgende regels tekst.
SetNumberSubstitution(NumberSubstitution, Int32, Int32)	Hiermee stelt u het gedrag voor het vervangen van getallen voor opgegeven tekst in een FormattedText object in.
SetNumberSubstitution(NumberSubstitution)	Hiermee stelt u het gedrag voor het vervangen van getallen in voor de volledige set tekens in het FormattedText object.
SetTextDecorations(TextDecorationCollection, Int32, Int32)	Hiermee stelt u de TextDecorationCollection voor opgegeven tekst in een FormattedText object in.
SetTextDecorations(TextDecorationCollection)	Hiermee stelt u de TextDecorationCollection voor de volledige set tekens in het FormattedText object in.
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?