Această prezentare arată cum să afișați o instanță unică a panoului de activități particularizate pentru fiecare mesaj e-mail creat sau deschis. Utilizatorii pot afișa sau ascunde un panou de activitate personalizat utilizând butonul de pe panglica fiecărui mesaj de poștă electronică.
Aplicabilitate. Informațiile din acest articol se aplică proiectelor de completare VSTO pentru Outlook. Pentru informații suplimentare, consultați Disponibilitatea funcțiilor pe tipuri de aplicații și proiecte Office.
Pentru a afișa un panou de sarcini personalizat cu mai multe ferestre Explorer sau inspector, trebuie să creați o nouă instanță a panoului de activități particularizate pentru fiecare fereastră deschisă. Pentru mai multe informații despre comportamentul panourilor de sarcini personalizate în ferestrele Outlook, consultați Partea personalizată de activități.
În acest ghid, codul suplimentar VSTO este prezentat în mici părți pentru a facilita discuția despre logica codului.
În acest ghid, sunt luate în considerare următoarele sarcini:
Proiectarea interfeței utilizator pentru un panou de sarcini personalizat.
Creați o interfață de utilizator pentru o bandă personalizată.
Afișați interfața de utilizator a unui panglică personalizat cu mesaje de poștă electronică.
Creați o clasă pentru gestionarea ferestrelor inspectorilor și a domeniilor de activități personalizate.
Inițializați și eliberați resursele utilizate de programul de completare VSTO.
Sincronizarea comutatorului pe bandă cu o zonă de lucru personalizabilă.
Numele sau locațiile anumitor elemente ale interfeței utilizator Visual Studio afișate pe calculator pot fi diferite de cele listate în instrucțiunile de mai jos. Aceasta depinde de versiunea existentă a Visual Studio și de parametrii utilizați. Pentru informații suplimentare, consultați Configurarea opțiunilor de dezvoltare în Visual Studio.
Componente necesare
Următoarele sunt componentele necesare pentru a finaliza această vizionare.
Eliberarea Visual Studio, care include instrumente pentru dezvoltarea Microsoft Office. Pentru informații suplimentare, consultați Configurarea calculatorului pentru dezvoltarea soluției Office.
Obiectele personalizate pentru sarcini sunt implementate în modulele VSTO. Începeți prin crearea unui proiect VSTO add-in pentru Outlook.
Crearea unui nou proiect
Creați un proiect de add-in Outlook numit OutlookMailItemTaskPane. Utilizați șablonul de proiect pentru Outlook Add-in. Pentru mai multe informații, consultați ghidul de utilizare. Creați proiecte de birou în Visual Studio.
Visual Studio se deschide codul-spatele fișier sau ThisAddIn.cs ThisAddIn.vb și adaugă OutlookMailItemTaskPane proiect în soluție Explorer.
Un designer vizual pentru scopuri personalizate nu este furnizat, dar puteți crea un control personalizat cu interfața de utilizator dorită. Panoul de sarcini personalizat din acest add-in VSTO are o interfață de utilizator simplă care conține un control TextBox. Apoi, în acest ghid, adăugați acest control personalizat în panoul de activități personalizat.
Proiectarea unei interfețe personalizate pentru un panou de sarcini personalizat
În Exploratorul de soluții. faceți clic pe proiectul OutlookMailItemTaskPane.
În meniul Proiect, faceți clic pe Adăugare control utilizator.
În caseta de dialog Adăugați un element nou, schimbați numele noului control particularizat în TaskPaneControl. apoi faceți clic pe Adăugare.
Controlul utilizatorului se deschide în designer.
Glisați comanda TextBox din fila Standard Controls din caseta de instrumente pentru controlul utilizatorului.
Unul dintre obiectivele acestui add-on VSTO este de a permite utilizatorilor să ascundă sau să afișeze un panou de activități personalizat de pe banda fiecărui mesaj de poștă electronică. Pentru a oferi o interfață cu utilizatorul, creați o interfață personalizată personalizată a panglicii personalizate, care afișează un comutator pe care utilizatorul îl poate face clic pentru a afișa sau a ascunde panoul de sarcini personalizat.
Creați un interfață personalizată cu panglici
În meniul Proiect, faceți clic pe Adăugați un element nou.
În caseta de dialog Adăugați un element nou, selectați elementul Panglică (designer vizual).
Schimbați numele benzii noi în ManageTaskPaneRibbon și faceți clic pe butonul Adăugați.
În constructor, banda va ManageTaskPaneRibbon.cs sau ManageTaskPaneRibbon.vb de fișiere și pentru a afișa filele și banda utilizată în mod implicit.
În Designerul de panglici, faceți clic pe grupul1.
În fereastra Proprietăți, setați proprietatea Etichetă la Manager de activități.
Glisați comanda ToggleButton din fila Control Ribbon Office din bara de instrumente în grupul Task Manager Task Manager.
În fereastra Proprietăți, setați proprietatea Etichetă la Afișare scop activitate.
Panoul de sarcini personalizabil pe care îl creați în această previzualizare ar trebui să apară numai cu ferestre de inspectori care conțin mesaje de poștă electronică. Prin urmare, setați proprietățile astfel încât interfața de utilizator a panglicii personalizate să fie afișată numai cu aceste ferestre.
Afișarea interfeței de utilizator a unui panglică personalizat cu mesaje de poștă electronică
În designerul de panglică, faceți clic pe panglica ManageTaskPaneRibbon.
În fereastra Proprietăți, faceți clic pe lista derulantă de lângă proprietatea RibbonType. și selectați Microsoft.Outlook.Mail.Compose și Microsoft.Outlook.Mail.Read.
Există mai multe cazuri în care add-in-ul VSTO trebuie să determine care panou de activități personalizat este asociat cu un anumit mesaj de poștă electronică. Acestea sunt următoarele cazuri.
Când utilizatorul închide mesajul de poștă electronică. În acest caz, add-in-ul VSTO trebuie să elimine panoul de sarcini personalizat corespunzător, astfel încât resursele folosite de acest add-in VSTO să fie corect eliberate.
Când utilizatorul închide panoul de activități personalizat. În acest caz, add-in-ul VSTO trebuie să actualizeze starea comutatorului pe panglica mesajului de poștă electronică.
Când utilizatorul face clic pe butonul de pe bandă. În acest caz, add-in-ul VSTO trebuie să ascundă sau să afișeze panoul de activități corespunzător.
VSTO add-in pentru a ține evidența care panoul de activitate particularizat este asociat cu fiecare mesaj e-mail deschis, creați o clasă personalizată care creează înfășurare pentru perechile de obiecte T: Microsoft.Office.Interop.Outlook.Inspector și CustomTaskPane. Această clasă creează un nou panou de activități personalizate pentru fiecare mesaje e-mail și șterge panoul de activitate personalizată atunci când închideți mesajele de e-mail relevante.
Creați o clasă pentru a gestiona ferestrele inspectorilor și domeniile de activități personalizate
Adăugați următoarele instrucțiuni la începutul fișierului.
Adăugați codul de la clasa ThisAddIn pentru a inițializa VSTO add-in atunci când este încărcat, și, de asemenea, pentru a elibera resursele folosite de această adăuga VSTO, atunci când este descărcată. Inițializați VSTO add-in, creat o tratare a evenimentului pentru eveniment E: Microsoft.Office.Interop.Outlook.InspectorsEvents_Event.NewInspector și transferul tuturor mesajelor de e-mail existente în tratare a evenimentului. Când programul de completare VSTO este descărcat, deconectați acest handler de evenimente și eliberați obiectele folosite de programul de completare VSTO.
Inițializarea și eliberarea resurselor utilizate de programul de completare VSTO
În fișierul ThisAddIn.cs sau ThisAddIn.vb, găsiți definiția de clasă ThisAddIn.
Câmpul inspectorWrappersValue conține toate obiectele T: Microsoft.Office.Interop.Outlook.Inspector și InspectorWrapper. care sunt controlate de add-in-ul VSTO.