StringFormatFlags Enum
Definitie
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.
Hiermee geeft u de weergave- en indelingsgegevens voor tekenreeksen op.
Deze opsomming ondersteunt een bitsgewijze combinatie van de waarden van de leden.
public enum class StringFormatFlags
[System.Flags]
public enum StringFormatFlags
[<System.Flags>]
type StringFormatFlags =
Public Enum StringFormatFlags
- Overname
- Kenmerken
Velden
| Name | Waarde | Description |
|---|---|---|
| DirectionRightToLeft | 1 | Tekst wordt van rechts naar links weergegeven. |
| DirectionVertical | 2 | Tekst wordt verticaal uitgelijnd. |
| FitBlackBox | 4 | Delen van tekens mogen de rechthoek van de tekenreeksindeling overhangen. Standaard worden tekens verplaatst om eventuele overhang te voorkomen. |
| DisplayFormatControl | 32 | Besturingstekens zoals de links-naar-rechts-markering worden weergegeven in de uitvoer met een representatieve symbool. |
| NoFontFallback | 1024 | Terugval naar alternatieve lettertypen voor tekens die niet worden ondersteund in het aangevraagde lettertype, is uitgeschakeld. Ontbrekende tekens worden weergegeven met de lettertypen die ontbreken, meestal een open vierkant. |
| MeasureTrailingSpaces | 2048 | Bevat de volgruimte aan het einde van elke regel. Standaard sluit de grensrechthoek die door de MeasureString methode wordt geretourneerd de ruimte aan het einde van elke regel uit. Stel deze vlag in om die ruimte in de meting op te nemen. |
| NoWrap | 4096 | Tekstterugloop tussen regels wanneer opmaak in een rechthoek is uitgeschakeld. Deze vlag wordt geïmpliceerd wanneer een punt wordt doorgegeven in plaats van een rechthoek, of wanneer de opgegeven rechthoek een regellengte van nul heeft. |
| LineLimit | 8192 | Alleen volledige lijnen worden in de rechthoek met opmaak weergegeven. Standaard wordt de indeling voortgezet tot het einde van de tekst of totdat er geen regels meer zichtbaar zijn als gevolg van het knippen, afhankelijk van wat het eerst voorkomt. Houd er rekening mee dat de standaardinstellingen ervoor zorgen dat de laatste regel gedeeltelijk wordt verborgen door een opmaakrechthoek die niet een geheel veelvoud van de lijnhoogte is. Als u ervoor wilt zorgen dat alleen hele lijnen worden weergegeven, geeft u deze waarde op en moet u voorzichtig zijn met het opgeven van een opmaakrechthoek die minstens zo hoog is als de hoogte van één regel. |
| NoClip | 16384 | Overhangende delen van glyphs en niet-uitgepakte tekst die buiten de rechthoek met opmaak komt, mogen worden weergegeven. Standaard worden alle tekst- en glyph-onderdelen die buiten de rechthoek met opmaak vallen, geknipt. |
Voorbeelden
In het volgende codevoorbeeld ziet u de volgende leden:
Dit voorbeeld is ontworpen voor gebruik met Windows Forms. Plak de code in een formulier en roep de methode aan bij het ShowLineAndAlignment verwerken van de gebeurtenis van Paint het formulier, waarbij deze wordt doorgegeven e als PaintEventArgs.
private:
void ShowLineAndAlignment( PaintEventArgs^ e )
{
// Construct a new Rectangle .
Rectangle displayRectangle = Rectangle(Point(40,40),System::Drawing::Size( 80, 80 ));
// Construct 2 new StringFormat objects
StringFormat^ format1 = gcnew StringFormat( StringFormatFlags::NoClip );
StringFormat^ format2 = gcnew StringFormat( format1 );
// Set the LineAlignment and Alignment properties for
// both StringFormat objects to different values.
format1->LineAlignment = StringAlignment::Near;
format1->Alignment = StringAlignment::Center;
format2->LineAlignment = StringAlignment::Center;
format2->Alignment = StringAlignment::Far;
// Draw the bounding rectangle and a string for each
// StringFormat object.
e->Graphics->DrawRectangle( Pens::Black, displayRectangle );
e->Graphics->DrawString( "Showing Format1", this->Font, Brushes::Red, displayRectangle, format1 );
e->Graphics->DrawString( "Showing Format2", this->Font, Brushes::Red, displayRectangle, format2 );
}
private void ShowLineAndAlignment(PaintEventArgs e)
{
// Construct a new Rectangle .
Rectangle displayRectangle =
new Rectangle (new Point(40, 40), new Size (80, 80));
// Construct 2 new StringFormat objects
StringFormat format1 = new StringFormat(StringFormatFlags.NoClip);
StringFormat format2 = new StringFormat(format1);
// Set the LineAlignment and Alignment properties for
// both StringFormat objects to different values.
format1.LineAlignment = StringAlignment.Near;
format1.Alignment = StringAlignment.Center;
format2.LineAlignment = StringAlignment.Center;
format2.Alignment = StringAlignment.Far;
// Draw the bounding rectangle and a string for each
// StringFormat object.
e.Graphics.DrawRectangle(Pens.Black, displayRectangle);
e.Graphics.DrawString("Showing Format1", this.Font,
Brushes.Red, (RectangleF)displayRectangle, format1);
e.Graphics.DrawString("Showing Format2", this.Font,
Brushes.Red, (RectangleF)displayRectangle, format2);
}
Private Sub ShowLineAndAlignment(ByVal e As PaintEventArgs)
' Construct a new Rectangle.
Dim displayRectangle _
As New Rectangle(New Point(40, 40), New Size(80, 80))
' Construct two new StringFormat objects
Dim format1 As New StringFormat(StringFormatFlags.NoClip)
Dim format2 As New StringFormat(format1)
' Set the LineAlignment and Alignment properties for
' both StringFormat objects to different values.
format1.LineAlignment = StringAlignment.Near
format1.Alignment = StringAlignment.Center
format2.LineAlignment = StringAlignment.Center
format2.Alignment = StringAlignment.Far
' Draw the bounding rectangle and a string for each
' StringFormat object.
e.Graphics.DrawRectangle(Pens.Black, displayRectangle)
e.Graphics.DrawString("Showing Format1", Me.Font, Brushes.Red, _
RectangleF.op_Implicit(displayRectangle), format1)
e.Graphics.DrawString("Showing Format2", Me.Font, Brushes.Red, _
RectangleF.op_Implicit(displayRectangle), format2)
End Sub
Opmerkingen
StringFormatFlags wordt gebruikt door de StringFormat klasse.
Note
Het veld FitBlackBox is onjuist genoemd en het gedrag is vergelijkbaar met het NoFitBlackBox veld in de oorspronkelijke GDI+ implementatie.