Описание команды


mhint

Отображение подсказок для пунктов меню.

mhint=File||Section

Параметры:

File||SectionФайл настроек.
  File - полный путь к файлу настроек.
  Section - имя секции.

Примечания:

Команда в фоне ожидает появления меню и при наведении курсора на пункт проверяет наличие подсказки из файла настроек.
Команда работает для всех меню имеющих класс #32768 и для утилиты BARMENUIMG.
Может быть запущена одна команда mhint, при повторном запуске команда закрывается.
Файл настроек может иметь любое имя с расширением ini в кодировке UTF-16 LE 1200.

Синтаксис секции файла настроек:

В секции прописывается обязательный ключ Delimeters, в котором указывается разделитель #!#
    (или любой другой, желательно набор уникальных символов)

Далее прописываются пункты: ~NameItemMenu#!#Hint#!#StyleHint#!#Title#!#Icon#!#Flag
   ~ - символ тильда первый символ строки.
   NameItemMenu - название пункта меню для которого будет создана подсказка:
        - прописывается оригинальное название пункта, включая знаки & (амперсанда), табуляции и горячих клавиш.
          (это важно, т.к. проверяется полное совпадение имени).
        - для пунктов меню рекомендуется создавать уникальные названия, которых нет в других меню.
        - для BARMENUIMG убираются знаки & (амперсанда) и табуляции.
        - для того, чтобы узнать оригинальное имя пункта меню можно воспользоваться командой wntxt
          (при наведении на меню в секции [Text] отображаются имена пунктов, которые можно записать в буфер обмена).
   Hint - подсказка, которая будет отображаться, если название пункта под курсором NameItemMenu совпадает.
        - может использоваться @CRLF, означающий перенос на новую строку.
   StyleHint - стиль подсказки (см. синтаксис стиля).
   Title - заголовок подсказки.
        - без заголовка последующие параметры отключаются.
   Icon - путь и через запятую номер значка.
        - если файл находится в папке с утилитой достаточно прописывать имя файла.
   Flag
        0 - устанавливается маленькая иконка 16x16 (по умолчанию).
        1 - устанавливается большая иконка 32x32.

В секции могут использоваться комментарии, которые игнорируются (строки начинаются с ";" точки с запятой)

Синтаксис стиля подсказки StyleHint:

Прописываются параметры:

    StyleW|DelayTime|Balloon|Flags|FontName|FontSize|FontWidth|FontStyle|FontColor|BkColor|Left|Top|Right|Bottom
       (1) StyleW - стиль подсказки.
          0 - стиль системы, игнорируются параметры Font..., BkColor, Left, Top, Right, Bottom.
          1 - свой стиль.
          2 - стиль системы №2, игнорируются ряд параметров.
          3 - стиль системы №3, игнорируются ряд параметров.
       (2) DelayTime - время в миллисекундах, в течение которого отображается подсказка.
       (3) Balloon - внешний вид.
           - для StyleW=0 (Может быть суммой флагов (3, 6, 7 ...))
              0 - прямоугольная.
              1 - с закруглёнными углами.
              2 - центрировать подсказку.
              4 - принудительно отображать подсказку полностью, независимо от указанных координат.
                (если используется несколько мониторов, подсказка будет "прилипать" к ближайшему монитору).
           - для StyleW больше нуля
              0 - прямоугольная.
              64 - с закруглёнными углами.
       (4) Flags - отображение подсказки.
            0 - обычное.
            4 - сдвигает подсказку влево.
       (5) FontName - имя шрифта.
       (6) FontSize - размер шрифта.
       (7) FontWidth - толщина шрифта: 400 - нормальный, 700 - жирный.
       (8) FontStyle - стиль шрифта.
            0 - обычный.
            1 - курсив.
       (9) FontColor - RGB цвет шрифта.
      (10) BkColor - RGB цвет фона подсказки.
      (11) Left - интервал между левой границей и левой части текста, в пикселях.
      (12) Top - интервал между верхней границей и верхней части текста, в пикселях.
      (13) Right - интервал между правой границей и правой части текста, в пикселях.
      (14) Bottom - интервал между нижней границей и нижней части текста, в пикселях.

