228
Chương 6: Windows Form
19.
19.
S d ng tr giúp c m-ng -c nh
ử ụ
ợ
ả
ữ ả
S d ng tr giúp c m-ng -c nh
ử ụ
ợ
ả
ữ ả
Bạn muốn hiển thị một chủ đề cụ thể trong file trợ giúp dựa trên điều kiểm hiện
đang được chọn.
Sử dụng thành phần
System.Windows.Forms.HelpProvider
, và thiết lập các thuộc
tính mở rộng (extender property)
HelpKeyword
và
HelpNavigator
cho mỗi điều
kiểm.
.NET hỗ trợ tính năng trợ giúp cảm-ngữ-cảnh (context-sensitive help) thông qua lớp
HelpProvider
. Lớp này là một điều kiểm mở rộng đặc biệt. Khi bạn thêm nó vào khay thành
phần (component tray), nó sẽ thêm một số thuộc tính vào tất cả các điều kiểm trên form. Ví
dụ, hình 6.13 trình bày một form gồm hai điều kiểm và một
HelpProvider
.
ListBox
(hiện đang
được chọn) có thêm các thuộc tính
HelpKeyword
,
HelpNavigator
, và
HelpString
(do
HelpProvider
cấp).
Để sử dụng trợ giúp cảm-ngữ-cảnh với
HelpProvider
, bạn cần thực hiện ba bước sau đây:
1. Thiết lập thuộc tính
HelpProvider.HelpNamespace
là tên của file trợ giúp (chẳng hạn,
myhelp.chm
).
2. Đối với mỗi điều kiểm yêu cầu trợ giúp cảm-ngữ-cảnh, hãy thiết lập thuộc tính mở rộng
HelpNavigator
là
HelpNavigator.Topic
.
3. Đối với mỗi điều kiểm yêu cầu trợ giúp cảm-ngữ-cảnh, hãy thiết lập thuộc tính mở rộng
HelpKeyword
là tên của chủ đề liên kết với điều kiểm này (tên chủ đề phải có trong file
trợ giúp và có thể được cấu hình trong các công cụ tạo file trợ giúp).
Hình 6.13 Các thuộc tính mở rộng do HelpProvider cấp cho ListBox
Nếu người dùng nhấn phím F1 trong khi một điều kiểm nào đó đang nhận focus, file trợ giúp
sẽ được mở một cách tự động và chủ đề liên kết với điều kiểm này sẽ được hiển thị trong cửa