Przykładowe rozszerzenie programu Excel: klasa TechnologyManager

Artykuł
06/08/2015

Ta klasa dziedziczy UITechnologyManager klasy i jest odpowiedzialny za zapewnienie najważniejsze usługi umożliwiające Microsoft Excel rozszerzenia.Chociaż w klasie podstawowej jest wiele metod, tylko ich podzbiór jest używany w tej próbce.

Niektóre metody zwracają tylko wartość właściwości.Wiele metod są przeznaczone do umożliwiania autora zastąpić domyślne, które algorytmy wbudowanie w zakodowanej badanym silniku interfejsu użytkownika.Tych metod generują NotSupportedException lub return null, który informuje RAM, aby używać algorytmu domyślne.

W zależności od złożoności technologii tworzenia kodu Menedżera technologii może uzyskać od kilku tygodni do kilku miesięcy.Program Excel daje możliwość utworzenia potencjalnie bardzo obszerny technologii menedżera.W tym przykładzie jest celowo ograniczona do arkuszy programu Excel i komórek i używa ograniczone formatowanie.

Gdy to możliwe, kod Menedżera technologii używa kanału .NET Remoting, otwarty przez Communicator klasy do pobierania informacji z dodatku działających w procesie programu Excel.

Widoczność com.

Rozszerzanie ogłoszenia, że ta klasa i każdy element klasy, które UITechnologyElement klasy wszystkie składają się z ComVisibleAttribute o wartości true aby upewnić się, że klasy są widoczne dla modelu COM.

Właściwość TechnologyName

Zastępująca ten UITechnologyManager.TechnologyName właściwość, musisz podać nazwę opisowej, identyfikujący stosowanych technologiach, dla każdego składnika, rozszerzenia.Dla tego rozszerzenia wartość jest "Excel".

Metoda GetControlSupportLevel

Zastępująca ten UITechnologyManager.GetControlSupportLevel metoda zwraca numer wskazujący poziom wsparcia, że Menedżer technologii może zaoferować do celów kontroli, reprezentowane przez dojście do dostarczonego.Im wyższa wartość zwrócona więcej manager technologii może obsługiwać formantu.W takim przypadku metoda sprawdza okna zawierającego ten formant i jeśli to jest arkusz programu Excel, metoda zwraca najwyższą wartość; w przeciwnym razie zwraca wartość zero, co oznacza, że nie jest obsługiwana.

Metody uzyskania elementu

Istnieje kilka ważnych metod, które są używane w ramach badań kodowane jako interfejs użytkownika Aby element specyficzne dla technologii poprzez zapewnienie uchwytu punktu na ekranie lub element z różnych technologii.Kod dla metody te nie wymagają wyjaśnień.Podstawowych metod są następujące:

Metoda ParseQueryId

Gdy tworzony jest kodowane jako test interfejsu użytkownika, użytkownik może określić wartości właściwości dla niektórych lub wszystkich formantów w teście.Wartości tej właściwości są używane w ramach testów do utworzenia pary nazwa wartość o nazwie właściwości wyszukiwania, które są używane do znajdowania określonych kontroli interfejsu użytkownika podczas badania.Wszystkie właściwości wyszukiwania łącznie stanowią wartość UITechnologyElement.QueryId właściwości każdego elementu w technologii, która obejmuje każdy formant.Ponieważ formant może być konieczne można znaleźć kilka razy podczas testu, ta metoda daje manager technologii celu zoptymalizowania podczas analizowania właściwości wyszukiwania dla danego formantu.Ta metoda zwraca również pliku cookie, który w ramach można użyć do wyszukiwania kolejnych dla tego formantu.Korzysta z tej implementacji metody AndCondition.Match metoda właściwości wyszukiwania do.

Metoda MatchElement

Aby rozpocząć wyszukiwanie kontroli przez Menedżera technologii, można zaimplementować UITechnologyManager.Search metoda albo zwraca tablicę możliwych dopasowań, albo rzucić NotSupportedException, który informuje ramach obsłudze algorytm wyszukiwania.Tak czy inaczej, należy zaimplementować MatchElement metodę, której używa tej implementacji ponownie AndCondition.Match metoda.

Metod nawigacji

Te metody uzyskać nadrzędnej, dzieci lub elementy równorzędne dostarczonego elementu z hierarchii interfejsu użytkownika.Kod jest prosty i wyraźnie w nim komentarze.