Dodatek CONT-EVO MAP udostępnia kilka podstawowych funkcji, dzięki którym możliwe jest przygotowanie np. interaktywnej prezentacji różnego rodzaju danych na kartogramie.
Udostępnione zostały następujące funkcje:
Funkcja | Parametry i działanie |
CEM.cem_colors_legend_delete | Brak parametrów Funkcja usuwa legendę kolorów utworzonego kartogramu |
CEM.cem_shapes_builder | Dwa parametry:
Funkcja tworzy wizualizację (mapę) regionów wg zakresu, w którym są podane nazwy i dodatkowo skaluje obiekt wynikowy |
CEM.cem_colors_range_w_col | Dwa parametry:
Funkcja tworzy kartogram wg identycznych zasad jak w przykładzie 5. |
CEM.cem_colors_labels | Jeden parametr:
Funkcja wstawia etykiety liczbowe lub usuwa istniejące. |
CEM.cem_regions_labels | Brak parametrów Funkcja wstawia/usuwa nazwy regionów |
Przykładowe użycie (parametry przypadkowe):
UWAGA: W tym miejscu nie zagłębiamy się w tematykę VBA poza zbudowaniem prostej procedury ? to nie jest kurs VBA, jak np. ten umieszczony w lokalizacji https://cont-evo.eu/kursy-on-line/excel/makra-i-vba.
1. W celu skorzystania z udostępnionych funkcji, należy skonfigurować nasz projekt VBA (tj. np. plik Excel zapisany w formacie .xlsm (czyli z obsługą makr) lub .xls (w trybie zgodności).
Aby użyć funkcjonalności udostępnionych przez CONT-EVO MAP, należy uruchomić środowisko VBA (np. skrótem Alt+F11).
Następnie zapisaną na dysku aplikację trzeba dodać do referencji naszego projektu VBA (jest to opisane np. w tym miejscu).
Aby dodatek był "widoczny" dla naszego projektu, trzeba go wyszukać na dysku, czyli użyć przycisku Browse...:
Po czym wskazać plik dodatku i kliknąć OK.
2. Następnie przygotowujemy dane: w arkuszu nazwanym ?mapa? umieszczamy listę regionów, i generujemy ich wizualizację (standardowo, przy użyciu dodatku, np. jak w przykładzie 1). W tym samym arkuszu wstawiamy formant formularza: listę rozwijaną i formatujemy ją tak, aby pobierała zawartość z drugiego arkusza (nazwanego ?dane?) ? z zakresu H1:H4. Komórką celu dla tego formantu jest F1 arkusza ?mapa?. W arkuszu ?mapa? definiujemy też przedziały oraz kolory komórek, jakie będą użyte do tworzenia kartogramu (zakres: R1:S4).
Drugi arkusz zawiera dane dotyczące np. 4 różnych wskaźników, które dynamicznie chcemy przełączać.
Dzięki wykorzystaniu właściwości formantu listy wyboru oraz funkcji WYSZUKAJ.PIONOWO, możemy w zakresie C2:C17 arkusza ?mapa? dynamicznie przełączać dane, po zmianie wyboru pozycji formantu.
Oba nasze arkusze wyglądają teraz następująco:
3. Po takim przygotowaniu danych i arkuszy, wystarczy dopisać prostą procedurę w VBA:
4. Po czym powiązać z nią formant (lista rozwijana):
Gotowe ? teraz z każdą zmianą wyboru pozycji na liście rozwijanej, aplikacja będzie generowała automatycznie nowy kartogram. Oczywiście kolumny, których nie chcemy prezentować, można ukryć.
Plik z omawianym przykładem jest dostępny do pobrania z lokalizacji (do jego działania trzeba poprawnie skonfigurować referencję do dodatku, o czym mowa była na początku tego przykładu):
https://cont-evo.eu/sites/default/files/CONT-EVO%20MAP%20-%20API%20przyk%C5%82ad.xlsm