프로그래밍 방식으로 문서의 범위 확장

Microsoft Office Word 문서에서 Range 개체를 정의한 후 MoveStart 및 MoveEnd 메서드를 사용하여 해당 개체의 시작점과 끝점을 변경합니다. MoveStart 메서드와 MoveEnd 메서드는 Unit과 Count라는 두 개의 인수를 동일하게 사용합니다. Count 인수는 이동 단위 수이며 Unit 인수는 다음 WdUnits 값 가운데 하나입니다.

• wdCharacter

• wdWord

• wdSentence

• wdParagraph

• wdSection

• wdStory

• wdCell

• wdColumn

• wdRow

• wdTable

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

  다음 예제에서 일곱 개의 문자로 구성된 범위를 정의합니다. 그런 다음 범위의 시작 위치를 원래 시작 위치에서 일곱 문자 뒤로 이동합니다. 범위의 끝 위치는 원래 시작 위치에서 일곱 문자 뒤에 있으므로 범위를 변경한 결과에는 문자가 포함되지 않습니다. 그런 다음 이 코드에서는 끝 위치를 현재 끝 위치에서 일곱 문자 뒤로 이동합니다.

범위를 확장하려면

1. 문자의 범위를 정의합니다. 자세한 내용은 방법: 프로그래밍 방식으로 문서의 범위 정의 및 선택을 참조하세요.

   다음 코드 예제는 문서 수준 사용자 지정에서 사용할 수 있습니다.

   C#

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

   VB

   Dim rng As Word.Range = Me.Range(Start:=0, End:=7)
   

   다음 코드 예제는 VSTO 추가 기능에서 사용할 수 있습니다. 이 예제에서는 활성 문서를 사용합니다.

   C#

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

   VB

   Dim rng As Word.Range = Me.Application.ActiveDocument.Range(Start:=0, End:=7)
   

2. MoveStart 개체의 Range 메서드를 사용하여 범위의 시작 위치를 옮깁니다.

   C#

   rng.MoveStart(Word.WdUnits.wdCharacter, 7);
   

   VB

   rng.MoveStart(Unit:=Word.WdUnits.wdCharacter, Count:=7)
   

3. MoveEnd 개체의 Range 메서드를 사용하여 범위의 끝 위치를 옮깁니다.

   C#

   rng.MoveEnd(Word.WdUnits.wdCharacter, 7);
   

   VB

   rng.MoveEnd(Unit:=Word.WdUnits.wdCharacter, Count:=7)
   

문서 수준 사용자 지정 코드

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

1. 다음 예제에서는 문서 수준 사용자 지정의 전체 코드를 보여 줍니다. 이 코드를 사용하려면 프로젝트의 ThisDocument 클래스에서 실행합니다.

   C#

   // Define a range of 7 characters.
   object start = 0;
   object end = 7;
   Word.Range rng = this.Range(ref start, ref end);
   
   // Move the start position 7 characters.
   rng.MoveStart(Word.WdUnits.wdCharacter, 7);
   
   // Move the end position 7 characters.
   rng.MoveEnd(Word.WdUnits.wdCharacter, 7);
   

   VB

   ' Define a range of 7 characters.
   Dim rng As Word.Range = Me.Range(Start:=0, End:=7)
   
   ' Move the start position 7 characters.
   rng.MoveStart(Unit:=Word.WdUnits.wdCharacter, Count:=7)
   
   ' Move the end position 7 characters.
   rng.MoveEnd(Unit:=Word.WdUnits.wdCharacter, Count:=7)
   

VSTO 추가 기능 코드

애플리케이션 수준 VSTO 추가 기능의 범위를 확장하려면

1. 다음 예제에서는 VSTO 추가 기능의 전체 코드를 보여 줍니다. 이 코드를 사용하려면 프로젝트의 ThisAddIn 클래스에서 실행합니다.

   C#

   // Define a range of 7 characters.
   Word.Range rng = this.Application.ActiveDocument.Range(0, 7);
   
   // Move the start position 7 characters.
   rng.MoveStart(Word.WdUnits.wdCharacter, 7);
   
   // Move the end position 7 characters.
   rng.MoveEnd(Word.WdUnits.wdCharacter, 7);
   

   VB

   ' Define a range of 7 characters.
   Dim rng As Word.Range = Me.Application.ActiveDocument.Range(Start:=0, End:=7)
   
   ' Move the start position 7 characters.
   rng.MoveStart(Unit:=Word.WdUnits.wdCharacter, Count:=7)
   
   ' Move the end position 7 characters.
   rng.MoveEnd(Unit:=Word.WdUnits.wdCharacter, Count:=7)
   

관련 콘텐츠

• 방법: 프로그래밍 방식으로 Word 문서의 범위 다시 설정
• 방법: 프로그래밍 방식으로 문서의 범위 또는 선택 영역 축소
• 방법: 프로그래밍 방식으로 문서의 범위 정의 및 선택
• 방법: 프로그래밍 방식으로 범위의 시작 및 끝 문자 검색