Metoda ShowWhatsThis

Metoda ShowWhatsThis wyświetla określony temat pomocy z pliku pomocy Help, użyty przez polecenie What's This menu PopUp systemu Windows95.

Składnia:

obiekt.ShowWhatsThis

obiekt jest obiektem, który wykorzystuje metodę ShowWhatsThis, dostępny na liście

Metoda ShowWhatsThis jest przydatna do wprowadzenia pomocy kontekstowej w aplikacji.
Metoda ta wyświetla temat określony przez właściwość WhatsThisHelpID obiektu określonego w składni. Aby włączyć podpowiedzi What's This należy ustawić właściwość WhatsThisHelp formy na True.

Przykład użycia metody ShowWhatsThis:

Private ThisControl As Control
  'deklaracja zmiennej

Private Sub Command1_MouseUp(Button As Integer, Shift As Integer, X As Single, Y As Single)
  'procedura zdarzenie MouseUp kontrolki Command1
   If Button = vbRightButton Then
     'jeżeli wciśnięto prawy przycisk myszy
     Set ThisControl = Command1
       'podstawienie kontrolki Command1 pod zmienną
     PopupMenu mnuBtnContextMenu
       'wywołanie menu PopUp
   End If
   Set ThisControl = Nothing
     'wyzerowanie zmiennej
End Sub

Private Sub mnuBtnWhatsThis_Click()
  'procedura zdarzenia Click menu mnuBtnWhatsThis
  ThisControl.ShowWhatsThis
     'wywołanie metody ShowWhatsThis dla określonej kontrolki
End Sub

Zmienne, kontrolki CommandButton i Menu, rozkazy If, Set, metoda PopupMenu i zdarzenia Click i MouseUp zostały opisane w innej części kursu.

W przykładzie należy dodać do formy kontrolkę CommandButton o nazwie Command1. Właściwość WhatsThisHelp formy należy ustawić na True. Przy pomocy MenuEditor należy stworzyć menu, którego najwyższy poziom będzie niewidoczny (puste Caption) o nazwie mnuBtnContextMenu i podmenu o nazwie mnuBtnWhatsThis i Caption "What's This?"
Po wciśnięciu klawisza myszy na przycisku Command1 wywoływane jest zdarzenie MouseUp, które sprawdza czy wciśnięty został prawy klawisz myszy. Jeżeli tak to pod zmienną ThisControl podstawia kontrolkę Command1 i wywołuje metodę PopupMenu, aby wyświetlić menu PopUp. W tym menu znajduje się pozycja "What's This?", której kliknięcie powoduje zdarznie Click dla mnuBtnWhatsThis, które wywołuje metodę ShowWhatsThis kontrolki przekazanej przez zmienną ThisControl (więc przycisku Command1).
Dla działania pomocy What's This, należy dodać plik pomocy do projektu i ustawić właściwość WhatsThisHelpID.
Lista obiektów wykorzystujących metodę ShowWhatsThis:
Animation
CheckBox
ComboBox
CommandButton
Data
DBCombo
DBGrid
DBList
DirListBox
DriveListBox
FileListBox
Frame
HScrollBar
Image
Label
ListBox
OLEContainer
OptionButton
PictureBox
ProgressBar
Slider
SSTab
StatusBar
TabStrip
TextBox
ToolBar
UpDown

na górę strony...