IXpsOMRadialGradientBrush

放射状グラデーションを指定します。

次の図に示すように、放射状グラデーションのグラデーション領域は、中心点と、その中心点から伸びる x 半径および y 半径によって定義される楕円で囲まれた領域です。スプレッド領域は、その楕円の外側の領域です。グラデーションパス (図には示されていません) は、グラデーションの原点とグラデーション領域を囲む楕円との間に引かれる放射状の線です。

IXpsOMRadialGradientBrush    *newInterface;
// 次の値は、この例の外部で
// 定義されています。
//  IXpsOMGradientStop       *gradStop1, *gradStop2;
//  XPS_POINT                centerPoint, gradientOrigin;
//  XPS_SIZE                 radiiSizes;

// このスレッドから CoInitializeEx が事前に呼び出されている
//  ことが暗黙の前提条件である点に注意してください。

hr = CoCreateInstance(
    __uuidof(XpsOMObjectFactory),
    NULL,
    CLSCTX_INPROC_SERVER,
    _uuidof(IXpsOMObjectFactory),
    reinterpret_cast<LPVOID*>(&xpsFactory)
    );

if (SUCCEEDED(hr))
{
    hr = xpsFactory->CreateRadialGradientBrush (
        gradStop1,
        gradStop2,
        &centerPoint,
        &gradientOrigin,
        &radiiSizes,
        &newInterface);

    if (SUCCEEDED(hr))
    {
        // newInterface を使用します

        newInterface->Release();
    }
    xpsFactory->Release();
}
else
{
    // hr で返された HRESULT エラーを評価します
}

放射状グラデーション領域の楕円の中心点を取得します。

このメソッドは HRESULT を返します。返される可能性のある値には、次の表に示すものが含まれますが、これらに限定されません。この表に記載されていない XPS ドキュメント API の戻り値については、XPS Document Errors を参照してください。

center で指定される x 座標と y 座標は、ページを基準とし、有効になっている変換の単位で表されます。

次の図は、放射状グラデーションの各部を示しています。center は、放射状グラデーション領域を囲む楕円の中心点の位置を取得します。この図の詳細な説明については、IXpsOMRadialGradientBrush を参照してください。

放射状グラデーション領域の楕円の中心点を設定します。

このメソッドは HRESULT を返します。返される可能性のある値には、次の表に示すものが含まれますが、これらに限定されません。この表に記載されていない XPS ドキュメント API の戻り値については、XPS Document Errors を参照してください。

center で指定される x 座標と y 座標は、ページを基準とし、有効になっている変換の単位で表されます。

次の図は、放射状グラデーションの各部を示しています。center は中心点の位置を設定します。この図の詳細な説明については、IXpsOMRadialGradientBrush を参照してください。

放射状グラデーション領域の楕円を定義する半径のサイズを取得します。

このメソッドは HRESULT を返します。返される可能性のある値には、次の表に示すものが含まれますが、これらに限定されません。この表に記載されていない XPS ドキュメント API の戻り値については、XPS Document Errors を参照してください。

次の図は、放射状グラデーションの各部を示しています。radiiSizes.width は x 半径を、radiiSizes.height は y 半径を取得します。この図の詳細な説明については、IXpsOMRadialGradientBrush を参照してください。

放射状グラデーション領域の楕円を定義する半径のサイズを設定します。

このメソッドは HRESULT を返します。返される可能性のある値には、次の表に示すものが含まれますが、これらに限定されません。この表に記載されていない XPS ドキュメント API の戻り値については、XPS Document Errors を参照してください。

次の図は、放射状グラデーションの各部を示しています。radiiSizes.width は x 半径を、radiiSizes.height は y 半径を設定します。この図の詳細な説明については、IXpsOMRadialGradientBrush を参照してください。

放射状グラデーションの原点を取得します。

このメソッドは HRESULT を返します。返される可能性のある値には、次の表に示すものが含まれますが、これらに限定されません。この表に記載されていない XPS ドキュメント API の戻り値については、XPS Document Errors を参照してください。

origin で指定される x 座標と y 座標は、ページを基準とし、有効になっている変換の単位で表されます。

次の図は、放射状グラデーションの各部を示しています。origin は、グラデーションの原点の位置を取得します。この図の詳細な説明については、IXpsOMRadialGradientBrush を参照してください。

放射状グラデーションの原点を設定します。

このメソッドは HRESULT を返します。返される可能性のある値には、次の表に示すものが含まれますが、これらに限定されません。この表に記載されていない XPS ドキュメント API の戻り値については、XPS Document Errors を参照してください。

origin で指定される x 座標と y 座標は、ページを基準とし、有効になっている変換の単位で表されます。

次の図は、放射状グラデーションの各部を示しています。origin は、放射状グラデーションの原点の位置を設定します。この図の詳細な説明については、IXpsOMRadialGradientBrush を参照してください。

インターフェイスのディープコピーを作成します。(IXpsOMRadialGradientBrush.Clone)

このメソッドは HRESULT を返します。返される可能性のある値には、次の表に示すものが含まれますが、これらに限定されません。この表に記載されていない XPS ドキュメント API の戻り値については、XPS Document Errors を参照してください。

このメソッドは、新しい IXpsOMRadialGradientBrush インターフェイス内のリソースポインターを更新しません。