Command.Keytip 속성

컨트롤의 키 설명을 나타냅니다.

사용량

<Command.Keytip>
  child elements
</Command.Keytip>

특성

특성이 없습니다.

자식 요소

요소	Description
String	최대 한 번 발생할 수 있습니다.

부모 요소

요소
명령

설명

선택 사항입니다.

각 Command 요소에 대해 최대 한 번 발생할 수 있습니다.

Command.Keytip 에는 공백을 포함하여 유니코드 문자 시퀀스로 제한되는 xs:string 형식의 값이 포함될 수 있습니다.

Command.Keytip은 Tab 또는 빠른 실행 도구 모음 내의 컨트롤과 연결된 경우에만 숫자로 시작할 수 있습니다.

리본 메뉴의 현재 상태에 유효한 키 설명을 표시하려면 ALT 키를 길게 누릅니다. 다음 스크린샷은 Windows 7용 Microsoft 그림판 표시되는 초기 또는 첫 번째 수준 키 설명을 보여줍니다. 첫 번째 수준 키 설명을 선택한 후에는 두 번째 수준 키 설명만 표시됩니다.

Command.Keytip 은 해당 명령이 메뉴 항목을 통해 노출되지 않는 한 명령의 키보드 가속기 역할을 합니다. 이 경우 프레임워크는 Command.Keytip 값을 무시하고 대신 Command.LabelTitle 또는 UI_PKEY_Label 지정된 대로 앰퍼샌드 앞에 오는 문자를 사용합니다. Command.LabelTitle 또는 UI_PKEY_Label 앰퍼샌드를 지정하지 않으면 키 설명이나 키보드 가속기가 노출되지 않습니다.

Command.Keytip에 대한 값이 제공되지 않으면 String 자식 요소가 필요합니다.

참고

Command.Keytip에 값과 String 자식 요소가 모두 포함된 경우 String이 우선합니다.

기본적으로 다음 문자는 프레임워크에서 키 설명을 자동으로 생성하는 데 사용됩니다.

• F 는 애플리케이션 메뉴에 할당됩니다.
• Y 는 애플리케이션에서 지정한 키 설명이 없는 명령에 할당됩니다.
• Z 는 각 그룹 컨트롤에 할당되며 사용자 지정할 수 없습니다. 그룹 키 설명은 컨트롤의 ScalingPolicy 가 팝업 크기 옵션을 지정하는 경우에만 표시됩니다. 자세한 내용은 크기 정의 및 크기 조정 정책을 통해 리본 사용자 지정을 참조하세요.

참고

이러한 문자 중 어느 것도 프레임워크에서 예약하지 않습니다. 각각은 필요에 따라 하나 이상의 명령에 할당할 수 있습니다.

프레임워크는 다음과 같은 방법으로 키 설명 충돌을 해결합니다.

• 하나 이상의 Tab 컨트롤이 동일한 키 설명과 연결된 경우 각 키 설명에 1부터 시작하여 선언 순서로 각 컨트롤에 대해 순차적으로 증가하는 숫자(2, 3,...)가 추가됩니다. Tab 컨트롤에 문자 F가 키 설명으로 할당되면 애플리케이션 메뉴 에 설명된 대로 나머지 키 설명이 조정된 F1이 할당됩니다.
• Tab 내의 단일 컨트롤과 연결된 경우 키 설명 F는 컨트롤과 애플리케이션 메뉴 모두에 유효합니다. 기본 애플리케이션 메뉴 키 설명은 변경되지 않지만 활성 탭의 컨트롤에 우선 순위가 지정됩니다.
• Tab 내에서 하나 이상의 컨트롤이 동일한 키 설명과 연결된 경우 프레임워크는 앞에서 설명한 대로 해당 컨트롤의 키 설명을 자동으로 리팩터링합니다.

참고

텍스트 색의 약간의 변형은 표준 리본 구현에서 리팩터링된 키 설명을 강조 표시하는 데 사용됩니다. 리본 색을 사용자 지정한 표준이 아닌 리본 구현의 경우 이 프레임워크 동작이 재정의되고 모든 키 설명이 동일한 텍스트 색으로 표시됩니다. 자세한 내용은 리본 색 사용자 지정을 참조하세요.

최대 길이는 바인딩되지 않습니다.

예제

다음 예제에서는 Command.Keytip 선언을 사용하여 Command 요소에 대한 태그를 보여 줍니다.

<Command>
  <Command.Name>cmdSave</Command.Name>
  <Command.Symbol>ID_FILE_SAVE</Command.Symbol>
  <Command.Comment>Save</Command.Comment>
  <Command.Id>25003</Command.Id>
  <Command.LabelTitle>
    <String>
      <String.Content>Label for Save</String.Content>
      <String.Id>59999</String.Id>
      <String.Symbol>strSave</String.Symbol>
    </String>
  </Command.LabelTitle>
  <Command.TooltipTitle>Tooltip title with &amp;&amp; for Save Command</Command.TooltipTitle>
  <Command.TooltipDescription>Tooltip description for Save Command.</Command.TooltipDescription>
  <Command.Keytip>s1</Command.Keytip>
</Command>

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]

추가 정보

UI_PKEY_Keytip