Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.5. Вызов стандартных диалогов

Описываются функции вызова диалогов RDS и стандартных диалогов Windows.

А.5.5.1. rdsCallColorDialog – вызов диалога выбора цвета

Функция rdsCallColorDialog открывает стандартный диалог, используемый в Windows для выбора цвета.

  BOOL RDSCALL rdsCallColorDialog(
    RDS_PCOLORREF pColor    // Указатель на переменную цвета
  );

Тип указателя на эту функцию

RDS_BpCr

Параметр

pColor (RDS_PCOLORREF)

Указатель на переменную типа COLORREF, в которую запишется выбранный пользователем цвет. Из этой же переменной будет взято значение цвета, которое установится в диалоге сразу после открытия, поэтому параметр pColor не может быть равен NULL.

Возвращаемое значение

TRUE, если пользователь нажал кнопку «OK», и FALSE, если он нажал кнопку «отмена» или просто закрыл окно.

Примечания

Эта функция открывает обычный для Windows диалог выбора цвета, в котором пользователь может выбрать один из стандартных цветов или задать произвольный цвет, введя его компоненты или выбрав точку на цветовом поле. Исходное значение выбранного в диалоге цвета берется из переменной по указателю pColor. Если пользователь закроет диалог кнопкой «ОК», по этому указателю запишется новое значение цвета, в противном случае значение *pColor не изменится.