Nazwa procedury:
cont_evo_map_color_reg_inter
Działanie:
Tworzy kartogram wg zdefiniowanych przez użytkownika 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. |
| intervals_range | Range | tak | Dwukolumnowy zakres bieżącego arkusza zawierający wartości liczbowe, definiujące przedziały, które mają być zastosowane przy tworzeniu kartogramu. Przedziały sa lewostronie domknięte, wielkości w kolejnych przedziałach muszą się zazębiać, aby uniknąć pomięcia wartości. |
| 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. |
Deklaracja i użycie:
Sub test()
CEM.cont_evo_map_color_reg_inter Range(ActiveSheet.Cells(2, 2), ActiveSheet.Cells(18, 2)), Range("G1:H4"), 80, 80, 200
End Sub
Powyższy przykład obrazuje użycie funkcji cont_evo_map_color_reg_inter.
Zakres z wartościami znajduje się w bieżącym arkuszu ("B2:B18", a 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 zgodna ze zdefiniowanymi przedziałami - w tym przypadku zostaną utworzone 4 przedziały kolorystyczne (zdefiniowano 4 przedziały).
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 > Własne przedziały.
