CharacterRange Estrutura

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

CharacterRange.cs

Especifica um intervalo de posições de caractere em uma cadeia de caracteres.

C#

public struct CharacterRange : IEquatable<System.Drawing.CharacterRange>

Herança

Object

ValueType

CharacterRange

Implementações

IEquatable<CharacterRange>

Exemplos

O exemplo de código a seguir demonstra como criar um CharacterRange e usá-lo para realçar parte de uma cadeia de caracteres. Este exemplo foi projetado para ser usado com Windows Forms. Cole o exemplo em um formulário e chame o HighlightACharacterRange método ao manipular o evento do Paint formulário, passando e como PaintEventArgs.

C#

private void HighlightACharacterRange(PaintEventArgs e)
{

    // Declare the string to draw.
    string message = "This is the string to highlight a word in.";

    // Declare the word to highlight.
    string searchWord = "string";

    // Create a CharacterRange array with the searchWord 
    // location and length.
    CharacterRange[] ranges = 
        new CharacterRange[]{new CharacterRange
        (message.IndexOf(searchWord), searchWord.Length)};

    // Construct a StringFormat object.
    StringFormat stringFormat1 = new StringFormat();

    // Set the ranges on the StringFormat object.
    stringFormat1.SetMeasurableCharacterRanges(ranges);

    // Declare the font to write the message in.
    Font largeFont = new Font(FontFamily.GenericSansSerif, 16.0F,
        GraphicsUnit.Pixel);

    // Construct a new Rectangle.
    Rectangle displayRectangle = new Rectangle(20, 20, 200, 100);

    // Convert the Rectangle to a RectangleF.
    RectangleF displayRectangleF = (RectangleF)displayRectangle;

    // Get the Region to highlight by calling the 
    // MeasureCharacterRanges method.
    Region[] charRegion = e.Graphics.MeasureCharacterRanges(message, 
        largeFont, displayRectangleF, stringFormat1);

    // Draw the message string on the form.
    e.Graphics.DrawString(message, largeFont, Brushes.Blue, 
        displayRectangleF);

    // Fill in the region using a semi-transparent color.
    e.Graphics.FillRegion(new SolidBrush(Color.FromArgb(50, Color.Fuchsia)), 
        charRegion[0]);

    largeFont.Dispose();
}

Construtores

CharacterRange(Int32, Int32)

Inicializa uma nova instância da estrutura CharacterRange, especificando um intervalo de posições de caracteres em uma cadeia de caracteres.

Propriedades

First	Obtém ou define a posição na cadeia de caracteres do primeiro caractere deste CharacterRange.
Length	Obtém ou define o número de posições neste CharacterRange.

Métodos

Equals(CharacterRange)	Indica se a instância atual é igual a outra instância do mesmo tipo.
Equals(Object)	Obtém um valor que indica se esse objeto é equivalente ao objeto especificado.
GetHashCode()	Retorna o código hash para a instância.

Operadores

Equality(CharacterRange, CharacterRange)	Compara dois objetos CharacterRange. Obtém um valor que indica se os valores de First e Length dos dois objetos CharacterRange são iguais.
Inequality(CharacterRange, CharacterRange)	Compara dois objetos CharacterRange. Obtém um valor que indica se os valores de First ou Length dos dois objetos CharacterRange não são iguais.

Aplica-se a