ProvideToolboxItemsAttribute 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
VSPackage를 구현하는 클래스에 이 특성을 적용하여 Visual Studio 도구 상자에 항목 집합을 제공하는 경우 선언합니다.
public ref class ProvideToolboxItemsAttribute : Microsoft::VisualStudio::Shell::RegistrationAttribute[System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)]
public class ProvideToolboxItemsAttribute : Microsoft.VisualStudio.Shell.RegistrationAttribute[<System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)>]
type ProvideToolboxItemsAttribute = class
inherit RegistrationAttributePublic Class ProvideToolboxItemsAttribute
Inherits RegistrationAttribute- 상속
- 특성
예제
아래 예제에서 클래스 MyPackage 에 적용된 특성은 "CF_XMLCODE" 및 "InPlaceMenuEditorMenu" 두 개의 클립보드 형식으로 의 Toolbox 항목 버전 1을 지원함을 나타냅니다.
[DefaultRegistryRoot("Software\\Microsoft\\VisualStudio\\8.0")]
[ProvideToolboxItems(true, 1)]
[ProvideToolboxFormat("CF_XMLCODE")]
[ProvideToolboxFormat("InPlaceMenuEditorMenu")]
[Guid("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")]
internal sealed class MyPackage : Package
설명
특성 컨텍스트
| 적용 대상 | 를 Package구현IVsPackage하여 VSPackage를 제공하는 클래스입니다. |
| 반복 가능 | No |
| 필수 특성 | ProvideToolboxFormatAttribute |
| 잘못된 특성 | 없음 |
사용자가 클래스에서 Package제공하는 이 형식의 데이터 개체를 도구 상자로 끌어다 놓을 수 있도록 지원하는 데 필요한 를 구현 IVsPackage 하는 클래스 또는 파생 클래스에 이 특성을 적용합니다. 이 구현 클래스는 삭제 알림 자체를 처리해야 합니다.
이 특성은 등록 목적으로만 사용되며 런타임 시 코드가 작동하는 방식에는 영향을 주지 않습니다.
해당 생성자에 지정된 인수에 따라 이 특성은 VSPackage가 도구 상자 항목을 제공하지 않음을 나타낼 수 있습니다. 특성 ProvideToolboxFormatAttribute 이 도구 상자 항목을 제공함을 나타내기 위해 클래스에 추가되는 경우 하나 이상의 인스턴스 ProvideToolboxFormatAttribute 도 추가해야 합니다.
이 특성은 를 사용하여 ProvideToolboxFormatAttribute 지정된 형식의 도구 상자 항목을 제공하는 것으로 VSPackage를 등록합니다.
이 특성이 도구 상자 항목이 제공되도록 지정하는 경우 VSPackage는 및 ToolboxUpgraded 이벤트를 처리 ToolboxInitialized 해야 합니다.
이 특성을 사용하는 모든 VSPackage는 및 ToolboxUpgraded 이벤트에 대한 ToolboxInitialized 처리기를 제공해야 합니다.
생성자
| ProvideToolboxItemsAttribute(Int32) |
VSPackage를 구현하는 클래스가 도구 상자 항목을 제공하는지 나타내는 새 instance ProvideToolboxItemsAttribute 만듭니다. |
| ProvideToolboxItemsAttribute(Int32, Boolean) |
지정된 버전에 대한 의 ProvideToolboxItemsAttribute 새 instance 초기화합니다. |
속성
| NeedsCallBackAfterReset |
이를 true로 설정하면 각 도구 상자가 다시 설정된 후 ToolboxInitialized 이벤트가 강제로 발생합니다. 이 기능은 패키지를 개발할 때 도구 상자가 매번 패키지에 항목 목록을 요청하도록 강제하는 데 사용할 수 있습니다(변경된 경우). 배송된 제품의 경우 캐시를 더 나은 성능에 사용할 수 있도록 false로 두는 것이 가장 좋습니다. 일부 시나리오(예: 캐시에 유지할 수 없는 항목 목록) 이 플래그를 true로 설정해야 할 수 있습니다. |
| TypeId |
RegistrationAttribute 파생 클래스가 System.ComponentModel.TypeDescriptor.GetAttributes(...)에서 작동하도록 하려면 TypeID 속성을 재정의합니다. 이 속성에서 파생된 특성은 클래스에 적용할 수 있는 인스턴스에 대한 더 나은 제어가 필요한 경우에만 이 속성을 재정의해야 합니다. (다음에서 상속됨 RegistrationAttribute) |
| Version |
VSPackage에서 제공하는 도구 상자 항목의 버전을 반환하는 속성입니다. |
메서드
| GetPackageRegKeyPath(Guid) |
VSPackage의 레지스트리 경로(애플리케이션의 레지스트리 루트를 기준으로)를 가져옵니다. (다음에서 상속됨 RegistrationAttribute) |
| Register(RegistrationAttribute+RegistrationContext) |
VSPackage를 regpkg.exe 같은 외부 등록 도구에서 호출할 때 지정된 형식에 대한 도구 상자 항목 공급자로 등록합니다. 자세한 내용은 VSPackage 등록을 참조하세요. |
| Unregister(RegistrationAttribute+RegistrationContext) |
메서드가 레지스트리에 Register(RegistrationAttribute+RegistrationContext) 적용한 변경 내용을 반대로 바꿉니다. |