다음을 통해 공유


프로그래밍 방식으로 문서의 범위 정의 및 선택

Range 개체를 사용하여 Microsoft Office Word 문서의 범위를 정의할 수 있습니다. Range 개체의 Select 메서드 사용, Document 클래스(문서 수준 사용자 지정) 또는 Document 클래스(VSTO 추가 기능)의 Content 속성 사용 등 여러 가지 방법으로 전체 문서를 선택할 수 있습니다.

적용 대상: 이 항목의 정보는 Word의 문서 수준 프로젝트 및 VSTO 추가 기능 프로젝트에 적용됩니다. 자세한 내용은 Office 애플리케이션 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하세요.

범위 정의

다음 예제에서는 인쇄할 수 없는 문자를 비롯하여 활성 문서의 처음 7자를 포함하는 새로운 Range 개체를 만드는 방법을 보여 줍니다. 그런 다음 범위 내의 텍스트를 선택합니다.

문서 수준 사용자 지정의 범위를 정의하려면

  1. Document 클래스의 Range 메서드에 시작 및 끝 문자를 전달하여 문서에 범위를 추가합니다. 이 코드 예제를 사용하려면 프로젝트의 ThisDocument 클래스에서 실행합니다.

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

VSTO 추가 기능을 사용하여 범위를 정의하려면

  1. Document 클래스의 Range 메서드에 시작 및 끝 문자를 전달하여 문서에 범위를 추가합니다. 다음 코드 예제에서는 활성 문서에 범위를 추가합니다. 이 코드 예제를 사용하려면 프로젝트의 ThisAddIn 클래스에서 실행합니다.

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

문서 수준 사용자 지정의 범위 선택

다음 예제에서는 Range 개체의 Select 메서드를 사용하거나 Document 클래스의 Content 속성을 사용하여 전체 문서를 선택하는 방법을 보여 줍니다.

Select 메서드를 사용하여 전체 문서를 범위로 선택하려면

  1. 전체 문서를 포함하는 RangeSelect 메서드를 사용합니다. 다음 코드 예제를 사용하려면 프로젝트의 ThisDocument 클래스에서 실행합니다.

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

콘텐츠 속성을 사용하여 전체 문서를 범위로 선택하려면

  1. Content 속성을 사용하여 전체 문서를 포함하는 범위를 정의합니다.

    this.Content.Select();
    

    다른 개체의 메서드와 속성을 사용하여 범위를 정의할 수도 있습니다.

활성 문서에서 문장을 선택하려면

  1. Sentences 컬렉션을 사용하여 범위를 설정합니다. 선택하려는 문장의 인덱스를 사용합니다.

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

    문장을 선택하는 다른 방법은 범위의 시작 및 끝 값을 수동으로 설정하는 것입니다.

시작 및 끝 값을 수동으로 설정하여 문장을 선택하려면

  1. 범위 변수를 만듭니다.

    Word.Range rng;
    
  2. 문서에 둘 이상의 문장이 있는지 확인하고, 범위의 StartEnd 인수를 설정한 다음, 범위를 선택합니다.

    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 추가 기능을 사용하여 범위 선택

다음 예제에서는 Range 개체의 Select 메서드를 사용하거나 Document 클래스의 Content 속성을 사용하여 전체 문서를 선택하는 방법을 보여 줍니다.

Select 메서드를 사용하여 전체 문서를 범위로 선택하려면

  1. 전체 문서를 포함하는 RangeSelect 메서드를 사용합니다. 다음 코드 예제에서는 활성 문서의 내용을 선택합니다. 이 코드 예제를 사용하려면 프로젝트의 ThisAddIn 클래스에서 실행합니다.

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

콘텐츠 속성을 사용하여 전체 문서를 범위로 선택하려면

  1. Content 속성을 사용하여 전체 문서를 포함하는 범위를 정의합니다.

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

    다른 개체의 메서드와 속성을 사용하여 범위를 정의할 수도 있습니다.

활성 문서에서 문장을 선택하려면

  1. Sentences 컬렉션을 사용하여 범위를 설정합니다. 선택하려는 문장의 인덱스를 사용합니다.

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

    문장을 선택하는 다른 방법은 범위의 시작 및 끝 값을 수동으로 설정하는 것입니다.

시작 및 끝 값을 수동으로 설정하여 문장을 선택하려면

  1. 범위 변수를 만듭니다.

    Word.Range rng;
    
  2. 문서에 둘 이상의 문장이 있는지 확인하고, 범위의 StartEnd 인수를 설정한 다음, 범위를 선택합니다.

    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();
    }