Прописывается тег :STYLEN:
       Стиль для подсказки берётся из TCIMG.ini (TCIMGU.ini) из секции [Box] в ключах StyleToolTipN , в которых прописаны вышеописанные параметры, где:
       N - это приставка к ключам:
       если ключ StyleToolTip_Y1=... , то прописывается :STYLE_Y1:
       если ключ StyleToolTipXXX=... , то прописывается :STYLEXXX:

Пример записи:

[Section]
Delimeters=#!#
~Открыть &копию этой вкладки Ctrl+T#!#Однострочная подсказка#!#1|5000|0
~&Переименовать/Заблокировать вкладку#!#Многострочная подсказка@CRLF2-я строка@CRLF3-я строка#!#1|5000|0
~За&блокировать вкладку#!#Овальная подсказка#!#1|5000|64
~Заблокировать с возможностью с&мены каталога#!#Смещённая влево овальная подсказка#!#1|5000|64|4
~Открыть копию на &другой панели#!#Подсказка с установкой шрифта и его размера#!#1|5000|0|0|Tahoma|16
~Сохранить вкладки текущей панели в &файл#!#Подсказка с установкой шрифта@CRLF- название шрифта@CRLF- размер шрифта@CRLF- толщина шрифта@CRLF- стиль шрифта#!#1|5000|0|0|Segoe UI|10|700|1
~Сохранить вкладки &обеих панелей в файл#!#Подсказка с установкой шрифта@CRLF- название шрифта@CRLF- размер шрифта@CRLF- толщина шрифта@CRLF- стиль шрифта@CRLF- цвет шрифта@CRLF- фон подсказки#!#1|5000|0|0|Segoe UI|17|400|1|00008B|DCF8F8
; комментарии к подсказке....
~Добавить вкладки из файла, &сохранив текущие#!#Подсказка с заголовком#!#1|5000|0|0|Segoe UI|17|400|1|00008B|DCF8F8#!#Заголовок
~Добавить вкладки из файла, &удалив текущие#!#Подсказка с заголовком и значком#!#1|5000|0|0|Segoe UI|17|400|1|FFFFFF|395A00#!#Вкладки#!#%COMMANDER_PATH%\Wcmicons.dll,10
~&Закрыть вкладку Ctrl+W#!#Овальная подсказка с заголовком и с большим значком#!#1|5000|64|0|Segoe UI|17|400|1|FF0000|FFFF00#!#Вкладки#!#TCIMG.dll,5#!#1
~Закрыть &все вкладки Ctrl+Shift+W#!#Овальная подсказка с заголовком и с большим значком#!#1|5000|64|0|Segoe UI|17|400|1|FF0000|FFFF00|30|20|10|15#!#Отступы#!#TCIMG.dll,5#!#1
~Закрыть дуб&ликаты вкладок#!#Стиль подсказки берётся из секции [Box] @CRLFв ключе StyleToolTip1#!#:STYLE1:#!#Стиль#!#TCIMG.dll,2#!#1

Может выглядеть следующим образом:




См. также:

block, drive, eject, fontf, fontwd, langs, lnkey, monof, monrs, propes, rempty, runcm, scale, shutd, sound, taskb, trayk, trayx, winmn

Примеры:
 Как создать кнопку?

mhint=$f250\Files\Ini\Hint.ini||Hint ;; пример №1 вывода подсказок для меню вкладок в Total Commander

mhint=$f250\Files\Ini\Hint.ini||Hint2 ;; пример №2 вывода подсказок для меню вкладок в Total Commander


© Аверин Андрей для Total Commander Image  Averin-And@yandex.ru