Método Bookmark.MoveUntil

Artigo
08/01/2011

Move o Bookmark o controle até um dos caracteres especificados é localizado no documento.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)

Sintaxe

'Declaração
Function MoveUntil ( _
    ByRef cset As Object, _
    ByRef count As Object _
) As Integer

int MoveUntil(
    ref Object cset,
    ref Object count
)

Parâmetros

cset
Tipo: System.Object%
Um ou mais caracteres.Se qualquer caractere no Cset encontra-se antes de Count valor expira, o Bookmark controle está posicionado como um ponto de inserção imediatamente antes desse caractere.Esse argumento diferencia maiúsculas de minúsculas.

count
Tipo: System.Object%
O número máximo de caracteres pelo qual o Bookmark controle será movida.Pode ser um número ou ambos os wdForward ou wdBackward constante.Se Count é um número positivo, o Bookmark controle é movida para frente no documento, começando na posição ' end '.Se for um número negativo, o Bookmark controle será movido para trás, começando na posição ' Iniciar '.O valor padrão é wdForward.

Valor de retorno

Tipo: System.Int32
O número de caracteres pelo qual o Bookmark controle foi movido.Se Count for maior que 0 (zero), esse método retorna o número de caracteres movidos mais um.Se Count é menor que 0 (zero), esse método retorna o número de caracteres movidos menos um.Se nenhum Cset caracteres forem encontrados, o Bookmark controle não será alterado e o método retorna 0 (zero).

Comentários

O Bookmark é recolhido um indicador de comprimento zero.

Optional Parameters

Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir adiciona um Bookmark controlar o texto ao primeiro parágrafo e, em seguida, adiciona outro Bookmark o controle para a terceira palavra do primeiro indicador. O código, em seguida, move o intervalo do segundo indicador enquanto ele possa encontrar um espaço em branco.

Este exemplo é para uma personalização em nível de documento.

Private Sub BookmarkMoveUntil()

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")

    Bookmark1.Text = "This is sample bookmark text."

    Dim Bookmark2 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Bookmark1.Words(3), "Bookmark2")

    Bookmark2.MoveUntil(" ", Bookmark1.Characters.Count)
End Sub

private void BookmarkMoveUntil()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    bookmark1.Text = "This is sample bookmark text.";

    Microsoft.Office.Tools.Word.Bookmark bookmark2 =
        this.Controls.AddBookmark(bookmark1.Words[3],
        "bookmark2");

    object Count = bookmark1.Characters.Count;
    object cSet = " ";

    bookmark2.MoveUntil(ref cSet, ref Count);
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Bookmark Interface

Namespace Microsoft.Office.Tools.Word

Partilhar via