Bookmark.IsEqual Метод (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Определяет, совпадает ли элемент управления Bookmark, к которому применяется этот метод, с диапазоном, указанным в аргументе Range.

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)

Синтаксис

'Декларация
Public Function IsEqual ( _
    Range As Range _
) As Boolean
'Применение
Dim instance As Bookmark
Dim Range As Range
Dim returnValue As Boolean

returnValue = instance.IsEqual(Range)

public bool IsEqual(
    Range Range
)

Параметры

Range
Тип: Microsoft.Office.Interop.Word.Range
Объект Range, сравниваемый с элементом управления Bookmark.

Возвращаемое значение

Тип: System.Boolean
Значение true используется, если элемент управления Bookmark, к которому применяется этот метод, совпадает с диапазоном, указанным в аргументе Range; в противном случае используется значение false.

Заметки

Этот метод сравнивает положения начального и конечного знаков, а также типы статьи. Если все три элемента для обоих объектов совпадают, объекты считаются равными.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Общие сведения о необязательных параметрах в решениях Office.

Примеры

В приведенном ниже примере кода в документ добавляется элемент управления Bookmark с текстом и выясняется, совпадает ли диапазон закладки с диапазоном первого абзаца.

В этом примере демонстрируется настройка уровня документа.

Private Sub BookmarkIsEqual()
    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."
    Bookmark1.InsertAfter(" This is additional text.")

    If Bookmark1.IsEqual(Me.Paragraphs(1).Range) Then
        MessageBox.Show("The bookmark's range is equal to " _
            & "the range of the first paragraph.")
    Else
        MessageBox.Show("The bookmark's range is not equal to " _
            & "the range of the first paragraph.")
    End If

End Sub

private void BookmarkIsEqual()
{
    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.";
    bookmark1.InsertAfter(" This is additional text.");
    if (bookmark1.IsEqual(this.Paragraphs[1].Range))
    {
        MessageBox.Show("The bookmark's range is equal to "+
            "the range of the first paragraph.");
    }
    else
    {
        MessageBox.Show("The bookmark's range is not equal to " +
            "the range of the first paragraph.");
    }
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

Поделиться через