Свойство Command.Keytip

Представляет подсказку клавиши для элемента управления.

Использование

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

Атрибуты

Атрибуты отсутствуют.

Дочерние элементы

Элемент	Описание
Строка	Может возникать не более одного раза

Родительские элементы

Элемент
Команды

Комментарии

Необязательный элемент.

Может выполняться не более одного раза для каждого элемента Command .

Command.Keytip может содержать значение типа xs:string , ограниченное любой последовательностью символов Юникода, включая пробелы.

Подсказка command.Keytip может начинаться с числа, только если она связана с элементом управления на вкладке или панели быстрого доступа.

Чтобы отобразить подсказки клавиш, допустимые для текущего состояния ленты, нажмите и удерживайте клавишу ALT. На следующем снимке экрана показаны подсказки клавиш начального или первого уровня, отображаемые в Microsoft Paint для Windows 7. После выбора подсказки клавиш первого уровня отображаются только подсказки клавиш второго уровня.

Command.Keytip выступает в качестве ускорителя клавиатуры для команды, если только эта команда не предоставляется через пункт меню. В этом случае платформа игнорирует значение Command.Keytip и вместо этого использует символ, предшествующий амперсанду, как указано в Command.LabelTitle или UI_PKEY_Label. Если командлет Command.LabelTitle или UI_PKEY_Label не указан амперсанд, подсказка клавиш или ускоритель клавиатуры не предоставляются.

Если значение для Command.Keytip не указано, дочерний элемент String является обязательным.

Примечание

Если Command.Keytip содержит как значение, так и дочерний элемент String , приоритет имеет String .

По умолчанию для автоматического создания подсказок ключей платформа использует следующие буквы:

• F назначается меню приложения.
• Y назначается любой команде, у которой нет подсказки клавиши, заданной приложением.
• Z назначается каждому элементу управления Group и не может быть настроен. Подсказка клавиши Group отображается только в том случае, если параметр ScalingPolicy для элемента управления задает параметр Размер всплывающего окна . Дополнительные сведения см. в статье Настройка ленты с помощью определений размеров и политик масштабирования.

Примечание

Ни одна из этих букв не зарезервирована платформой. Каждая из них может быть назначена одной или нескольким командам по мере необходимости.

Платформа разрешает конфликты подсказки клавиш следующими способами.

• Если один или несколько элементов управления TAB связаны с одной и той же подсказкой клавиши, число добавляется к каждой подсказке, начиная с 1, и последовательно увеличивается (2, 3,...) для каждого элемента управления в порядке объявления. Если каким-либо элементам управления TAB назначается буква F в качестве подсказки клавиши, меню приложения назначается F1, а остальные подсказки клавиш настраиваются, как описано.
• При связывании с одним элементом управления на вкладке подсказка клавиши F является допустимой как для элемента управления, так и для меню приложения. Подсказка клавиш меню приложения по умолчанию не изменяется, но приоритет отдается элементу управления на активной вкладке.
• Если один или несколько элементов управления на вкладке связаны с одной и той же подсказкой, платформа автоматически выполняет рефакторинг подсказок этих элементов управления, как описано выше.

Примечание

Небольшое изменение цвета текста используется для выделения рефакторинговых подсказок ключей в стандартной реализации ленты. Для нестандартной реализации ленты, в которой был настроен цвет ленты, это поведение платформы переопределяется, а все подсказки клавиш отображаются одним и тем же цветом текста. Дополнительные сведения см. в разделе Настройка цветов ленты.

Максимальная длина не связана.

Примеры

В следующем примере демонстрируется разметка для элемента Command с объявлением Command.Keytip .

<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