Visual Studio 2008의 도구 상자 아이콘

아티클
08/10/2011

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

참고

이 항목은 Visual Studio 2008과의 이전 버전 호환성을 위해 유지됩니다. Visual Studio 2010의 경우 도구 상자 아이콘를 참조하십시오.

지원되는 파일 형식

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

XAML
BMP
GIF
JPG
JPEG
PNG

명명 규칙

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

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

참고

WPF Designer는 일치 알고리즘을 사용하여 도구 상자 아이콘에 가장 적합한 리소스를 찾습니다. 리소스 파일이 올바른 XAML 또는 올바른 이미지 파일이 아닌 경우 올바른 파일을 찾을 때까지 다음 일치 항목이 검색됩니다. XAML 이미지는 비시스템 형식에 대한 참조를 포함할 수 없습니다.

완전히 일치하는 이름

도구 상자 아이콘 명명 규칙에서는 완전히 일치하는 리소스 이름이 지원됩니다. 완전히 일치하는 이름의 경우 Namespace.ControlName.Icon.Extension 규칙을 사용하여 도구 상자 아이콘 이름에 네임스페이스를 포함합니다. 예를 들어 이름이 ProseControl이고 Proseware.Core.Controls 네임스페이스에 정의된 컨트롤의 경우 완전히 일치하는 PNG 도구 상자 아이콘의 이름은 Proseware.Core.Controls.ProseControl.Icon.png로 지정됩니다.

리소스의 경우 Visual Studio에서는 자동으로 폴더가 네임스페이스로 변환됩니다. 따라서 프로젝트에 네임스페이스와 동일한 폴더 구조를 만들 수 있습니다. 폴더는 포함 리소스가 검색되는 네임스페이스에 영향을 줍니다. 앞의 예에서 이미지 파일이 Icons라는 이름의 하위 폴더에 있으면 WPF Designer는 Proseware.Core.Controls.Icons.ProseControl.Icon.png라는 이름의 도구 상자 아이콘을 찾습니다.

이미지가 컨트롤과 동일한 네임스페이스에 없는 경우 WPF Designer는 비슷하게 일치하는 항목을 검색합니다.

비슷하게 일치하는 이름

완전히 일치하는 리소스가 없으면 WPF Designer는 어셈블리의 포함 리소스에서 비슷하게 일치하는 리소스를 찾습니다. 앞의 예제에서 WPF Designer는 먼저 이름이 완전히 일치하는 Proseware.Core.Controls.ProseControl.Icon.Extension 파일을 검색합니다. 이 검색이 실패하면 WPF Designer는 네임스페이스를 무시하고 형식 이름만을 사용하여 이름을 찾습니다. 이 예제에서 WPF Designer는 리소스에서 이름이 ProseControl.Icon.Extension인 모든 파일을 찾습니다. 이 검색이 실패하면 WPF Designer는 기본 네임스페이스에서 검색을 시작합니다. 이 예제에서 WPF Designer는 이름이 Proseware.ProseControl.Icon.Extension인 파일을 찾습니다.

여러 이미지 크기

도구 상자 아이콘 이미지 파일 이름에는 선택적으로 "Icon" 필드가 포함될 수 있습니다. 이 하위 문자열을 사용하여 아이콘의 여러 이미지 크기를 지정할 수 있습니다.

앞 예제의 ProseControl 컨트롤의 경우 WPF Designer는 리소스에서 다음 이미지를 찾은 다음 크기가 가장 일치하는 항목을 선택합니다.

Proseware.Core.Controls.ProseControl.Icon.Large.png
Proseware.Core.Controls.ProseControl.Icon.Medium.png
Proseware.Core.Controls.ProseControl.Icon.ReallyLarge.png

"Icon" 뒤의 마침표를 생략하여 다음과 같이 파일 이름을 지정할 수도 있습니다.

Proseware.Core.Controls.ProseControl.IconLarge.png
Proseware.Core.Controls.ProseControl.IconMedium.png
Proseware.Core.Controls.ProseControl.IconReallyLarge.png

WPF Designer는 다음 규칙을 사용하여 도구 상자 아이콘을 선택합니다.

벡터 XAML
두 차원 모두에서 크기가 정확히 일치하는 항목
크기 및 가로 세로 비율을 기준으로 가장 가깝게 일치하는 항목

비트맵 기반 파일 형식에 권장되는 이미지 크기는 64픽셀 x 64픽셀입니다.

WPF Designer와 Expression Blend는 도구 상자 아이콘에 대해 서로 다른 이미지 크기를 사용합니다. Expression Blend는 큰 아이콘 크기로 24x24를 사용하고 작은 크기로 12x12를 사용합니다. WPF Designer는 16x16을 사용합니다.

호스트에 필요한 크기가 64x64 픽셀이면 Proseware.Core.Controls.ProseControl.Icon.Large.png가 크기 및 가로 세로 비율을 기준으로 가장 적합하게 일치하는 항목이므로 이 파일이 사용됩니다. 어셈블리의 모든 이미지가 검사됩니다. 크기 및 가로 세로 비율이 같은 이미지가 두 개 있는 경우 사용할 이미지는 호스트에 의해 결정됩니다.