Okno dialogowe kolorów zwraca wartość RGB koloru wybranego przez użytkownika. Użytkownik może wybrać z zestawu kolory podstawowe określone przez sterownik ekranu lub zestaw kolorów niestandardowych. Należy określić początkowy zestaw kolorów niestandardowych, ale można zezwolić użytkownikom na tworzenie własnych kolorów niestandardowych.
Tworzenie i wyświetlanie okna dialogowego kolorem inicjowania struktura CHOOSECOLOR i przekazywanie struktury funkcji ChooseColor.
Częściowo można otworzyć okno dialogowe kolorów do wyświetlania kolorów podstawowych i niestandardowych, z których użytkownik może wybrać, lub całkowicie można otworzyć okno dialogowe, aby wyświetlić dodatkowe kontrole, które pozwala użytkownikowi na tworzenie kolorów niestandardowych. Na poniższej ilustracji przedstawiono całkowicie otwarte okno dialogowe kolorów.
ChooseColor zwraca wartość TRUE, jeśli użytkownik kliknie przycisk OK . Członek rgbResult struktury CHOOSECOLOR zawiera wartość koloru RGB koloru wybranego przez użytkownika. Wartość koloru RGB Określa intensywność poszczególnych kolorów czerwonego, zielonego i niebieskiego, które tworzą wybrany kolor. Poszczególne wartości z zakresu od 0 do 255. Użycie GetRValue, GetBValue, i GetGValue makra w celu wyodrębnienia pojedyncze kolory z RGB wartości kolorów.
Jeśli użytkownik anuluje okno dialogowe kolorów lub wystąpi błąd, ChooseColor zwraca wartość FALSE, a element rgbResult nie jest zdefiniowana. Aby ustalić przyczynę błędu, należy wywołać funkcję CommDlgExtendedError , aby pobrać wartość błędu rozszerzonego.