StringFormatFlags Enumeração
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Especifica a informação de visualização e layout para cadeias de texto.
Esta enumeração suporta uma combinação bit-a-bit dos respetivos valores membro.
public enum class StringFormatFlags[System.Flags]
public enum StringFormatFlags[<System.Flags>]
type StringFormatFlags = Public Enum StringFormatFlags- Herança
- Atributos
Campos
| Name | Valor | Description |
|---|---|---|
| DirectionRightToLeft | 1 | O texto é apresentado da direita para a esquerda. |
| DirectionVertical | 2 | O texto está alinhado verticalmente. |
| FitBlackBox | 4 | Partes dos caracteres podem sobressair sobre o retângulo de disposição da cadeia. Por defeito, as personagens são reposicionadas para evitar qualquer saliência. |
| DisplayFormatControl | 32 | Caracteres de controlo, como a marca da esquerda para a direita, são mostrados na saída com um glifo representativo. |
| NoFontFallback | 1024 | A opção de recurso para fontes alternativas para caracteres não suportados na fonte solicitada está desativada. Quaisquer caracteres em falta são exibidos com glifos em falta das fontes, normalmente um quadrado aberto. |
| MeasureTrailingSpaces | 2048 | Inclui o espaço final no final de cada linha. Por defeito, o retângulo de fronteira devolvido pelo MeasureString método exclui o espaço no final de cada linha. Defina este flag para incluir esse espaço na medição. |
| NoWrap | 4096 | O enrolamento de texto entre linhas ao formatar dentro de um retângulo está desativado. Esta bandeira é implícita quando um ponto é ultrapassado em vez de um retângulo, ou quando o retângulo especificado tem comprimento de linha zero. |
| LineLimit | 8192 | Apenas linhas inteiras estão dispostas no retângulo de formatação. Por defeito, o layout continua até ao final do texto, ou até que não sejam visíveis mais linhas devido ao clipping, o que acontecer primeiro. Note que as definições padrão permitem que a última linha seja parcialmente obscurecida por um retângulo de formatação que não seja um múltiplo inteiro da altura da linha. Para garantir que apenas linhas inteiras são vistas, especifique este valor e tenha o cuidado de fornecer um retângulo de formatação com pelo menos a altura de uma linha. |
| NoClip | 16384 | Partes salientes dos glifos e texto não embrulhado que se estende para fora do retângulo de formatação são permitidos a aparecer. Por defeito, todo o texto e as partes de glifos que se estendem para fora do retângulo de formatação são cortadas. |
Exemplos
O seguinte exemplo de código demonstra os seguintes membros:
Este exemplo foi concebido para ser usado com Windows Forms. Cole o código num formulário e chame o ShowLineAndAlignment método ao tratar o evento do Paint formulário, passando e como 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
Observações
StringFormatFlags é utilizado pela StringFormat turma.
Note
O campo FitBlackBox foi mal nomeado e o seu comportamento é semelhante ao NoFitBlackBox campo da implementação original do GDI+.