Visual basic довідка
Напевно будь-який програміст хоче, щоб його програми були удобниі зрозумілі для будь-якого користувача, навіть для того хто поки ще долгоцелітся мишкою в віконний хрестик. Цього можна домогтися використовуючи Windows-довідку. Існує багато способів підключити справкук програмі на VB. Про кілька з них ви дізнаєтеся з цієї статті.
Підключення довідки через Windows-API
Файл Windows-довідки, природно можна підключити через Windows-API. Для цього служить функція WinHelp, розташована в бібліотеці User32. Оголошується ця функція наступним чином:
Оголосивши функцію можна приступати до її використання (зауважу, що ця функція повинна повертати значення). Параметри функції розшифровуються таким чином:
- hwnd - Handle форми, в VB його можна отримати "Me.hWnd"
- lpHelpFile-Зрозуміло, що це ім'я файлу довідки, шлях повинен бути вказаний точно.
- dwData - Значення цього параметра залежить від значення wCommand
- wCommand - Параметр визначає, що саме буде виведено на екран
Саме wCommand управляє висновком довідки. Його значення можуть битьразлічни, але в основному вони укладаються в таблицю:
Виводить розділ, номер якого вказаний у dwData
Закриває вказаний Help-файл
Виводить предметний покажчик довідкового файлу
Виводить вікно Help Topics і активує вкладку вибраннуюв минулий раз.
Виводить вікно Help Topics і активує вкладку определённуюв dwData (0 - Contents, -2 - Index, -1 - Find).
Виводить розділ Contents. Необхідна для совместімостіс болле ранніми версіями Help-файлів
Виводить довідку про довідку.
Устанавдівает поточний індекс, для многоіндексовойсправочной системи.
Робить розділ, зазначений в dwData, змістом (Contents).
Відображає розділ ідентифікований номером контексту.
Створює довідковий файл, в якому текст відображається лише одним шрифтом.
Показує довідку по конкретному ключовому слову.
Показує довідку по конкретній команді.
Викликає систему пошуку в Windows Help.
Прдключеніе довідки через Common Dialog
Крім Windows API можна використовувати елемент управління Common Dialog. Він дозволяє без особливих зусиль працювати з файлами довідки.
Робота з ним не вимагає ника пояснень, досить тільки додати на форму Common Dialog (Якщо його немає в інструментарії (ToolBox) натисніть CTRL + T, або виберітеComponents в меню Project, і пошукайте в списку), привласнити йому ім'я cdlCommon, і скопіювати в форму наступного код:
До слова скажу, що замість констант Common Dialog, можна іспользоватьконcтанти з таблиці наведеної вище.
Використання властивості HelpContextID
Останнім, розглянутим мною способом підключення файлу довідки до програми на VB будетіспользованіе властивості HelpContextID. Само по собі це властивість відповідає за виведення определённогораздела довідки при натисканні клавіші F1, коли у фокусі знаходиться певний елемент. Ніс допомогою нехитрого трюку можна "натискати" F1 програмно. Все пояснить наступний код. Простовставьте його в порожню форму:
Отже ми розглянули три способи підключення файлу довідки до програми на VB. Додам лише, що весь наведений тут код працює на моєму комп'ютері, в Microsoft Visual Basic5.0 Enterprise Edition.