VisibilityItem 요소

  • 아티클

VisibilityItem 요소는 명령 및 도구 모음의 정적 표시 여부를 결정합니다. 모든 항목은 명령 또는 메뉴, 연관된 명령 UI 컨텍스트를 식별합니다. Visual Studio는 명령, 메뉴 및 도구 모음과 해당 표시 여부를 정의하는 VSPackage를 로드하지 않고 검색합니다. IDE는 IsCmdUIContextActive 메서드를 사용하여 명령 UI 컨텍스트가 활성 상태인지 확인합니다.

VSPackage가 로드된 후 Visual Studio는 명령 표시 여부가 VisibilityItem이 아닌 VSPackage에 의해 결정되어야 합니다. 명령의 표시 여부를 확인하려면 명령을 구현한 방법에 따라 BeforeQueryStatus 이벤트 처리기 또는 QueryStatus 메서드 중 하나를 구현하면 됩니다.

VisibilityItem 요소가 있는 명령 또는 메뉴는 연결된 컨텍스트가 활성화된 경우에만 나타납니다. 각 명령 컨텍스트 조합에 대한 항목을 포함하여 단일 명령, 메뉴 또는 도구 모음을 하나 이상의 명령 UI 컨텍스트와 연결할 수 있습니다. 명령 또는 메뉴가 여러 명령 UI 컨텍스트와 연결된 경우 연결된 명령 UI 컨텍스트 중 하나가 활성화되면 명령 또는 메뉴가 표시됩니다.

VisibilityItem 요소는 명령, 메뉴 및 도구 모음에만 적용되며 그룹에는 적용되지 않습니다. 관련 VisibilityItem 요소가 없는 요소는 상위 메뉴가 활성 상태일 때마다 표시됩니다.

구문

<VisibilityItem
  guid="cmdGuidMyProductCommands"
  id="cmdidAddWidget"
  context="guidNotViewSourceMode"/>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성 설명
guid 필수입니다. GUID/ID 명령 식별자의 GUID입니다.
id 필수입니다. GUID/ID 명령 식별자의 ID입니다.
context 필수입니다. 명령이 표시되는 UI 컨텍스트입니다.
조건 선택 사항. 조건부 특성을 참조하세요.

자식 요소

없음

부모 요소

요소 설명
VisibilityConstraints 요소 VisibilityConstraints 요소는 명령 및 도구 모음 그룹의 정적 표시 여부를 결정합니다.

설명

표준 Visual Studio UI 컨텍스트는 Visual Studio SDK 설치 경로\VisualStudioIntegration\Common\Inc\vsshlids.h 파일과 UIContextGuids 및 UIContextGuids80 클래스에 정의되어 있습니다. 더욱 완전한 UI 컨텍스트 집합이 VSConstants 클래스에 정의되어 있습니다.

예시

<VisibilityConstraints>
  <VisibilityItem guid="cmdSetGuidMyProductCommands"     id="cmdidAddWidget"
    context="guidNotViewSourceMode"/>
</VisibilityConstraints>

참고 항목