Метод FontFamily::IsStyleAvailable (gdiplusheaders.h)

Статья
08/24/2023

Метод FontFamily::IsStyleAvailable определяет, доступен ли указанный стиль для этого семейства шрифтов.

Синтаксис

BOOL IsStyleAvailable(
  [in] INT style
);

Параметры

[in] style

Тип: INT

Целое число, задающее стиль шрифта. Это значение должно быть элементом перечисления FontStyle или результатом побитового ИЛИ , примененного к двум или более из этих элементов. Например, FontStyleBold | FontStyleUnderline | FontStyleStrikeout задает сочетание трех стилей.

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

Тип: BOOL

Если стиль или сочетание стилей доступны, этот метод возвращает значение TRUE; В противном случае возвращается значение FALSE.

Этот метод возвращает вводящий в заблуждение результат для некоторых сторонних шрифтов. Например, может возвращать значение FALSE, IsStyleAvailable(FontStyleUnderline) так как он действительно проверяет наличие обычного шрифта, который также является подчеркнутым шрифтом: (FontStyleRegular | FontStyleUnderline). Если шрифт не имеет обычного стиля, метод IsStyleAvailable возвращает значение FALSE.

Примеры

В следующем примере создается объект FontFamily . Если в семействе шрифтов доступен обычный стиль, в примере рисуется текст.

VOID Example_IsStyleAvailable(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a FontFamily object.
   FontFamily myFontFamily(L"arial");
   
   // Check to see if the regular style is available.
   BOOL isStyleAvailable = myFontFamily.IsStyleAvailable(FontStyleRegular);

   // If regular style is available, draw text.
   if (isStyleAvailable)
   {
       SolidBrush solidbrush(Color(255, 0, 0, 0));
       Font       font(&myFontFamily, 16);
       WCHAR      string[100];
       swprintf_s(string, L"myFontFamily is available in regular style");
       graphics.DrawString(string,
                           wcslen(string), &font, PointF(0, 0), &solidbrush);
   }
}

Требования

Требование	Значение
Минимальная версия клиента	Windows XP, Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	gdiplusheaders.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll

См. также раздел

Создание частной коллекции шрифтов

FontFamily

FontStyle

Поделиться через