Ajutorul contextual care apare în ferestrele pop-up
HHW Toolkit vă permite să creați și să includă un ghid de referință secțiune specială popup-uri TEXT, concepute pentru a funcționa cu ajutorul sensibile la context la elementele interfeței și apariția acestor referințe în ferestre pop-up. Crearea secțiunii TEXT POPUPS, care este necesară atunci când se lucrează cu astfel de referințe contextuale, ar trebui să fie precedată de crearea a două fișiere text. Una dintre ele poate exista deja dacă a fost creată o secțiune MAP, este un fișier antet care specifică maparea între identificatorii simbolici și numerici. Al doilea fișier text conține o descriere a mesajelor contextuale care vor apărea în ferestrele pop-up. Puțin mai târziu voi vorbi despre sintaxa pe care ar trebui să o satisfacă acest fișier. După crearea acestor două fișiere, puteți continua să creați secțiunea TEXT POPUPS, faceți clic pe fila cu același nume.
Fig. 9.21. Crearea secțiunii TEXT POPUPS
Două butoane de comandă „antet“ și „Text File“ permite să includă în două fișiere secțiuni - fișierul antet și cu fișierul de mesaje contextuale, care ar trebui să furnizeze CHM-fișierul compilat cu capacitatea de a emite cereri de ajutor sensibile la context la elementele interfeței. Există o mici diferențe, dar enervant în modul în care să se conecteze fișierul antet în secțiunile MAP și ALIAS este TEXT popup-uri. În primele două cazuri, # include <имя файла>. În acest din urmă caz, numele fișierului este inserat direct, ceea ce nu permite evitarea problemei care apare din "invizibilitatea" fișierului antet.
Crearea unui fișier text cu ajutorul contextual
Ajutorul contextual care apare în ferestrele pop-up, de regulă, sunt texte de dimensiuni mici. Prin urmare, spre deosebire de secțiunile obișnuite ale manualului de referință, fiecare dintre acestea fiind conținută într-un fișier separat, toate aceste tipuri de ajutor sensibil la context pot fi colectate într-un singur fișier. Uneori este preferabil să aveți mai multe fișiere în loc de un fișier mare, de exemplu, fișiere separate pentru elementele fiecărui formular. Un astfel de fișier de colecție cu ajutorul contextual în HHW este creat în text, nu în format HTML. Structura unui astfel de fișier este destul de simplă și satisface următoarea sintaxă:
Fișierul, după cum puteți vedea, reprezintă secvența secțiunilor denumite. Antetul secțiunii începe cu un cuvânt cheie special și conține identificatorul simbolic al secțiunii. Aici este sintaxa sa:
Textul ajutorului sensibil la context este un text simplu fără imagini și alte decorațiuni, posibil pentru textele în format HTML utilizate în secțiunile manualului de referință. Iată două secțiuni inițiale din fișierul creat pentru următorul exemplu:
Fig. 9.22. Rezultatul compilării proiectului hhp al jocului "Lupul, Capra și Varza"
Pe de altă parte, merită menționat faptul că, atunci când se testează un proiect, ambele funcții HtmlHelp API funcționează bine, ceea ce, în sine, oferă posibilitatea de a organiza ajutor în contextul contextual prin utilizarea apelurilor funcției HtmlHelp.
În cele ce urmează, finalizez descrierea a două probleme importante care apar atunci când se creează fișiere chm. În cele din urmă, am învățat cum să asociem identificatorii simbolici și numerici cu secțiunile din manualul de referință. Am descris în detaliu modul de a construi un fișier text care conține elemente prefabricate de ajutor sensibile la context, și cum să adăugați o secțiune în manualul de popup-uri, dar, din păcate, eforturile mele de a rezolva problemele în această etapă, nu au avut succes.
Ajutor contextual pentru elemente de interfață. experiment
Au fost făcute toate lucrările necesare, atât pe partea de proiect software "Wolf, Goat and Cabbage", cât și pe marginea creării unui manual de referință pentru acest joc. Am creat și am înregistrat un fișier chm care conține ambele secțiuni ale manualului de referință obișnuit și ajutor sensibil la context pentru elementele de interfață a formei care reprezintă câmpul de joc. Pe baza fișierului chm, a fost creat un fișier Aw, care permite lui Rocky să răspundă la întrebări. Rămâne să realizăm experimente și să vedem ce funcționează din toate acestea. În primul rând, am încercat să obțin ajutor de ajutor pentru aceste inscripții pe formularul pentru care sunt definite identificatorii numerici și sunt create secțiunile corespunzătoare din manualul de referință:
Fig. 9.23. Încercați să obțineți ajutor de tip context pentru elementul de interfață
După cum puteți vedea, există un mesaj că nu există ajutor pentru acest element de interfață. Deși motivul adevărat nu este absența unei partiții, dar faptul că nu este specificată maparea dorită a identificatorului numeric la identificatorul de simbol și secțiunea asociată care conține contextul de ajutor. Ce lucrează în situația dată? Dacă cursorul specializat cu semnul întrebării nu conduce la elementele interfeței pentru care este specificat ID-ul HelpContext. și faceți clic oriunde într-un loc arbitrar în formă, se va deschide ghidul de referință și veți putea obține ajutor în mod obișnuit. Rețineți că nu este necesar să creați alte butoane de comandă sau comenzi de meniu pentru acest lucru. Acest lucru nu este chiar ceea ce aș vrea, dar este destul de ușor să numiți manualul de referință în formă, care, în analiza finală, vă permite să obțineți ajutor pentru toate elementele interfeței.
Pentru a obține ajutor contextual în formulare, puteți utiliza și tasta F1. În exemplul nostru funcționează exact ca un cursor special cu semnul întrebării, care vă permite să deschideți ghidul de referință, dar secțiunea de deschidere este întotdeauna stabilită de formularul însuși - ID-ul său HelpContext și nu depinde de ce element al interfeței a fost activ. Rețineți că apăsarea tastei F1 va deschide, de asemenea, ghidul de referință dacă proprietatea formularului WhatThisButton este dezactivată.
De asemenea, asistența poate fi emisă de asistent.
Fig. 9.24. Rocky răspunde la întrebarea despre personajele principale ale jocului
După cum puteți vedea, Rocky a arătat toate subiectele în care sunt descrise obiectele vizuale solicitate. Acesta este un alt mod de a rezolva sarcina. Modul de a face față sarcinii există întotdeauna. Sper că este adevărat că în următoarea versiune a HHW nu va trebui să căutați soluții și va exista o cale directă de a rezolva această problemă.