Диалоговое окно Цвет (Color) возвращает значения RGB цвета, выбранного пользователем. Пользователь может выбирать из набора основных цветов, определенных драйвером дисплея или из набора дополнительных цветов. Вы должны определить начальную установку дополнительных цветов, но вы можете дать возможность пользователям создавать свои собственные дополнительные цвета.

Вы создаете и показываете диалоговое окно Цвет (Color), инициализируя структуру CHOOSECOLOR и передавая параметры структуры в функцию ChooseColor.

Вы можете открыть часть диалогового окна Цвет (Color), чтобы показать основные и дополнительные цвета, из которых пользователь может выбирать, или можете полностью открыть диалоговое окно, чтобы показать дополнительные элементы управления, которые дают возможность пользователю создавать дополнительные цвета. Иллюстрация ниже показывает полностью открытое диалоговое окно Цвет (Color).

Если пользователь щелкает мышью по кнопке OK, ChooseColor возвращает значение ИСТИНА (TRUE). Элемент rgbResult структуры CHOOSECOLOR содержит значения RGB цвета, выбранного пользователем. Значение цвета RGB устанавливает индивидуальную интенсивность красного, зеленого и синего цветов, которые создают выбранный цвет. Индивидуальные значения находятся в пределах от 0 до 255. Используйте макрокоманды GetRValue, GetBValue и GetGValue, чтобы извлечь индивидуальные значения цвета из RGB цвета.

Если пользователь отменяет диалоговое окно Цвет (Color) или происходит ошибка, ChooseColor возвращает значение ЛОЖЬ (FALSE>), а элемент rgbResult не определяется. Чтобы определять причину ошибки, вызовите функцию CommDlgExtendedError, чтобы получить расширенное значение ошибки.