방법: InfoPath 2003 개체 모델을 사용하여 양식 창 작업
프로그래밍 방식으로 InfoPath 양식을 사용하는 경우 양식의 창에 액세스한 다음 포함된 항목 일부를 사용자 지정하는 코드를 작성할 수 있습니다. InfoPath 2003 호환 개체 모델에서는 WindowObject 인터페이스를 WindowsCollection 인터페이스와 함께 사용하여 양식의 창에 액세스할 수 있습니다.
InfoPath에는 다음 두 가지 유형의 창이 있습니다.
사용자가 양식에 데이터를 입력할 때 사용되는 편집 창
사용자가 양식 서식 파일을 디자인할 때 사용되는 디자인 창
양식 서식 파일의 코드를 작성할 때 가장 유용한 기능을 제공하는 것은 편집 창입니다. 이는 편집 창을 참조하는 WindowObject 인스턴스를 사용하여 양식 편집 경험을 사용자 지정하는 데 사용할 수 있는 다양한 속성과 메서드에 액세스하기 때문입니다.
WindowsCollection 인터페이스 개요
WindowsCollection 인터페이스는 양식 서식 파일 개발자가 양식 서식 파일에 포함된 WindowObject 인터페이스를 관리하는 데 사용할 수 있는 다음 속성을 제공합니다.
이름 |
설명 |
|---|---|
Count 속성 |
컬렉션에 포함된 Window 개체의 수를 반환합니다. |
Item 속성 |
지정한 Window 개체에 대한 참조를 반환합니다. .gif "참고 사항") 참고 사항
Visual C#는 Item 속성을 호출하지 않고 인덱서를 사용하여 컬렉션에 액세스합니다. 예를 들면 thisApplication.Windows[0].Caption과 같습니다.
|
Window 개체 개요
WindowObject 인터페이스는 양식 개발자가 InfoPath 창과 상호 작용하는 데 사용할 수 있는 다음 메서드와 속성을 제공합니다. 이러한 메서드와 속성 지원은 사용 중인 창 유형(XdWindowType)에 따라 달라집니다. 일부 메서드와 속성은 편집기 창 유형(XdWindowType.xdEditorWindow)에서만 작동합니다. 나머지 메서드와 속성은 편집기 창 유형과 디자이너 창 유형(XdWindowType.xdDesignerWindow) 모두에서 작동합니다. 또한 모든 InfoPath 개체 모델 멤버와 마찬가지로 양식 서식 파일에서 호출할 때 메서드 및 속성 지원은 보안 수준과 양식 배포 방법에 따라 달라질 수 있습니다.
이름 |
설명 |
창 유형 지원 |
|---|---|---|
Activate 메서드 |
이 창을 현재 활성 창으로 지정합니다. |
xdDesignWindow 및 xdEditorWindow 유형 모두 |
Active 속성 |
이 창이 현재 활성 창인지 여부를 나타내는 Boolean 값을 반환합니다. |
xdDesignWindow 및 xdEditorWindow 유형 모두 |
Caption 속성 |
Window 개체로 나타내는 창의 캡션 텍스트를 반환하거나 설정하는 읽기/쓰기 속성입니다. |
xdEditorWindow 유형만 |
Close 메서드 |
창을 닫습니다. |
xdEditorWindow 유형만 |
CommandBars 속성 |
Microsoft Office CommandBars 개체에 대한 참조를 반환합니다. |
xdDesignWindow 및 xdEditorWindow 유형 모두 |
Height 속성 |
Window 개체가 표시하는 창의 높이를 포인트 단위로 측정하여 지정하는 정수(Long) 형식의 읽기/쓰기 속성입니다. |
xdDesignWindow 및 xdEditorWindow 유형 모두 |
Left 속성 |
Window 개체가 표시하는 창의 가로 위치를 포인트 단위로 측정하여 지정하는 정수(Long) 형식의 읽기/쓰기 속성입니다. |
xdDesignWindow 및 xdEditorWindow 유형 모두 |
MailEnvelope 속성 |
MailEnvelopeObject 개체에 대한 참조를 반환합니다. |
xdEditorWindow 유형만 |
TaskPanes 속성 |
TaskPanesCollection 컬렉션에 대한 참조를 반환합니다. |
xdDesignWindow 및 xdEditorWindow 유형 모두 |
Top 속성 |
Window 개체가 표시하는 창의 세로 위치를 포인트 단위로 측정하여 지정하는 정수(Long) 형식의 읽기/쓰기 속성입니다. |
xdDesignWindow 및 xdEditorWindow 유형 모두 |
WindowType 속성 |
XdWindowType 열거에 따라 창의 유형을 나타내는 숫자를 반환합니다. |
xdDesignWindow 및 xdEditorWindow 유형 모두 |
Width 속성 |
Window 개체가 표시하는 창의 너비를 포인트 단위로 측정하여 지정하는 정수(Long) 형식의 읽기/쓰기 속성입니다. |
xdDesignWindow 및 xdEditorWindow 유형 모두 |
WindowState 속성 |
Window 개체가 나타내는 창의 상태를 반환하거나 설정하는 XdWindowState 형식의 읽기/쓰기 속성입니다. |
xdDesignWindow 및 xdEditorWindow 유형 모두 |
XDocument 속성 |
창에 연결된 _XDocument 개체에 대한 참조를 반환합니다. |
xdEditorWindow 유형만 |
WindowsCollection 및 Window 인터페이스 사용
WindowsCollection 인터페이스는 Application 인터페이스의 Windows 속성을 통해 액세스할 수 있습니다. WindowsCollection 인터페이스를 사용하여 양식의 창에 액세스하는 경우 인덱서를 사용하거나(Visual C#의 경우) Item 속성에 정수(Long)를 전달하여(Visual Basic의 경우) WindowObject 인터페이스 인스턴스에 대한 참조를 반환합니다. 예를 들어 다음 코드는 WindowsCollection에 포함된 첫 번째 WindowObject에 대한 참조를 설정합니다.
WindowObject objWindow = thisApplication.Windows[0];
Dim objWindow As WindowObject = thisApplication.Windows(0)
그러나 다음 코드와 같이 WindowsCollection을 거치지 않고도 Application 인터페이스의 ActiveWindow 속성을 사용하여 현재 열려 있는 창에 직접 액세스할 수 있습니다.
WindowObject objWindow = thisApplication.ActiveWindow;
Dim objWindow As WindowObject = thisApplication.ActiveWindow
| 참고 사항 |
|---|
InfoPath 관리 코드 프로젝트를 디버깅하는 경우 디버깅 창이 활성화되어 있으므로 ActiveWindow 속성이 항상 null을 반환합니다. |
양식의 원본으로 사용하는 XML 문서에 연결된 View 인터페이스의 Window 속성을 사용하여 WindowObject에 액세스할 수도 있습니다. XDocument 인터페이스의 View 속성은 View 개체에 액세스하는 데 사용됩니다. 예를 들어 다음 코드에서는 양식의 원본으로 사용하는 XML 문서의 보기에 연결된 WindowObject에 대한 참조를 설정합니다.
WindowObject objWindow = thisXDocument.View.Window;
Dim objWindow As WindowObject = thisXDocument.View.Window
| 참고 사항 |
|---|
Window 개체의 몇몇 속성과 메서드는 편집 창 유형 전용입니다. 디자인 창 유형에 사용할 경우 오류가 반환됩니다. 각 창 유형에 대해 지원되는 속성과 메서드는 이 항목 앞부분의 표에 나와 있습니다. 사용 중인 창 유형은 코드에서 WindowType 속성을 사용하여 확인할 수 있습니다. |