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


Программное определение и выбор диапазонов в документах

Вы можете определить диапазон в документе Microsoft Office Word с помощью объекта Range. Можно выбрать весь документ различными способами, например с помощью Select метода Range объекта или с помощью свойства Document Content класса (в настройке на уровне документа) или Document класса (в надстройке VSTO).

Область применения. Сведения в этом разделе относятся к проектам уровня документа и проектам надстроек VSTO для Word. Дополнительные сведения см. в разделе "Функции", доступные по Приложение Office ликации и типу проекта.

Определение диапазона

В следующем примере показано, как создать объект Range, включающий первые семь символов в активном документе, в том числе непечатаемые символы. Затем выполняется выбор текста в пределах диапазона.

Определение диапазона в настройке на уровне документа

  1. Добавьте диапазон в документ, передав начальный и последний символ в метод Range класса Document. Чтобы использовать этот пример кода, запустите его из класса ThisDocument в своем проекте.

    object start = 0; 
    object end = 7; 
    Word.Range rng = this.Range(ref start, ref end); 
    
    rng.Select();
    

Определение диапазона с помощью надстройки VSTO

  1. Добавьте диапазон в документ, передав начальный и последний символ в метод Range класса Document. Следующий пример кода добавляет диапазон в активный документ. Чтобы использовать этот пример кода, запустите его из класса ThisAddIn в своем проекте.

    Word.Range rng = this.Application.ActiveDocument.Range(0, 7);
    
    rng.Select();
    

Выбор диапазона в настройке уровня документа

В следующих примерах показано, как выделить весь документ с помощью метода Select объекта Range или с помощью свойства Content класса Document.

Выбор всего документа как диапазона с помощью метода Select

  1. Используйте метод Select объекта Range, который содержит весь документ. Чтобы использовать следующий пример кода, выполните его из класса ThisDocument в своем проекте.

    object start = this.Content.Start;
    object end = this.Content.End;
    
    this.Range(ref start, ref end).Select();
    

Выбор всего документа как диапазона с помощью свойства Content

  1. Используйте свойство Content, чтобы определить диапазон, который содержит весь документ.

    this.Content.Select();
    

    Для определения диапазона также можно использовать методы и свойства других объектов.

Выделение предложения в активном документе

  1. Задайте диапазон с помощью коллекции Sentences. Используйте индекс предложения, которое нужно выбрать.

    Word.Range s2 = this.Sentences[2]; 
    s2.Select();
    

    Еще один способ выделения предложения состоит в том, чтобы вручную установить начальное и конечное значение для диапазона.

Выделение предложения вручную с помощью установки начального и конечного значений

  1. Создайте переменную диапазона.

    Word.Range rng;
    
  2. Проверьте наличие по крайней мере двух предложений в документе, задайте аргументы начального и конечного аргументов диапазона, а затем выберите диапазон.

    if (this.Sentences.Count >= 2) 
    {
        object startLocation = this.Sentences[2].Start; 
        object endLocation = this.Sentences[2].End; 
    
        // Supply a Start and End value for the Range. 
        rng = this.Range(ref startLocation, ref endLocation); 
    
        // Select the Range.
        rng.Select();
    }
    

Выбор диапазона с помощью надстройки VSTO

В следующих примерах показано, как выделить весь документ с помощью метода Select объекта Range или с помощью свойства Content класса Document.

Выбор всего документа как диапазона с помощью метода Select

  1. Используйте метод Select объекта Range, который содержит весь документ. Следующий пример кода выделяет содержимое активного документа. Чтобы использовать этот пример кода, запустите его из класса ThisAddIn в своем проекте.

    this.Application.ActiveDocument.Range(
        this.Application.ActiveDocument.Content.Start,
        this.Application.ActiveDocument.Content.End).Select();
    

Выбор всего документа как диапазона с помощью свойства Content

  1. Используйте свойство Content, чтобы определить диапазон, который содержит весь документ.

    this.Application.ActiveDocument.Content.Select();
    

    Для определения диапазона также можно использовать методы и свойства других объектов.

Выделение предложения в активном документе

  1. Задайте диапазон с помощью коллекции Sentences. Используйте индекс предложения, которое нужно выбрать.

    Word.Range s2 = this.Application.ActiveDocument.Sentences[2];
    s2.Select();
    

    Еще один способ выделения предложения состоит в том, чтобы вручную установить начальное и конечное значение для диапазона.

Выделение предложения вручную с помощью установки начального и конечного значений

  1. Создайте переменную диапазона.

    Word.Range rng;
    
  2. Проверьте наличие по крайней мере двух предложений в документе, задайте аргументы начального и конечного аргументов диапазона, а затем выберите диапазон.

    Word.Document document = this.Application.ActiveDocument;
    
    if (document.Sentences.Count >= 2)
    {
        object startLocation = document.Sentences[2].Start;
        object endLocation = document.Sentences[2].End;
    
        // Supply a Start and End value for the Range. 
        rng = document.Range(ref startLocation, ref endLocation);
    
        // Select the Range.
        rng.Select();
    }