StringFormatFlags StringFormatFlags StringFormatFlags StringFormatFlags Enum

Определение

Указывает сведения об отображении и размещении строк текста.Specifies the display and layout information for text strings.

Это перечисление имеет атрибут FlagsAttribute, который разрешает побитовое сочетание значений его элементов.

public enum class StringFormatFlags
[System.Flags]
public enum StringFormatFlags
type StringFormatFlags = 
Public Enum StringFormatFlags
Наследование
StringFormatFlagsStringFormatFlagsStringFormatFlagsStringFormatFlags
Атрибуты

Поля

DirectionRightToLeft DirectionRightToLeft DirectionRightToLeft DirectionRightToLeft 1

Отображает текст справа налево.Text is displayed from right to left.

DirectionVertical DirectionVertical DirectionVertical DirectionVertical 2

Текст выравнивается по вертикали.Text is vertically aligned.

DisplayFormatControl DisplayFormatControl DisplayFormatControl DisplayFormatControl 32

Управляющие символы, такие как метка слева направо, показываются в выходных данных с помощью характерного глифа.Control characters such as the left-to-right mark are shown in the output with a representative glyph.

FitBlackBox FitBlackBox FitBlackBox FitBlackBox 4

Частям символов разрешается выступать за границы прямоугольника строки.Parts of characters are allowed to overhang the string's layout rectangle. По умолчанию положение символов изменяется во избежание какого-либо выступа.By default, characters are repositioned to avoid any overhang.

LineLimit LineLimit LineLimit LineLimit 8192

В прямоугольнике форматирования размещаются только целые строки.Only entire lines are laid out in the formatting rectangle. По умолчанию форматирование продолжается либо до конца текста, либо до того места, после которого в результате усечения отсутствуют видимые строки.By default layout continues until the end of the text, or until no more lines are visible as a result of clipping, whichever comes first. Следует иметь в виду, что стандартные параметры разрешают частично скрывать последнюю строку в прямоугольнике форматирования, высота которого не кратна высоте строки.Note that the default settings allow the last line to be partially obscured by a formatting rectangle that is not a whole multiple of the line height. Чтобы отображались только целые строки, задайте это значение, не забыв предусмотреть, чтобы высота прямоугольника форматирования была не меньше высоты одной строки.To ensure that only whole lines are seen, specify this value and be careful to provide a formatting rectangle at least as tall as the height of one line.

MeasureTrailingSpaces MeasureTrailingSpaces MeasureTrailingSpaces MeasureTrailingSpaces 2048

Вставляет замыкающий пробел в конце каждой строки.Includes the trailing space at the end of each line. По умолчанию ограничивающий прямоугольник, возвращаемый методом MeasureString, исключает пробелы в конце каждой строки.By default the boundary rectangle returned by the MeasureString method excludes the space at the end of each line. Установите этот флаг, чтобы включить в результат измерения эти пробелы.Set this flag to include that space in measurement.

NoClip NoClip NoClip NoClip 16384

Разрешается отображать выступающие части глифов и текст, выходящий за пределы прямоугольной зоны форматирования.Overhanging parts of glyphs, and unwrapped text reaching outside the formatting rectangle are allowed to show. По умолчанию весь текст и части глифов, выступающие за границы прямоугольника форматирования, отсекаются.By default all text and glyph parts reaching outside the formatting rectangle are clipped.

NoFontFallback NoFontFallback NoFontFallback NoFontFallback 1024

Переход к альтернативным шрифтам для знаков, не поддерживаемых в требуемом шрифте, отключен.Fallback to alternate fonts for characters not supported in the requested font is disabled. Все недостающие символы отображаются с помощью глифа отсутствия шрифтов, обычно пустого квадрата.Any missing characters are displayed with the fonts missing glyph, usually an open square.

NoWrap NoWrap NoWrap NoWrap 4096

Автоматический перенос на новую строку при форматировании в прямоугольнике отключен.Text wrapping between lines when formatting within a rectangle is disabled. Этот флаг означает передачу точки вместо прямоугольника или нулевую длину строки указанного прямоугольника.This flag is implied when a point is passed instead of a rectangle, or when the specified rectangle has a zero line length.

Примеры

В следующем примере кода показаны следующие члены:The following code example demonstrates the following members:

Этот пример предназначен для использования с Windows Forms.This example is designed to be used with Windows Forms. Вставьте код в форму и вызовите ShowLineAndAlignment метод при обработке формы Paint передачи событий e как PaintEventArgs.Paste the code into a form and call the ShowLineAndAlignment method when handling the form's Paint event, passing e as 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

Комментарии

StringFormatFlags используется StringFormat класса.StringFormatFlags is used by the StringFormat class.

Примечание

Поле FitBlackBox был неправильное название и его поведение аналогично NoFitBlackBox в исходной реализации GDI +.The FitBlackBox field was misnamed and its behavior is similar to the NoFitBlackBox field in the original GDI+ implementation.

Применяется к