ITextRange.Delete(TextRangeUnit, Int32) Método

Definição

Namespace:

Microsoft.UI.Text

Exclui o texto do intervalo de texto.

public:
 int Delete(TextRangeUnit unit, int count);

int Delete(TextRangeUnit const& unit, int const& count);

public int Delete(TextRangeUnit unit, int count);

function delete(unit, count)

Public Function Delete (unit As TextRangeUnit, count As Integer) As Integer

Parâmetros

unit

TextRangeUnit

A unidade de texto a ser excluída.

count

Int32

int

O número de unidades a serem excluídas. Consulte Observações.

Retornos

Int32

int

O número de unidades excluídas. Excluir o texto em um intervalo de texto não descritivo conta como uma unidade.

Comentários

Se count for zero, esse método excluirá todo o texto no intervalo de texto. Nada será excluído se o intervalo de texto for apenas um ponto de inserção (ou seja, um intervalo degenerado).

Se count não for zero e o intervalo for um ponto de inserção, | count | as unidades (valor absoluto da contagem) serão excluídas na direção lógica fornecida pelo sinal de contagem, em que um valor positivo está no final da história e um valor negativo está no início da história.

Se count não for zero e o intervalo for não descritivo (contém texto), o texto no intervalo será excluído independentemente dos valores de unidade e contagem, resultando em um ponto de inserção. Em seguida, | count | - 1 as unidades são excluídas na direção lógica fornecida pelo sinal de contagem.

O texto no intervalo também pode ser excluído atribuindo uma cadeia de caracteres nula ao intervalo.

Excluir o CR resulta no seguinte comportamento:

• Se você excluir apenas o CR, mas o parágrafo incluir texto, o CR será excluído e o parágrafo a seguir obterá a mesma formatação de parágrafo que a atual.
• Se você excluir o CR, bem como alguns, mas não todos, dos caracteres no parágrafo a seguir, os caracteres restantes do parágrafo atual obterão a formatação de parágrafo do parágrafo a seguir.
• Se você selecionar até o final de um parágrafo, mas não o parágrafo inteiro, o CR não será excluído.
• Se você excluir o parágrafo inteiro (do início até o CR), exclua o CR também (a menos que seja o CR final no arquivo).