Nazwa procedury:
cont_evo_map_color_reg
Działanie:
Tworzy kartogram wg automatycznego przypisania wartości do przedziałów.
Argumenty:
| Nazwa | Typ | Wymagany | Opis |
|---|---|---|---|
| data_range | Range | tak | Zakres bieżącego arkusza zawierający wartości liczbowe, na bazie których będzie utworzony kartogram. Zakres musi być w kolumnie równoległej do zakresu, w którym znajdują się identyfikatory obiektów, z których stworzona została wcześniej mapa. |
| r | Byte | tak | Współrzędna R (Red - czerwony) w określeniu barwy wyjściowej (najciemniejszej) dla tworzonego kartogramu. Liczba z przedziału 0-255. |
| g | Byte | tak | Współrzędna G (Green - zielony) w określeniu barwy wyjściowej (najciemniejszej) dla tworzonego kartogramu. Liczba z przedziału 0-255. |
| b | Byte | tak | Współrzędna B (Blue - niebieski) w określeniu barwy wyjściowej (najciemniejszej) dla tworzonego kartogramu. Liczba z przedziału 0-255. |
| colors_number | Integer | tak | Wartość określająca liczbę przedziałów jaka ma zostać użyta dla stworzenia kartogramu z podanych wartości. |
Deklaracja i użycie:
Sub test()
CEM.cont_evo_map_color_reg Range(ActiveSheet.Cells(2, 2), ActiveSheet.Cells(18, 2)), 80, 80, 200, 4
End Sub
Sub test()
CEM.cont_evo_map_color_reg Range("B2:B18"), 80, 80, 200, 4
End Sub
Powyższy przykład obrazuje użycie funkcji cont_evo_map_color_reg.
Zakres z wartościami znajduje się w bieżącym arkuszu ("B2:B18" - identyfikatory obiektów w np. w "A2:A18" - zakresy powinny być spójne) - zakres może być definiowany na dwa możliwe sposoby zaprezentowane powyżej.
Wywołanie procedury spowoduje pokolorowanie zdefiniowanej uprzednio mapy (stworzenie kartogramu) i dodanie legendy.
Liczba odcieni użytych do utworzenia kartogramu jest określona jako ostatni argument - w tym przypadku zostaną utworzone 4 przedziały kolorystyczne (w zależności od podanych wartości, procedura może stworzyć też mniejszą ich liczbę).
Kolorystyka określona została przez wartości argumentów: r, g oraz b - w powyższym przykładzie przeważająca wartość b - spowoduje, że będą to odcienie niebieskiego.
Generalna zasada stanowi, iż im wartości argumentów są mniejsze, tym barwy używane do kolorowania będą ciemniejsze, przy czym nie należy stosować wartości bliskich zeru.
Funkcjonalność ta odpowiada poleceniu na wstążce dodatku Kartogram > Koloruj > Automatycznie.
