[C#] WinForm 도구 상자에 컨트롤이 추가되지 않는 경우 해결 방법

도구 상자에 컨트롤이 추가되지 않는 문제

C# WinForm에서 기본으로 제공되는 컨트롤 외에, 내가 필요로 하는 기능의 컨트롤이 없는 경우에는 사용자 컨트롤(Custom control)로 직접 만들어야 합니다. 또는 NuGet이나 누군가 만든 컨트롤 dll을 사용해도 됩니다.

그런데 이렇게 외부 컨트롤을 폼(Form) 디자이너에서 사용하려면 도구 상자(Tool box)에 추가되어야 하는데요. 하필이면 Visual Studio 버그인지 모르겠으나, 도구 상자에 컨트롤을 추가하다가 Visual Studio가 종료되는 버그가 발생할 수도 있습니다.

[Visual Studio] VS2015 도구 상자(ToolBox) 종료 현상 해결 방법

[Visual Studio] VS2015 도구 상자(ToolBox) 종료 현상 해결 방법

그런데 문제는 위 링크의 조치 사항을 적용해도 여전히 Visual Studio 버전에 상관없이 종료되는 경우가 있습니다. 참 골치 아픈 문제인데요.

본문에서는 도구 상자에 컨트롤을 추가하지 않고, 직접 코드 편집으로 컨트롤을 추가하여 사용하는 방법을 알려드립니다.

도구 상자 없이 컨트롤 추가하기

우선 추가하고자 하는 컨트롤의 dll을 참조로 추가합니다. 저는 예시로 ImageGlass.ImageBox dll을 사용했습니다.

참조 dll 추가하기

그리고 버튼(Button)과 같은 아무 컨트롤이나 추가합니다. 

Button 컨트롤이 추가된 모습

이제 Form의 디자이너인 Form1.Designer.cs 파일을 더블 클릭합니다.

Form1.Designer.cs 파일을 연 모습

기존 코드에서 Button과 관련된 모든 코드를 사용하고자 하는 컨트롤로 변경합니다. 저는 ImageGlass의 ImageBox로 모두 교체했습니다. 컨트롤에서 지원되지 않는 속성은 지우셔도 상관없습니다.

새로운 컨트롤 이름으로 모두 변경한 모습

이제 Form1.cs를 더블 클릭해서 디자이너를 보겠습니다. 처음에 있던 버튼은 사라지고 교체한 컨트롤이 존재합니다.

새로 추가한 컨트롤로 교체된 모습

참고로, 빌드 플랫폼이 x64인 경우에는 빌드에는 문제가 없지만 디자이너를 열면 아래와 같은 에러가 발생합니다.

x64 디자이너 오류

정확한 이유는 모르겠습니다만, 64bit에서 생성된 컨트롤은 빌드 플랫폼이 x64일 때 디자이너에서 오류가 발생합니다. 그래서 AnyCPU나 x86으로 빌드하면 디자이너가 정상적으로 열립니다. 만약, x64용 dll만 있다면 빌드는 되지만 디자이너가 열리지 않아 난감한 상황에 직면하긴 합니다.

아무튼, 컨트롤이 도구 상자에 정상적으로 추가되지 않는다면 본문과 같이 디자이너 코드 편집으로 직접 추가하는 방법이 있다는 것을 알고 계시면 꽤 유용합니다.