3 декабря 2010 г.

Delphi, HelpInsight, Documentation Insight и... QIP!

Презабавная вещь тут случилась.

Недавно я рассказывал про замечательный инструмент Documentation Insight. За прошедшее время он вышел из беты на финальную версию и продаётся по цене в $99 (спец-предложение: до 10-го декабря вы можете купить Documentation Insight всего за половину стоимости! Спешите! Поддерживаются WebMoney!).

Ну, поскольку я активно общался с автором, предложения, баг-репорты, то он подарил мне лицензию. Ну и вообще мы с ним вроде как тесно общаемся.

Так вот, в стандартном HelpInsight есть проблема: не все тэги поддерживает. Да и выглядит не очень. Но зато его можно изменить через правку шаблона. Соответственно, новая фишка Documentation Insight (в будущем) - custom-шаблон для HelpInsight. Сегодня автор Documentation Insight прислал мне предварительный вариант шаблона для теста.

Ну, поставил я его. Нормально поставил. 100% правильно. Но ...не работает. Т.е. наводишь мышью на идентификатор в коде - вообще ничего не происходит. Даже окна не появляется.

Ну, пока вроде не страшно. Проверил в пустом проекте - не работает.

Среду перезапустил - не работает.

Вернул шаблон по-умолчанию - не работает (?!).

Сделал рестарт машины - заработал.

Гм.

Поставил custom-шаблон, открыл тестовый проект. Работает.

Открыл рабочий проект. Не работает.

Открыл назад тестовый проект. Работает.

Перезапуск. Не работает.

Рабочий открыл. Работает.

Гмммм.....

Потом обнаружил, что в рабочем работают не все идентификаторы. Вот сижу в одном модуле, объявлено 10 функций. Вторая и последняя работает, а в промежутке - нет.

И тут, бац - все работают.

И вдруг - ни одна не работает.

WTF?

Короче, я сидел где-то минут 10, наводя мышью на разные идентификаторы в коде и пытаясь уловить закономерность, когда оно работает, а когда нет. Минуте на 10-й я заметил странную вещь. Я проверил, что один конкретный идентификатор работает и попросил собеседника сказать мне в чате любую фразу. Он сказал. В панели задач замигало окно сообщений QIP. Но... ничего не изменилось.

Гм.

Но тут я заметил, что не работает идентификатор рядом, хотя он работал только что. Тогда я перезапустил среду, очень аккуратно подсветил два идентификатора и попросил сказать ещё что-то.

И что вы думаете? Работали только эти два идентификатора, но не остальные!

Но стоило мне щёлкнуть на окне чата, как заработали все идентификаторы!

Вот так-то.

P.S. А вот и сам шаблон.

10 комментариев :

  1. ололо :D

    хорошо у меня квипа нет :D

    ОтветитьУдалить
  2. Ваще квип имеет какойто дурное влияние на некоторые программы - замечано даже на 1С8!

    ОтветитьУдалить
  3. жаль, что он так быстро стал платным((

    ОтветитьУдалить
  4. Да полторы штуки рублей - не такая уж и большая цена.

    С учётом того, что скоро он будет стоить три с лишним.

    Сравним это с Doc-O-Matic SRC за 15 штук... так вообще почти задаром.

    Да, задачи немного не те выполняет, но генерация готовой документации в планах имеется.

    ОтветитьУдалить
  5. Могу предложить такую версию: QIP может использовать для поиска своих окон EnumWindows, а для признания их своими - только сравнение имён оконных классов (QIP.exe импортирует GetClassName из user32.dll). А имя оконного класса, используемого для Hint'ов (читай - имя класса хинта) вполне может совпасть для двух разных программ, написанных на Delphi. Как вариант: используется поиск окна класса 'TPUtilWindow', которое создаёт широко используемая во всех версиях VCL системная функция AllocateHWnd (кстати... 'TP' - не привет ли это из Турбо Паскаля? :) ). В результате QIP может посчитать своим окно, созданное другим процессом и что-нибудь сделать с ним нехорошее (прибить, например).

    ОтветитьУдалить
  6. Не, потенциально возможно что там дело не в QIP, а в мигании окна на Панели задач, но казалось бы, что общего у HelpInsight и Панели задач?

    ОтветитьУдалить
  7. как причастный к процессу, могу сказать, что окна 'TPUtilWindow' мы за свои не принимаем:)
    скорее всего, тут либо мигание на панели задач, либо мигание в трее.
    Аналогично например есть интересный баг, что во время этого мигания ни в одном делфи приложении не покажутся хинты:)
    оный баг я пока безрезультатно пытаюсь починить:)

    ОтветитьУдалить
  8. не скачивается расширенный шаблон
    https://devjetsoftware.com/products/documentation-insight/more-help-insight-customization/

    где еще его можно скачать?

    ОтветитьУдалить
    Ответы
    1. Сейчас он уже интегрирован в Documentation Insight, ставьте его.

      Удалить
    2. Глянул - он там есть и отдельно в секции Downloads: https://devjetsoftware.com/downloads/

      Удалить

Можно использовать некоторые HTML-теги, например:

<b>Жирный</b>
<i>Курсив</i>
<a href="http://www.example.com/">Ссылка</a>

Вам необязательно регистрироваться для комментирования - для этого просто выберите из списка "Анонимный" (для анонимного комментария) или "Имя/URL" (для указания вашего имени и (опционально) ссылки на сайт). Все прочие варианты потребуют от вас входа в вашу учётку.

Пожалуйста, по возможности используйте "Имя/URL" вместо "Анонимный". URL можно просто не указывать.

Ваше сообщение может быть помечено как спам спам-фильтром - не волнуйтесь, оно появится после проверки администратором.

Примечание. Отправлять комментарии могут только участники этого блога.