다음을 통해 공유

도구 상자 아이콘

  • 아티클

[이 설명서는 미리 보기 전용이며, 이후 릴리스에서 변경될 수 있습니다. 비어 있는 항목은 자리 표시자로 포함됩니다.]

Visual Studio 및 Expression Blend에서 사용자 지정 WPF 및 Silverlight 컨트롤이 있는 도구 상자 아이콘을 포함할 수 있습니다. 이 항목에서는 도구 상자 아이콘의 이름을 지정하고 이를 포함 리소스로 포함하는 방법에 대해 설명합니다.

지원되는 파일 형식

다음 목록에서는 WPF Designer for Visual Studio의 도구 상자 아이콘에 지원되는 파일 형식을 보여 줍니다. 

  • BMP

  • GIF

  • JPG

  • JPEG

  • PNG

참고

Expression Blend에서는 .png 파일만 지원합니다.

명명 규칙

명명 규칙에 따라 도구 상자 아이콘을 사용자 지정 컨트롤에 연결합니다. 디자인 도구는 컨트롤 어셈블리의 포함 리소스에 적절하게 명명된 이미지 파일이 있는지 검사합니다.

가장 간단하게는 도구 상자 아이콘 이미지 파일을 컨트롤의 프로젝트에 포함 리소스로 추가하고 이름을 ControlName.Extension으로 지정한 다음 속성 창에서 해당 빌드 작업을 포함 리소스로 설정합니다. WPF Designer는 컨트롤의 형식 이름과 일치하는 파일 이름을 가진 리소스를 검색합니다. 자세한 내용은 연습: 컨트롤에 대한 사용자 지정 도구 상자 아이콘 만들기를 참조하십시오.

참고

이전 버전과의 호환성을 위해 Visual Studio 2010에서는 Visual Studio 2008에서 사용되는 명명 규칙을 지원합니다.자세한 내용은 Visual Studio 2008의 도구 상자 아이콘를 참조하십시오.

Visual Studio 2010에서는 도구 상자 아이콘에 대해 다음과 같은 명명 규칙을 지원합니다. 대괄호([])에 있는 부분 문자열은 선택적입니다.

[AnyString]Namespace.ControlName[.Product][.AnyString].Extension

디자이너에서 도구 상자 아이콘을 검색할 때 Namespace, ControlName 및 Product 부분 문자열이 일치하는 항목을 검색합니다. Namespace 및 ControlName이 사용자 지정 컨트롤과 일치하지 않으면 아이콘이 도구 상자에 표시되지 않습니다.

디자이너에서 Product 부분 문자열을 사용하여 다른 제품의 아이콘을 필터링할 수도 있습니다. 예를 들어 Visual Studio에서는 Product가 "VisualStudio"로 설정된 아이콘을 선호합니다.

다음 목록에서는 Visual Studio 및 Expression Blend 아이콘에 사용할 수 있는 도구 상자 아이콘 명명 규칙의 예를 보여 줍니다.

  • Namespace.ControlName.VisualStudio.Extension

  • Namespace.ControlName.VisualStudio.AnyString.Extension

  • Namespace.ControlName.Expression.png

  • Namespace.ControlName.Expression.AnyString.png

앞의 이름과 일치하는 아이콘이 없으면 다음 이름이 검색됩니다.

  • Namespace.ControlName.Extension

  • Namespace.ControlName.AnyString.Extension

다음 목록에서는 TailspinToysControlLibrary 네임스페이스의 TailspinToysControl이라는 컨트롤에 대한 도구 상자 아이콘 이름의 예를 보여 줍니다. 이미지 형식에 대한 선택적 정보가 추가되지만 디자이너에서 사용하지는 않습니다.

  • TailspinToysControlLibrary.TailspinToysControl.VisualStudio.24bit.48x48.bmp

  • TailspinToysControlLibrary.TailspinToysControl.Expression.4bit.16x16.png

디자이너에서 도구 상자 아이콘을 찾으면 디자이너의 대상 아이콘 크기와 가장 일치하는 아이콘이 로드되어 표시됩니다. 다음 목록은 일치 기준이 적용되는 순서를 보여 줍니다.

  1. 이름에 디자이너가 지정되지 않은 아이콘보다 디자이너가 지정된 아이콘을 먼저 선택합니다. 예를 들어 WPF Designer에서는 이름에 "Expression"이 있는 아이콘보다 "VisualStudio"가 있는 아이콘을 선호합니다.

  2. 렌더링 크기에 가장 가까운 아이콘을 선택합니다. Visual Studio 도구 상자에 16x16픽셀에 가장 가까운 아이콘이 로드된 다음 24비트 색 농도로 매핑됩니다.

  3. 첫 번째로 찾은 아이콘을 선택합니다.

기본 도구 상자 아이콘 재정의

WPF Designer 확장성 프레임워크를 사용하여 컨트롤의 런타임 어셈블리에 포함된 도구 상자 아이콘을 재정의할 수 있습니다. 자세한 내용은 연습: 도구 상자 아이콘에 대한 메타데이터 제공을 참조하십시오.

참고 항목

작업

연습: 도구 상자 아이콘에 대한 메타데이터 제공

개념

Visual Studio 2008의 도구 상자 아이콘