다음을 통해 공유

Office 문서의 Windows Forms 컨트롤 개요

  • 아티클

Windows Forms 컨트롤은 사용자가 데이터를 입력하거나 조작하는 데 사용할 수 있는 개체입니다. Microsoft Office Excel 및 Microsoft Office Word의 문서 수준 프로젝트에서 디자인 타임에 프로젝트의 문서나 통합 문서에 Windows Forms 컨트롤을 추가하거나 런타임에 프로그래밍 방식으로 이러한 컨트롤을 추가할 수 있습니다. Excel 또는 Word용 VSTO 추가 기능에서 런타임에 열려 있는 문서나 워크시트에 이러한 컨트롤을 프로그래밍 방식으로 추가할 수 있습니다.

자세한 내용은 방법: Office 문서에 Windows Forms 컨트롤 추가를 참조하세요.

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

Windows Forms 컨트롤 사용

작업 창, 사용자 지정 작업창 및 Windows Forms 등의 사용자 지정 가능한 UI(사용자 인터페이스) 요소 및 문서에 Windows Forms 컨트롤을 추가할 수 있습니다. Windows Forms 컨트롤은 문서에서 일반적으로 다른 UI 요소와 동일한 동작을 수행하지만 몇 가지 차이점이 있습니다. 자세한 내용은 Office 문서에서 Windows Forms 컨트롤에 대한 제한 사항을 참조하세요.

Windows Forms 컨트롤을 문서에 추가할지 또는 기타 다른 UI 요소에 추가할지에 대한 결정은 여러 가지 요인에 따라 달라집니다. 솔루션의 UI를 디자인할 때는 다음 표에 설명된 Windows Forms 컨트롤의 용도를 고려해야 합니다.

문서에서

  • 항상 컨트롤을 표시하려는 경우

  • 사용자가 문서(예: 편집 화면이 잠긴 폼 기반 문서)에 직접 데이터를 입력하도록 하려는 경우

  • 컨트롤을 문서의 데이터에 맞춰 표시하려는 경우. 예를 들어 목록 개체의 각 행에 단추를 추가하는 경우 각 목록 항목에 맞추려고 할 수 있습니다.

작업 창 또는 사용자 지정 작업창에서

  • 사용자에게 상황에 맞는 정보를 제공하려는 경우

  • 문서에 쿼리 컨트롤 및 데이터를 제외한 결과만 표시하려는 경우

  • 컨트롤이 문서와 함께 인쇄되지 않도록 설정하려는 경우

  • 문서를 볼 때 컨트롤이 방해되지 않도록 설정하려는 경우

Windows Form에서

  • UI의 크기를 제어하려는 경우

  • 사용자가 컨트롤을 숨기거나 삭제하지 못하게 하려는 경우

  • 사용자의 입력을 허용하고 입력이 수신될 때까지 문서에서 작업을 수행할 수 없게 하려는 경우

프로그래밍 방식으로 Windows Forms 컨트롤 추가

런타임에 Windows Forms 컨트롤을 Word 문서와 Excel 워크시트에 추가할 수 있습니다. Visual Studio Tools for Office 런타임은 가장 일반적인 Windows Forms 컨트롤을 추가하기 위한 도우미 메서드를 제공합니다. 이러한 도우미 메서드를 사용하면 Office 문서에 신속하게 컨트롤을 추가하고 결합된 Windows Forms 컨트롤 기능과 이러한 컨트롤의 Office 관련 기능에 액세스할 수 있습니다.

자세한 내용은 런타임 시 Office 문서에 컨트롤 추가를 참조하세요.

문서 수준 프로젝트에서 Windows Forms 컨트롤 사용

문서에서의 Windows Forms 컨트롤 사용은 문서 수준 프로젝트마다 고유하므로 Visual Studio 디자이너를 사용하여 문서의 UI를 디자인할 수 있습니다.

사용자 지정 사용자 정의 컨트롤 만들기

프로젝트에 사용자 정의 컨트롤을 추가한 다음 도구 상자에 추가합니다. 그런 다음 Windows Forms 컨트롤을 문서에 추가할 때와 같은 방법으로 문서에 사용자 정의 컨트롤을 직접 끌어 놓을 수 있습니다. 다음은 사용자 정의 컨트롤을 만들 때 기억해야 할 몇 가지 사항들입니다.

  • sealed 사용자 정의 컨트롤을 만들지 마세요. 컨트롤을 문서로 끌어 오는 경우 Visual Studio에서는 사용자 정의 컨트롤에서 파생된 래퍼 클래스를 생성하여 확장하고 해당 문서에서 사용할 수 있도록 지원합니다. 사용자 정의 컨트롤이 sealed인 경우 Visual Studio에서 래퍼 클래스를 생성할 수 없습니다.

  • 사용자 정의 컨트롤에는 ComVisibleAttribute 로 설정된 T:System.Runtime.InteropServices.ComVisibleAttribute을 참조하세요. Office 프로젝트 내에서 만들어진 사용자 정의 컨트롤에서는 이 특성이 기본적으로 true 로 설정되지만 외부 프로젝트의 일부인 사용자 정의 컨트롤에서는 이 특성이 true로 설정되지 않을 수 있습니다.

  • 문서에 사용자 정의 컨트롤을 추가한 다음에는 프로젝트에서 UserControl 클래스의 이름을 변경하거나 삭제하지 마세요. 사용자 정의 컨트롤의 이름을 변경해야 하는 경우에는 먼저 문서에서 삭제하고 이름을 변경한 다음 다시 추가합니다.

디자인 타임에 컨트롤 정렬

