방법: 양식 창 사용

프로그래밍 방식으로 InfoPath 양식을 사용하는 경우 양식의 창에 액세스한 다음 포함된 항목 일부를 사용자 지정하는 코드를 작성할 수 있습니다. Microsoft.Office.InfoPath 네임스페이스에서 제공하는 InfoPath 개체 모델에서는 Window 클래스를 WindowCollection 클래스와 함께 사용하여 양식의 창에 액세스할 수 있습니다.

InfoPath에는 다음 두 가지 유형의 창이 있습니다.

• 사용자가 양식에 데이터를 입력할 때 사용되는 편집 창

• 사용자가 양식 서식 파일을 디자인할 때 사용되는 디자인 창

편집 창에서는 현재 창을 나타내는 Window 개체를 사용하여 사용자 필요에 따라 양식을 편집할 수 있는 다양한 속성과 메서드에 액세스할 수 있으므로 양식 서식 파일의 코드를 작성할 때 가장 유용하게 사용할 수 있습니다.

WindowsCollection 클래스 개요

WindowsCollection 클래스는 양식 서식 파일 개발자가 양식에 포함된 Window 개체를 관리하는 데 사용할 수 있는 다음 속성을 제공합니다.

이름	설명
Count 속성	컬렉션에 포함된 Window 개체의 수를 가져옵니다.
Item 속성	지정한 Window 개체에 대한 참조를 가져옵니다.

Window 클래스 개요

Window 클래스는 양식 개발자가 InfoPath 창과 상호 작용하는 데 사용할 수 있는 다음 메서드와 속성을 제공합니다. 이러한 메서드와 속성 지원은 사용 중인 창 유형(WindowType)에 따라 달라집니다. 일부 메서드와 속성은 편집기 창 유형(WindowType.Editor)에서만 작동합니다. 나머지 메서드와 속성은 편집기 창 유형과 디자이너 창 유형(WindowType.Designer) 모두에서 작동합니다. 또한 모든 InfoPath 개체 모델 구성원과 마찬가지로 양식 서식 파일에서 호출할 때 메서드 및 속성 지원은 보안 수준과 양식 배포 방법에 따라 달라질 수 있습니다.

이름	설명	창 유형 지원
Activate 메서드	창을 활성화하여 포커스를 해당 창으로 옮깁니다.	Designer 및 Editor 유형 모두
Active 속성	이 창이 현재 활성 창인지 여부를 나타내는 Boolean 값을 가져옵니다.	Designer 및 Editor 유형 모두
Caption 속성	Window 개체가 나타내는 창의 캡션 텍스트를 가져오거나 설정합니다.	Editor 유형만
Close 메서드	창을 닫습니다. 이때 저장하지 않은 양식이나 저장하지 않은 변경 내용이 있는 양식을 저장하라는 메시지가 표시됩니다.	Editor 유형만
Close 메서드	창을 닫습니다. 이때 저장하지 않은 양식이나 저장하지 않은 변경 내용이 있는 양식을 저장하지 않고 닫도록 선택할 수도 있습니다.	Editor 유형만
CommandBars 속성	창에 연결된 Microsoft Office CommandBars 컬렉션에 대한 참조를 가져옵니다.	Designer 및 Editor 유형 모두
Height 속성	포인트 단위로 측정된 창의 높이를 가져오거나 설정합니다.	Designer 및 Editor 유형 모두
Left 속성	포인트 단위로 측정된 창의 가로 위치를 가져오거나 설정합니다.	Designer 및 Editor 유형 모두
MailEnvelope 속성	MailEnvelope 클래스에 대한 참조를 가져옵니다.	Editor 유형만
TaskPanes 속성	TaskPaneCollection 컬렉션에 대한 참조를 가져옵니다.	Designer 및 Editor 유형 모두
Top 속성	포인트 단위로 측정된 창의 세로 위치를 가져오거나 설정합니다.	Designer 및 Editor 유형 모두
Width 속성	포인트 단위로 측정된 창의 너비를 가져오거나 설정합니다.	Designer 및 Editor 유형 모두
WindowState 속성	WindowState 값으로 창의 상태를 가져오거나 설정합니다.	Designer 및 Editor 유형 모두
WindowType 속성	WindowType 열거 값으로 창의 유형을 가져옵니다.	Designer 및 Editor 유형 모두
XmlForm 속성	창에 연결된 XmlForm 개체에 대한 참조를 반환합니다.	Editor 유형만

WindowsCollection 및 Window 클래스 사용

WindowsCollection 클래스는 Application 클래스의 Windows 속성을 통해 액세스할 수 있습니다. WindowsCollection 클래스를 사용하여 양식의 창에 액세스할 때는 인덱서를(Visual C#의 경우) 사용하거나 Item 속성에 정수(Long)를 전달(Visual Basic의 경우)하여 Window 개체 인스턴스에 대한 참조를 반환합니다. 예를 들어 다음 코드는 현재 InfoPath 세션의 WindowsCollection에 포함된 첫 번째 Window 개체에 대한 참조를 설정합니다.

Window myWindow = this.Application.Windows[0];

Dim myWindow As Window = Me.Application.Windows(0)

다음 코드 줄에 표시된 것처럼 WindowsCollection을 거치지 않고 Application 클래스의 ActiveWindow 속성을 사용하여 현재 열려 있는 창에 직접 액세스할 수 있습니다.

Window myWindow = this.Application.ActiveWindow;

Dim myWindow As Window = Me.Application.ActiveWindow

양식의 원본으로 사용하는 XML 문서 작업을 위해 사용 중인 현재 보기를 나타내는 View 클래스의 Window 속성을 사용하여 Window 개체에 액세스할 수도 있습니다. XmlForm 클래스의 CurrentView 속성은 현재 보기를 나타내는 View 개체에 액세스하는 데 사용됩니다. 예를 들어 다음 코드는 현재 보기에 연결된 Window에 대한 참조를 설정합니다.

Window myWindow = this.CurrentView.Window;

Dim myWindow As Window = Me.CurrentView.Window

참고:
Window 클래스의 몇몇 속성과 메서드는 편집 창 유형에서만 사용할 수 있으며, 디자인 창 유형에 사용할 경우 오류가 반환됩니다. 각 창에서 지원되는 속성과 메서드는 이 항목 앞부분의 표에 나와 있습니다. 사용 중인 창 유형은 코드에서 WindowType 속성을 사용하여 확인할 수 있습니다.