Приложения

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

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

А.5.19. Графические функции

А.5.19.9. rdsXGGetStdIconSize – получить размеры стандартной иконки

Функция rdsXGGetStdIconSize возвращает размеры одной из стандартных иконок RDS.

  BOOL RDSCALL rdsXGGetStdIconSize(
    DWORD Icon,     // Идентификатор иконки (RDS_STDICON_*)
    int *pWidth,    // Возвращаемая ширина
    int *pHeight    // Возвращаемая высота
  );

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

RDS_BDwpIpI

Параметры

Icon (DWORD): Идентификатор изображаемой иконки – одна из констант RDS_STDICON_*.
pWidth (int*): Указатель на целую переменную, в которую функция должна записать ширину иконки в точках экрана. Если вызывающей программе не нужна ширина иконки, в этом параметре можно передать NULL.
pHeight (int*): Указатель на целую переменную, в которую функция должна записать высоту иконки в точках экрана. Если вызывающей программе не нужна высота иконки, в этом параметре можно передать NULL.

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

TRUE – размеры иконки считаны, FALSE – в RDS нет иконки с идентификатором Icon.

Примечания

Эта функция возвращает размеры одной из стандартных иконок, которую можно нарисовать вызовом rdsXGDrawStdIcon. На данный момент все стандартные иконки имеют размер 16×16 точек, но в будущих версиях RDS могут появиться и иконки другого размера, поэтому при рисовании не следует полагаться на заранее известный размер иконки.

Пример

Пример использования функции rdsXGDrawStdIcon приведен в §2.10.3 руководства программиста.

См. также

rdsXGDrawStdIcon.