디자인 타임에 여러 컨트롤을 Word 및 Excel 문서에 추가하는 경우 Visual Studio의 Microsoft Office Word 및 Microsoft Office Excel 도구 모음을 사용하여 선택된 모든 컨트롤의 맞춤을 신속하게 설정할 수 있습니다. 이러한 도구 모음은 문서 또는 워크시트가 디자이너에 열려 있는 경우에만 사용할 수 있습니다.

디자이너에서 여러 컨트롤을 선택할 때는 이러한 도구 모음에서 다음 단추를 사용하여 컨트롤을 정렬할 수 있습니다.

  • 왼쪽 맞춤

  • 가운데 맞춤

  • 오른쪽 맞춤

  • 위쪽 맞춤

  • 중간 맞춤

  • 아래쪽 맞춤

  • 가로 간격 같게

  • 세로 간격 같게

참고 항목

Word 프로젝트에서 이러한 단추는 선택된 컨트롤이 텍스트에 맞춰지지 않은 경우에만 활성화됩니다. 기본적으로 디자인 타임에 문서에 추가된 컨트롤은 텍스트와 맞춰집니다.

로드하는 동안 Excel 통합 문서에 이전 데이터가 표시되지 않도록 방지

디자인 타임에 Windows Forms 컨트롤을 문서 또는 워크시트에 추가하면 사용자가 문서를 닫아도 컨트롤이 문서에 유지됩니다. 디자인 타임에 추가된 컨트롤을 정적 컨트롤이라고 합니다.

정적 컨트롤이 포함된 Excel 통합 문서를 열면 사용자 지정 코드가 실행되고 실제 컨트롤이 로드될 때까지 통합 문서의 ActiveX 컨트롤에 컨트롤의 비트맵이 표시됩니다. 통합 문서를 저장할 때마다 Excel에서 이 비트맵을 만들고 통합 문서에 저장합니다. 비트맵은 컨트롤이 표시 중인 데이터를 포함하여 통합 문서가 마지막으로 저장될 때의 모양으로 컨트롤을 표시합니다. Windows Forms 컨트롤 및 비트맵을 포함하는 ActiveX 컨트롤에 대한 자세한 내용은 Office 문서에서 Windows Forms 컨트롤에 대한 제한 사항을 참조하세요.

사용자가 디자인 모드로 통합 문서를 여는 등 특정 조건에서는 코드가 로드되지 않으며 비트맵만 표시됩니다. 또한 사용자가 Visual Studio Tools for Office가 설치되지 않은 컴퓨터에서 통합 문서를 열면 사용자 지정을 실행할 수 없어 컨트롤이 로드되지 않으므로 컨트롤의 비트맵만 표시됩니다. 통합 문서를 저장하여 다른 사용자에게 보내기 전에는 항상 통합 문서의 컨트롤에서 개인 정보를 제거하여 개인 정보가 실수로 공개되는 일을 방지해야 합니다.

Excel 워크시트에서 셀 크기에 컨트롤 크기 맞춤

부모 셀의 크기가 변경될 때 자동으로 컨트롤의 크기가 조정되도록 설정할 수 있습니다. 자세한 내용은 방법: 워크시트 셀에서 컨트롤 크기 조정을 참조하세요.

모든 워크시트에서 공유되는 구성 요소 추가

DataSet등 모든 워크시트에서 공유하려는 구성 요소는 워크시트 대신 통합 문서 디자이너에 추가할 수 있습니다. 이러한 구성 요소는 구성 요소 트레이에 표시됩니다.

Excel 워크시트에서 컨트롤 포함 수식

Excel에서 컨트롤을 선택하는 경우 수식 입력줄 에 =EMBED("WinForms.Control.Host","")가 표시됩니다. 이 텍스트는 필요하며 삭제하면 안 됩니다.

Word 문서에서 컨트롤의 레이아웃 스타일

Visual Studio 디자이너를 사용하여 문서 수준 프로젝트에서 Word 문서에 컨트롤을 추가하면 컨트롤이 텍스트에 맞춰 추가됩니다. 컨트롤의 레이아웃 스타일을 변경하려면 컨트롤을 마우스 오른쪽 단추로 클릭하고 컨트롤 서식을 클릭합니다. 개체 서식 대화 상자의 레이아웃 페이지에서 배치 스타일을 선택합니다.

런타임에 Word 문서에 컨트롤을 추가할 때 ControlCollection 클래스의 다양한 Add<컨트롤 클래스> 메서드 오버로드를 사용하여 새 컨트롤의 레이아웃 스타일을 지정할 수 있습니다.

  • 컨트롤을 텍스트에 맞춰 추가하려면 컨트롤의 위치가 지정된 Range 를 사용하는 오버로드를 사용합니다.

  • 컨트롤을 부동 셰이프로 추가하려면 컨트롤의 왼쪽 및 위쪽 좌표를 사용하는 오버로드를 사용합니다.

    자세한 내용은 런타임 시 Office 문서에 컨트롤 추가를 참조하세요.

    Visual Studio 디자이너에서 Word 서식 파일을 여는 경우 기본 보기에서 열리므로 인라인이 아닌 컨트롤은 이 서식 파일에 표시되지 않을 수 있습니다. 컨트롤을 표시하려면 보기를 인쇄 레이아웃으로 변경합니다.

기본 문서 본문 외부 컨트롤

Windows Forms 컨트롤은 머리글 또는 바닥글 내부 또는 하위 문서 내에서 지원되지 않습니다.

디자인 타임에 구성 요소 추가

특정 컨트롤 또는 구성 요소는 문서에 표시되지 않고 구성 요소 트레이에 표시됩니다. Visual Studio는 각 문서 창에 대한 구성 요소 트레이를 제공합니다. 구성 요소 트레이는 해당 문서에 구성 요소가 있는 경우에만 화면에 나타납니다.

관련 콘텐츠