IDWriteFontFace5

フォントフェイスの種類、適切なファイル参照、およびフェイス識別データを含みます。(IDWriteFontFace5)

フォントで定義された軸の数を取得します。これには静的軸と可変軸の両方が含まれます。

Type: UINT32

フォントフェイスで定義された軸の数。

フォントで使用される軸値のリストを取得します。

Type: HRESULT

関数が成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコード を返します。

値はフォントで定義された正規の順序で返され、実際にサポートされる範囲にクランプされます。これは必ずしも CreateFontFace に渡した軸値の配列と同じであるとは限りません。

例

// main.cpp
#include <unknwn.h>
#include <winrt/base.h>
#include <dwrite_3.h>

int main()
{
    winrt::init_apartment();

    winrt::com_ptr<IDWriteFactory> factory;

    winrt::check_hresult(::DWriteCreateFactory(
        DWRITE_FACTORY_TYPE_SHARED,
        __uuidof(factory),
        reinterpret_cast<IUnknown**>(factory.put())));

    std::wstring filePath{ L"C:\\WINDOWS\\FONTS\\AGENCYB.TTF" };

    winrt::com_ptr<IDWriteFontFile> fontFile;

    factory->CreateFontFileReference(
        filePath.c_str(),
        nullptr,
        fontFile.put());

    std::array<IDWriteFontFile*, 1> fontFiles{ fontFile.get() };

    winrt::com_ptr<IDWriteFontFace> fontFace;

    winrt::check_hresult(factory->CreateFontFace(
        DWRITE_FONT_FACE_TYPE_TRUETYPE,
        1,
        fontFiles.data(),
        0,
        DWRITE_FONT_SIMULATIONS_NONE,
        fontFace.put()
    ));

    winrt::com_ptr<IDWriteFontFace5> fontFace5{ fontFace.as<IDWriteFontFace5>() };
    
    UINT32 axisValueCount{ fontFace5->GetFontAxisValueCount() };

    DWRITE_FONT_AXIS_VALUE* axisValues{ new DWRITE_FONT_AXIS_VALUE[axisValueCount] };

    winrt::check_hresult(
        fontFace5->GetFontAxisValues(axisValues, axisValueCount));

    DWRITE_FONT_AXIS_VALUE* eachAxisValue{ axisValues };

    for (int ix = 0; ix < axisValueCount; ++ix, ++eachAxisValue)
    {
        printf("%zu,%f\n\r", eachAxisValue->axisTag, eachAxisValue->value);
    }

    delete[] axisValues;
}

このフォントフェイスのリソースが可変軸をサポートするかどうかを判定します。(IDWriteFontFace5::HasVariations)

Type: BOOL

フォントフェイスのリソースが可変軸をサポートする場合は true。それ以外の場合は false。

このフォントフェイスの基になるフォントリソースを取得します。

Type: HRESULT

関数が成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコード を返します。

Equals が呼び出されているフォントフェイスオブジェクトと、パラメーターとして渡されたフォントフェイスオブジェクトとの等価比較を実行します。

Type: BOOL

フォントフェイスオブジェクトが等しい場合は true。それ以外の場合は false。