Code:
/ Net / Net / 3.5.50727.3053 / DEVDIV / depot / DevDiv / releases / whidbey / netfxsp / ndp / fx / src / CommonUI / System / Drawing / Advanced / LinearGradientBrush.cs / 2 / LinearGradientBrush.cs
//------------------------------------------------------------------------------
//
// Copyright (c) Microsoft Corporation. All rights reserved.
//
//-----------------------------------------------------------------------------
namespace System.Drawing.Drawing2D {
using System.Diagnostics;
using System;
using System.ComponentModel;
using Microsoft.Win32;
using System.Runtime.InteropServices;
using System.Drawing;
using System.Drawing.Internal;
/**
* Represent a LinearGradient brush object
*/
///
///
///
/// Encapsulates a with a linear gradient.
///
///
public sealed class LinearGradientBrush : Brush {
private bool interpolationColorsWasSet;
/**
* Create a new rectangle gradient brush object
*/
///
///
/// Initializes a new instance of the class with the specified points and
/// colors.
///
public LinearGradientBrush(PointF point1, PointF point2,
Color color1, Color color2)
{
IntPtr brush = IntPtr.Zero;
int status = SafeNativeMethods.Gdip.GdipCreateLineBrush(new GPPOINTF(point1),
new GPPOINTF(point2),
color1.ToArgb(),
color2.ToArgb(),
(int)WrapMode.Tile,
out brush);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
SetNativeBrush(brush);
}
///
///
///
/// Initializes a new instance of the class with the
/// specified points and colors.
///
///
public LinearGradientBrush(Point point1, Point point2,
Color color1, Color color2)
{
IntPtr brush = IntPtr.Zero;
int status = SafeNativeMethods.Gdip.GdipCreateLineBrushI(new GPPOINT(point1),
new GPPOINT(point2),
color1.ToArgb(),
color2.ToArgb(),
(int)WrapMode.Tile,
out brush);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
SetNativeBrush(brush);
}
///
///
///
/// Encapsulates a new instance of the class with
/// the specified points, colors, and orientation.
///
///
public LinearGradientBrush(RectangleF rect, Color color1, Color color2,
LinearGradientMode linearGradientMode)
{
//validate the LinearGradientMode enum
//valid values are 0x0 to 0x3
if (!ClientUtils.IsEnumValid(linearGradientMode, (int)linearGradientMode, (int)LinearGradientMode.Horizontal, (int)LinearGradientMode.BackwardDiagonal)){
throw new InvalidEnumArgumentException("linearGradientMode", (int)linearGradientMode, typeof(LinearGradientMode));
}
//validate the rect
if (rect.Width == 0.0 || rect.Height == 0.0) {
throw new ArgumentException(SR.GetString(SR.GdiplusInvalidRectangle, rect.ToString()));
}
IntPtr brush = IntPtr.Zero;
GPRECTF gprectf = new GPRECTF(rect);
int status = SafeNativeMethods.Gdip.GdipCreateLineBrushFromRect(ref gprectf,
color1.ToArgb(),
color2.ToArgb(),
(int) linearGradientMode,
(int)WrapMode.Tile,
out brush);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
SetNativeBrush(brush);
}
///
///
///
/// Encapsulates a new instance of the class with the
/// specified points, colors, and orientation.
///
///
public LinearGradientBrush(Rectangle rect, Color color1, Color color2,
LinearGradientMode linearGradientMode)
{
//validate the LinearGradientMode enum
//valid values are 0x0 to 0x3
if (!ClientUtils.IsEnumValid(linearGradientMode, (int)linearGradientMode, (int)LinearGradientMode.Horizontal, (int)LinearGradientMode.BackwardDiagonal))
{
throw new InvalidEnumArgumentException("linearGradientMode", (int)linearGradientMode, typeof(LinearGradientMode));
}
//validate the rect
if (rect.Width == 0 || rect.Height == 0) {
throw new ArgumentException(SR.GetString(SR.GdiplusInvalidRectangle, rect.ToString()));
}
IntPtr brush = IntPtr.Zero;
GPRECT gpRect = new GPRECT(rect);
int status = SafeNativeMethods.Gdip.GdipCreateLineBrushFromRectI(ref gpRect,
color1.ToArgb(),
color2.ToArgb(),
(int) linearGradientMode,
(int)WrapMode.Tile,
out brush);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
SetNativeBrush(brush);
}
///
///
///
/// Encapsulates a new instance of the class with the
/// specified points, colors, and orientation.
///
///
public LinearGradientBrush(RectangleF rect, Color color1, Color color2,
float angle)
: this(rect, color1, color2, angle, false) {}
///
///
///
/// Encapsulates a new instance of the class with the
/// specified points, colors, and orientation.
///
///
public LinearGradientBrush(RectangleF rect, Color color1, Color color2,
float angle, bool isAngleScaleable)
{
IntPtr brush = IntPtr.Zero;
//validate the rect
if (rect.Width == 0.0 || rect.Height == 0.0) {
throw new ArgumentException(SR.GetString(SR.GdiplusInvalidRectangle, rect.ToString()));
}
GPRECTF gprectf = new GPRECTF(rect);
int status = SafeNativeMethods.Gdip.GdipCreateLineBrushFromRectWithAngle(ref gprectf,
color1.ToArgb(),
color2.ToArgb(),
angle,
isAngleScaleable,
(int)WrapMode.Tile,
out brush);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
SetNativeBrush(brush);
}
///
///
///
/// Encapsulates a new instance of the class with the
/// specified points, colors, and orientation.
///
///
public LinearGradientBrush(Rectangle rect, Color color1, Color color2,
float angle)
: this(rect, color1, color2, angle, false) {
}
///
///
///
/// Encapsulates a new instance of the class with the
/// specified points, colors, and orientation.
///
///
public LinearGradientBrush(Rectangle rect, Color color1, Color color2,
float angle, bool isAngleScaleable)
{
IntPtr brush = IntPtr.Zero;
//validate the rect
if (rect.Width == 0 || rect.Height == 0) {
throw new ArgumentException(SR.GetString(SR.GdiplusInvalidRectangle, rect.ToString()));
}
GPRECT gprect = new GPRECT(rect);
int status = SafeNativeMethods.Gdip.GdipCreateLineBrushFromRectWithAngleI(ref gprect,
color1.ToArgb(),
color2.ToArgb(),
angle,
isAngleScaleable,
(int)WrapMode.Tile,
out brush);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
SetNativeBrush(brush);
}
///
/// Constructor to initialized this object to be owned by GDI+.
///
internal LinearGradientBrush(IntPtr nativeBrush )
{
Debug.Assert( nativeBrush != IntPtr.Zero, "Initializing native brush with null." );
SetNativeBrush( nativeBrush );
}
///
///
/// Creates an exact copy of this .
///
public override object Clone() {
IntPtr cloneBrush = IntPtr.Zero;
int status = SafeNativeMethods.Gdip.GdipCloneBrush(new HandleRef(this, this.NativeBrush), out cloneBrush);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
return new LinearGradientBrush(cloneBrush);
}
/**
* Get/set colors
*/
private void _SetLinearColors(Color color1, Color color2)
{
int status = SafeNativeMethods.Gdip.GdipSetLineColors(new HandleRef(this, this.NativeBrush),
color1.ToArgb(),
color2.ToArgb());
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
private Color[] _GetLinearColors()
{
int[] colors =
new int[]
{
0,
0
};
int status = SafeNativeMethods.Gdip.GdipGetLineColors(new HandleRef(this, this.NativeBrush), colors);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
Color[] lineColor = new Color[2];
lineColor[0] = Color.FromArgb(colors[0]);
lineColor[1] = Color.FromArgb(colors[1]);
return lineColor;
}
///
///
/// Gets or sets the starting and ending colors of the
/// gradient.
///
public Color[] LinearColors
{
get { return _GetLinearColors();}
set { _SetLinearColors(value[0], value[1]);}
}
/**
* Get source rectangle
*/
private RectangleF _GetRectangle() {
GPRECTF rect = new GPRECTF();
int status = SafeNativeMethods.Gdip.GdipGetLineRect(new HandleRef(this, this.NativeBrush), ref rect);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
return rect.ToRectangleF();
}
///
///
///
/// Gets a rectangular region that defines the
/// starting and ending points of the gradient.
///
///
public RectangleF Rectangle
{
get { return _GetRectangle(); }
}
///
///
///
/// Gets or sets a value indicating whether
/// gamma correction is enabled for this .
///
///
public bool GammaCorrection
{
get {
bool useGammaCorrection;
int status = SafeNativeMethods.Gdip.GdipGetLineGammaCorrection(new HandleRef(this, this.NativeBrush),
out useGammaCorrection);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
return useGammaCorrection;
}
set {
int status = SafeNativeMethods.Gdip.GdipSetLineGammaCorrection(new HandleRef(this, this.NativeBrush),
value);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
}
/**
* Get/set blend factors
*
* @notes If the blendFactors.Length = 1, then it's treated
* as the falloff parameter. Otherwise, it's the array
* of blend factors.
*/
private Blend _GetBlend() {
// VSWHidbey 518309 - interpolation colors and blends don't get along. Just getting
// the Blend when InterpolationColors was set puts the Brush into an unusable state afterwards.
// so to avoid that (mostly the problem of having Blend pop up in the debugger window and cause this problem)
// we just bail here.
//
if (interpolationColorsWasSet) {
return null;
}
Blend blend;
// Figure out the size of blend factor array
int retval = 0;
int status = SafeNativeMethods.Gdip.GdipGetLineBlendCount(new HandleRef(this, this.NativeBrush), out retval);
if (status != SafeNativeMethods.Gdip.Ok) {
throw SafeNativeMethods.Gdip.StatusException(status);
}
if (retval <= 0) {
return null;
}
// Allocate temporary native memory buffer
int count = retval;
IntPtr factors = IntPtr.Zero;
IntPtr positions = IntPtr.Zero;
try {
factors = Marshal.AllocHGlobal(4*count);
positions = Marshal.AllocHGlobal(4*count);
// Retrieve horizontal blend factors
status = SafeNativeMethods.Gdip.GdipGetLineBlend(new HandleRef(this, this.NativeBrush), factors, positions, count);
if (status != SafeNativeMethods.Gdip.Ok) {
throw SafeNativeMethods.Gdip.StatusException(status);
}
// Return the result in a managed array
blend = new Blend(count);
Marshal.Copy(factors, blend.Factors, 0, count);
Marshal.Copy(positions, blend.Positions, 0, count);
}
finally {
if( factors != IntPtr.Zero ){
Marshal.FreeHGlobal(factors);
}
if( positions != IntPtr.Zero ){
Marshal.FreeHGlobal(positions);
}
}
return blend;
}
private void _SetBlend(Blend blend) {
// Allocate temporary native memory buffer
// and copy input blend factors into it.
int count = blend.Factors.Length;
IntPtr factors = IntPtr.Zero;
IntPtr positions = IntPtr.Zero;
try {
factors = Marshal.AllocHGlobal(4*count);
positions = Marshal.AllocHGlobal(4*count);
Marshal.Copy(blend.Factors, 0, factors, count);
Marshal.Copy(blend.Positions, 0, positions, count);
// Set blend factors
int status = SafeNativeMethods.Gdip.GdipSetLineBlend(new HandleRef(this, this.NativeBrush), new HandleRef(null, factors), new HandleRef(null, positions), count);
if (status != SafeNativeMethods.Gdip.Ok) {
throw SafeNativeMethods.Gdip.StatusException(status);
}
}
finally{
if( factors != IntPtr.Zero ) {
Marshal.FreeHGlobal(factors);
}
if( positions != IntPtr.Zero ) {
Marshal.FreeHGlobal(positions);
}
}
}
///
///
/// Gets or sets a that specifies
/// positions and factors that define a custom falloff for the gradient.
///
public Blend Blend
{
get { return _GetBlend();}
set { _SetBlend(value);}
}
/*
* SigmaBlend & LinearBlend not yet implemented
*/
///
///
/// Creates a gradient falloff based on a
/// bell-shaped curve.
///
public void SetSigmaBellShape(float focus)
{
SetSigmaBellShape(focus, (float)1.0);
}
///
///
/// Creates a gradient falloff based on a
/// bell-shaped curve.
///
public void SetSigmaBellShape(float focus, float scale)
{
int status = SafeNativeMethods.Gdip.GdipSetLineSigmaBlend(new HandleRef(this, this.NativeBrush), focus, scale);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
///
///
///
/// Creates a triangular gradient.
///
///
public void SetBlendTriangularShape(float focus)
{
SetBlendTriangularShape(focus, (float)1.0);
}
///
///
///
/// Creates a triangular gradient.
///
///
public void SetBlendTriangularShape(float focus, float scale)
{
int status = SafeNativeMethods.Gdip.GdipSetLineLinearBlend(new HandleRef(this, this.NativeBrush), focus, scale);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
/*
* Preset Color Blend
*/
private ColorBlend _GetInterpolationColors() {
ColorBlend blend;
if (!interpolationColorsWasSet) {
throw new ArgumentException(SR.GetString(SR.InterpolationColorsCommon,
SR.GetString(SR.InterpolationColorsColorBlendNotSet),""));
}
// Figure out the size of blend factor array
int retval = 0;
int status = SafeNativeMethods.Gdip.GdipGetLinePresetBlendCount(new HandleRef(this, this.NativeBrush), out retval);
if (status != SafeNativeMethods.Gdip.Ok) {
throw SafeNativeMethods.Gdip.StatusException(status);
}
// Allocate temporary native memory buffer
int count = retval;
IntPtr colors = IntPtr.Zero;
IntPtr positions = IntPtr.Zero;
try {
colors = Marshal.AllocHGlobal(4*count);
positions = Marshal.AllocHGlobal(4*count);
// Retrieve horizontal blend factors
status = SafeNativeMethods.Gdip.GdipGetLinePresetBlend(new HandleRef(this, this.NativeBrush), colors, positions, count);
if (status != SafeNativeMethods.Gdip.Ok) {
throw SafeNativeMethods.Gdip.StatusException(status);
}
// Return the result in a managed array
blend = new ColorBlend(count);
int[] argb = new int[count];
Marshal.Copy(colors, argb, 0, count);
Marshal.Copy(positions, blend.Positions, 0, count);
// copy ARGB values into Color array of ColorBlend
blend.Colors = new Color[argb.Length];
for (int i=0; i
///
///
/// Gets or sets a that defines a multi-color linear
/// gradient.
///
///
public ColorBlend InterpolationColors
{
get { return _GetInterpolationColors();}
set { _SetInterpolationColors(value);}
}
/**
* Set/get brush wrapping mode
*/
private void _SetWrapMode(WrapMode wrapMode) {
int status = SafeNativeMethods.Gdip.GdipSetLineWrapMode(new HandleRef(this, this.NativeBrush), (int) wrapMode);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
private WrapMode _GetWrapMode() {
int mode = 0;
int status = SafeNativeMethods.Gdip.GdipGetLineWrapMode(new HandleRef(this, this.NativeBrush), out mode);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
return (WrapMode) mode;
}
///
///
///
/// Gets or sets a that indicates the wrap mode for this .
///
///
public WrapMode WrapMode
{
get {
return _GetWrapMode();
}
set {
//validate the WrapMode enum
//valid values are 0x0 to 0x4
if (!ClientUtils.IsEnumValid(value, (int)value, (int)WrapMode.Tile, (int)WrapMode.Clamp))
{
throw new InvalidEnumArgumentException("value", (int)value, typeof(WrapMode));
}
_SetWrapMode(value);
}
}
/**
* Set/get brush transform
*/
private void _SetTransform(Matrix matrix) {
if (matrix == null)
throw new ArgumentNullException("matrix");
int status = SafeNativeMethods.Gdip.GdipSetLineTransform(new HandleRef(this, this.NativeBrush), new HandleRef(matrix, matrix.nativeMatrix));
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
private Matrix _GetTransform() {
Matrix matrix = new Matrix();
// NOTE: new Matrix() will throw an exception if matrix == null.
int status = SafeNativeMethods.Gdip.GdipGetLineTransform(new HandleRef(this, this.NativeBrush), new HandleRef(matrix, matrix.nativeMatrix));
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
return matrix;
}
///
///
///
/// Gets or sets a that defines a local geometrical transform for
/// this .
///
///
public Matrix Transform
{
get { return _GetTransform();}
set { _SetTransform(value);}
}
///
///
/// Resets the property to identity.
///
public void ResetTransform() {
int status = SafeNativeMethods.Gdip.GdipResetLineTransform(new HandleRef(this, this.NativeBrush));
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
///
///
///
/// Multiplies the that represents the local geometrical
/// transform of this by the specified by prepending the specified .
///
///
public void MultiplyTransform(Matrix matrix)
{
MultiplyTransform(matrix, MatrixOrder.Prepend);
}
///
///
///
/// Multiplies the that represents the local geometrical
/// transform of this by the specified in the specified order.
///
///
public void MultiplyTransform(Matrix matrix, MatrixOrder order)
{
if (matrix == null) {
throw new ArgumentNullException("matrix");
}
int status = SafeNativeMethods.Gdip.GdipMultiplyLineTransform(new HandleRef(this, this.NativeBrush),
new HandleRef(matrix, matrix.nativeMatrix),
order);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
///
///
/// Translates the local geometrical transform
/// by the specified dimmensions. This method prepends the translation to the
/// transform.
///
public void TranslateTransform(float dx, float dy)
{ TranslateTransform(dx, dy, MatrixOrder.Prepend); }
///
///
/// Translates the local geometrical transform
/// by the specified dimmensions in the specified order.
///
public void TranslateTransform(float dx, float dy, MatrixOrder order)
{
int status = SafeNativeMethods.Gdip.GdipTranslateLineTransform(new HandleRef(this, this.NativeBrush),
dx,
dy,
order);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
///
///
/// Scales the local geometric transform by the
/// specified amounts. This method prepends the scaling matrix to the transform.
///
public void ScaleTransform(float sx, float sy)
{ ScaleTransform(sx, sy, MatrixOrder.Prepend); }
///
///
///
/// Scales the local geometric transform by the
/// specified amounts in the specified order.
///
///
public void ScaleTransform(float sx, float sy, MatrixOrder order)
{
int status = SafeNativeMethods.Gdip.GdipScaleLineTransform(new HandleRef(this, this.NativeBrush),
sx,
sy,
order);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
///
///
/// Rotates the local geometric transform by the
/// specified amount. This method prepends the rotation to the transform.
///
public void RotateTransform(float angle)
{ RotateTransform(angle, MatrixOrder.Prepend); }
///
///
///
/// Rotates the local geometric transform by the specified
/// amount in the specified order.
///
///
public void RotateTransform(float angle, MatrixOrder order)
{
int status = SafeNativeMethods.Gdip.GdipRotateLineTransform(new HandleRef(this, this.NativeBrush),
angle,
order);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
}
}
// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
//------------------------------------------------------------------------------
//
// Copyright (c) Microsoft Corporation. All rights reserved.
//
//-----------------------------------------------------------------------------
namespace System.Drawing.Drawing2D {
using System.Diagnostics;
using System;
using System.ComponentModel;
using Microsoft.Win32;
using System.Runtime.InteropServices;
using System.Drawing;
using System.Drawing.Internal;
/**
* Represent a LinearGradient brush object
*/
///
///
///
/// Encapsulates a with a linear gradient.
///
///
public sealed class LinearGradientBrush : Brush {
private bool interpolationColorsWasSet;
/**
* Create a new rectangle gradient brush object
*/
///
///
/// Initializes a new instance of the class with the specified points and
/// colors.
///
public LinearGradientBrush(PointF point1, PointF point2,
Color color1, Color color2)
{
IntPtr brush = IntPtr.Zero;
int status = SafeNativeMethods.Gdip.GdipCreateLineBrush(new GPPOINTF(point1),
new GPPOINTF(point2),
color1.ToArgb(),
color2.ToArgb(),
(int)WrapMode.Tile,
out brush);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
SetNativeBrush(brush);
}
///
///
///
/// Initializes a new instance of the class with the
/// specified points and colors.
///
///
public LinearGradientBrush(Point point1, Point point2,
Color color1, Color color2)
{
IntPtr brush = IntPtr.Zero;
int status = SafeNativeMethods.Gdip.GdipCreateLineBrushI(new GPPOINT(point1),
new GPPOINT(point2),
color1.ToArgb(),
color2.ToArgb(),
(int)WrapMode.Tile,
out brush);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
SetNativeBrush(brush);
}
///
///
///
/// Encapsulates a new instance of the class with
/// the specified points, colors, and orientation.
///
///
public LinearGradientBrush(RectangleF rect, Color color1, Color color2,
LinearGradientMode linearGradientMode)
{
//validate the LinearGradientMode enum
//valid values are 0x0 to 0x3
if (!ClientUtils.IsEnumValid(linearGradientMode, (int)linearGradientMode, (int)LinearGradientMode.Horizontal, (int)LinearGradientMode.BackwardDiagonal)){
throw new InvalidEnumArgumentException("linearGradientMode", (int)linearGradientMode, typeof(LinearGradientMode));
}
//validate the rect
if (rect.Width == 0.0 || rect.Height == 0.0) {
throw new ArgumentException(SR.GetString(SR.GdiplusInvalidRectangle, rect.ToString()));
}
IntPtr brush = IntPtr.Zero;
GPRECTF gprectf = new GPRECTF(rect);
int status = SafeNativeMethods.Gdip.GdipCreateLineBrushFromRect(ref gprectf,
color1.ToArgb(),
color2.ToArgb(),
(int) linearGradientMode,
(int)WrapMode.Tile,
out brush);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
SetNativeBrush(brush);
}
///
///
///
/// Encapsulates a new instance of the class with the
/// specified points, colors, and orientation.
///
///
public LinearGradientBrush(Rectangle rect, Color color1, Color color2,
LinearGradientMode linearGradientMode)
{
//validate the LinearGradientMode enum
//valid values are 0x0 to 0x3
if (!ClientUtils.IsEnumValid(linearGradientMode, (int)linearGradientMode, (int)LinearGradientMode.Horizontal, (int)LinearGradientMode.BackwardDiagonal))
{
throw new InvalidEnumArgumentException("linearGradientMode", (int)linearGradientMode, typeof(LinearGradientMode));
}
//validate the rect
if (rect.Width == 0 || rect.Height == 0) {
throw new ArgumentException(SR.GetString(SR.GdiplusInvalidRectangle, rect.ToString()));
}
IntPtr brush = IntPtr.Zero;
GPRECT gpRect = new GPRECT(rect);
int status = SafeNativeMethods.Gdip.GdipCreateLineBrushFromRectI(ref gpRect,
color1.ToArgb(),
color2.ToArgb(),
(int) linearGradientMode,
(int)WrapMode.Tile,
out brush);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
SetNativeBrush(brush);
}
///
///
///
/// Encapsulates a new instance of the class with the
/// specified points, colors, and orientation.
///
///
public LinearGradientBrush(RectangleF rect, Color color1, Color color2,
float angle)
: this(rect, color1, color2, angle, false) {}
///
///
///
/// Encapsulates a new instance of the class with the
/// specified points, colors, and orientation.
///
///
public LinearGradientBrush(RectangleF rect, Color color1, Color color2,
float angle, bool isAngleScaleable)
{
IntPtr brush = IntPtr.Zero;
//validate the rect
if (rect.Width == 0.0 || rect.Height == 0.0) {
throw new ArgumentException(SR.GetString(SR.GdiplusInvalidRectangle, rect.ToString()));
}
GPRECTF gprectf = new GPRECTF(rect);
int status = SafeNativeMethods.Gdip.GdipCreateLineBrushFromRectWithAngle(ref gprectf,
color1.ToArgb(),
color2.ToArgb(),
angle,
isAngleScaleable,
(int)WrapMode.Tile,
out brush);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
SetNativeBrush(brush);
}
///
///
///
/// Encapsulates a new instance of the class with the
/// specified points, colors, and orientation.
///
///
public LinearGradientBrush(Rectangle rect, Color color1, Color color2,
float angle)
: this(rect, color1, color2, angle, false) {
}
///
///
///
/// Encapsulates a new instance of the class with the
/// specified points, colors, and orientation.
///
///
public LinearGradientBrush(Rectangle rect, Color color1, Color color2,
float angle, bool isAngleScaleable)
{
IntPtr brush = IntPtr.Zero;
//validate the rect
if (rect.Width == 0 || rect.Height == 0) {
throw new ArgumentException(SR.GetString(SR.GdiplusInvalidRectangle, rect.ToString()));
}
GPRECT gprect = new GPRECT(rect);
int status = SafeNativeMethods.Gdip.GdipCreateLineBrushFromRectWithAngleI(ref gprect,
color1.ToArgb(),
color2.ToArgb(),
angle,
isAngleScaleable,
(int)WrapMode.Tile,
out brush);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
SetNativeBrush(brush);
}
///
/// Constructor to initialized this object to be owned by GDI+.
///
internal LinearGradientBrush(IntPtr nativeBrush )
{
Debug.Assert( nativeBrush != IntPtr.Zero, "Initializing native brush with null." );
SetNativeBrush( nativeBrush );
}
///
///
/// Creates an exact copy of this .
///
public override object Clone() {
IntPtr cloneBrush = IntPtr.Zero;
int status = SafeNativeMethods.Gdip.GdipCloneBrush(new HandleRef(this, this.NativeBrush), out cloneBrush);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
return new LinearGradientBrush(cloneBrush);
}
/**
* Get/set colors
*/
private void _SetLinearColors(Color color1, Color color2)
{
int status = SafeNativeMethods.Gdip.GdipSetLineColors(new HandleRef(this, this.NativeBrush),
color1.ToArgb(),
color2.ToArgb());
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
private Color[] _GetLinearColors()
{
int[] colors =
new int[]
{
0,
0
};
int status = SafeNativeMethods.Gdip.GdipGetLineColors(new HandleRef(this, this.NativeBrush), colors);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
Color[] lineColor = new Color[2];
lineColor[0] = Color.FromArgb(colors[0]);
lineColor[1] = Color.FromArgb(colors[1]);
return lineColor;
}
///
///
/// Gets or sets the starting and ending colors of the
/// gradient.
///
public Color[] LinearColors
{
get { return _GetLinearColors();}
set { _SetLinearColors(value[0], value[1]);}
}
/**
* Get source rectangle
*/
private RectangleF _GetRectangle() {
GPRECTF rect = new GPRECTF();
int status = SafeNativeMethods.Gdip.GdipGetLineRect(new HandleRef(this, this.NativeBrush), ref rect);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
return rect.ToRectangleF();
}
///
///
///
/// Gets a rectangular region that defines the
/// starting and ending points of the gradient.
///
///
public RectangleF Rectangle
{
get { return _GetRectangle(); }
}
///
///
///
/// Gets or sets a value indicating whether
/// gamma correction is enabled for this .
///
///
public bool GammaCorrection
{
get {
bool useGammaCorrection;
int status = SafeNativeMethods.Gdip.GdipGetLineGammaCorrection(new HandleRef(this, this.NativeBrush),
out useGammaCorrection);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
return useGammaCorrection;
}
set {
int status = SafeNativeMethods.Gdip.GdipSetLineGammaCorrection(new HandleRef(this, this.NativeBrush),
value);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
}
/**
* Get/set blend factors
*
* @notes If the blendFactors.Length = 1, then it's treated
* as the falloff parameter. Otherwise, it's the array
* of blend factors.
*/
private Blend _GetBlend() {
// VSWHidbey 518309 - interpolation colors and blends don't get along. Just getting
// the Blend when InterpolationColors was set puts the Brush into an unusable state afterwards.
// so to avoid that (mostly the problem of having Blend pop up in the debugger window and cause this problem)
// we just bail here.
//
if (interpolationColorsWasSet) {
return null;
}
Blend blend;
// Figure out the size of blend factor array
int retval = 0;
int status = SafeNativeMethods.Gdip.GdipGetLineBlendCount(new HandleRef(this, this.NativeBrush), out retval);
if (status != SafeNativeMethods.Gdip.Ok) {
throw SafeNativeMethods.Gdip.StatusException(status);
}
if (retval <= 0) {
return null;
}
// Allocate temporary native memory buffer
int count = retval;
IntPtr factors = IntPtr.Zero;
IntPtr positions = IntPtr.Zero;
try {
factors = Marshal.AllocHGlobal(4*count);
positions = Marshal.AllocHGlobal(4*count);
// Retrieve horizontal blend factors
status = SafeNativeMethods.Gdip.GdipGetLineBlend(new HandleRef(this, this.NativeBrush), factors, positions, count);
if (status != SafeNativeMethods.Gdip.Ok) {
throw SafeNativeMethods.Gdip.StatusException(status);
}
// Return the result in a managed array
blend = new Blend(count);
Marshal.Copy(factors, blend.Factors, 0, count);
Marshal.Copy(positions, blend.Positions, 0, count);
}
finally {
if( factors != IntPtr.Zero ){
Marshal.FreeHGlobal(factors);
}
if( positions != IntPtr.Zero ){
Marshal.FreeHGlobal(positions);
}
}
return blend;
}
private void _SetBlend(Blend blend) {
// Allocate temporary native memory buffer
// and copy input blend factors into it.
int count = blend.Factors.Length;
IntPtr factors = IntPtr.Zero;
IntPtr positions = IntPtr.Zero;
try {
factors = Marshal.AllocHGlobal(4*count);
positions = Marshal.AllocHGlobal(4*count);
Marshal.Copy(blend.Factors, 0, factors, count);
Marshal.Copy(blend.Positions, 0, positions, count);
// Set blend factors
int status = SafeNativeMethods.Gdip.GdipSetLineBlend(new HandleRef(this, this.NativeBrush), new HandleRef(null, factors), new HandleRef(null, positions), count);
if (status != SafeNativeMethods.Gdip.Ok) {
throw SafeNativeMethods.Gdip.StatusException(status);
}
}
finally{
if( factors != IntPtr.Zero ) {
Marshal.FreeHGlobal(factors);
}
if( positions != IntPtr.Zero ) {
Marshal.FreeHGlobal(positions);
}
}
}
///
///
/// Gets or sets a that specifies
/// positions and factors that define a custom falloff for the gradient.
///
public Blend Blend
{
get { return _GetBlend();}
set { _SetBlend(value);}
}
/*
* SigmaBlend & LinearBlend not yet implemented
*/
///
///
/// Creates a gradient falloff based on a
/// bell-shaped curve.
///
public void SetSigmaBellShape(float focus)
{
SetSigmaBellShape(focus, (float)1.0);
}
///
///
/// Creates a gradient falloff based on a
/// bell-shaped curve.
///
public void SetSigmaBellShape(float focus, float scale)
{
int status = SafeNativeMethods.Gdip.GdipSetLineSigmaBlend(new HandleRef(this, this.NativeBrush), focus, scale);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
///
///
///
/// Creates a triangular gradient.
///
///
public void SetBlendTriangularShape(float focus)
{
SetBlendTriangularShape(focus, (float)1.0);
}
///
///
///
/// Creates a triangular gradient.
///
///
public void SetBlendTriangularShape(float focus, float scale)
{
int status = SafeNativeMethods.Gdip.GdipSetLineLinearBlend(new HandleRef(this, this.NativeBrush), focus, scale);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
/*
* Preset Color Blend
*/
private ColorBlend _GetInterpolationColors() {
ColorBlend blend;
if (!interpolationColorsWasSet) {
throw new ArgumentException(SR.GetString(SR.InterpolationColorsCommon,
SR.GetString(SR.InterpolationColorsColorBlendNotSet),""));
}
// Figure out the size of blend factor array
int retval = 0;
int status = SafeNativeMethods.Gdip.GdipGetLinePresetBlendCount(new HandleRef(this, this.NativeBrush), out retval);
if (status != SafeNativeMethods.Gdip.Ok) {
throw SafeNativeMethods.Gdip.StatusException(status);
}
// Allocate temporary native memory buffer
int count = retval;
IntPtr colors = IntPtr.Zero;
IntPtr positions = IntPtr.Zero;
try {
colors = Marshal.AllocHGlobal(4*count);
positions = Marshal.AllocHGlobal(4*count);
// Retrieve horizontal blend factors
status = SafeNativeMethods.Gdip.GdipGetLinePresetBlend(new HandleRef(this, this.NativeBrush), colors, positions, count);
if (status != SafeNativeMethods.Gdip.Ok) {
throw SafeNativeMethods.Gdip.StatusException(status);
}
// Return the result in a managed array
blend = new ColorBlend(count);
int[] argb = new int[count];
Marshal.Copy(colors, argb, 0, count);
Marshal.Copy(positions, blend.Positions, 0, count);
// copy ARGB values into Color array of ColorBlend
blend.Colors = new Color[argb.Length];
for (int i=0; i
///
///
/// Gets or sets a that defines a multi-color linear
/// gradient.
///
///
public ColorBlend InterpolationColors
{
get { return _GetInterpolationColors();}
set { _SetInterpolationColors(value);}
}
/**
* Set/get brush wrapping mode
*/
private void _SetWrapMode(WrapMode wrapMode) {
int status = SafeNativeMethods.Gdip.GdipSetLineWrapMode(new HandleRef(this, this.NativeBrush), (int) wrapMode);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
private WrapMode _GetWrapMode() {
int mode = 0;
int status = SafeNativeMethods.Gdip.GdipGetLineWrapMode(new HandleRef(this, this.NativeBrush), out mode);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
return (WrapMode) mode;
}
///
///
///
/// Gets or sets a that indicates the wrap mode for this .
///
///
public WrapMode WrapMode
{
get {
return _GetWrapMode();
}
set {
//validate the WrapMode enum
//valid values are 0x0 to 0x4
if (!ClientUtils.IsEnumValid(value, (int)value, (int)WrapMode.Tile, (int)WrapMode.Clamp))
{
throw new InvalidEnumArgumentException("value", (int)value, typeof(WrapMode));
}
_SetWrapMode(value);
}
}
/**
* Set/get brush transform
*/
private void _SetTransform(Matrix matrix) {
if (matrix == null)
throw new ArgumentNullException("matrix");
int status = SafeNativeMethods.Gdip.GdipSetLineTransform(new HandleRef(this, this.NativeBrush), new HandleRef(matrix, matrix.nativeMatrix));
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
private Matrix _GetTransform() {
Matrix matrix = new Matrix();
// NOTE: new Matrix() will throw an exception if matrix == null.
int status = SafeNativeMethods.Gdip.GdipGetLineTransform(new HandleRef(this, this.NativeBrush), new HandleRef(matrix, matrix.nativeMatrix));
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
return matrix;
}
///
///
///
/// Gets or sets a that defines a local geometrical transform for
/// this .
///
///
public Matrix Transform
{
get { return _GetTransform();}
set { _SetTransform(value);}
}
///
///
/// Resets the property to identity.
///
public void ResetTransform() {
int status = SafeNativeMethods.Gdip.GdipResetLineTransform(new HandleRef(this, this.NativeBrush));
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
///
///
///
/// Multiplies the that represents the local geometrical
/// transform of this by the specified by prepending the specified .
///
///
public void MultiplyTransform(Matrix matrix)
{
MultiplyTransform(matrix, MatrixOrder.Prepend);
}
///
///
///
/// Multiplies the that represents the local geometrical
/// transform of this by the specified in the specified order.
///
///
public void MultiplyTransform(Matrix matrix, MatrixOrder order)
{
if (matrix == null) {
throw new ArgumentNullException("matrix");
}
int status = SafeNativeMethods.Gdip.GdipMultiplyLineTransform(new HandleRef(this, this.NativeBrush),
new HandleRef(matrix, matrix.nativeMatrix),
order);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
///
///
/// Translates the local geometrical transform
/// by the specified dimmensions. This method prepends the translation to the
/// transform.
///
public void TranslateTransform(float dx, float dy)
{ TranslateTransform(dx, dy, MatrixOrder.Prepend); }
///
///
/// Translates the local geometrical transform
/// by the specified dimmensions in the specified order.
///
public void TranslateTransform(float dx, float dy, MatrixOrder order)
{
int status = SafeNativeMethods.Gdip.GdipTranslateLineTransform(new HandleRef(this, this.NativeBrush),
dx,
dy,
order);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
///
///
/// Scales the local geometric transform by the
/// specified amounts. This method prepends the scaling matrix to the transform.
///
public void ScaleTransform(float sx, float sy)
{ ScaleTransform(sx, sy, MatrixOrder.Prepend); }
///
///
///
/// Scales the local geometric transform by the
/// specified amounts in the specified order.
///
///
public void ScaleTransform(float sx, float sy, MatrixOrder order)
{
int status = SafeNativeMethods.Gdip.GdipScaleLineTransform(new HandleRef(this, this.NativeBrush),
sx,
sy,
order);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
///
///
/// Rotates the local geometric transform by the
/// specified amount. This method prepends the rotation to the transform.
///
public void RotateTransform(float angle)
{ RotateTransform(angle, MatrixOrder.Prepend); }
///
///
///
/// Rotates the local geometric transform by the specified
/// amount in the specified order.
///
///
public void RotateTransform(float angle, MatrixOrder order)
{
int status = SafeNativeMethods.Gdip.GdipRotateLineTransform(new HandleRef(this, this.NativeBrush),
angle,
order);
if (status != SafeNativeMethods.Gdip.Ok)
throw SafeNativeMethods.Gdip.StatusException(status);
}
}
}
// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
Link Menu

This book is available now!
Buy at Amazon US or
Buy at Amazon UK
- FlatButtonAppearance.cs
- ExtendedPropertiesHandler.cs
- CachedFontFace.cs
- TimelineGroup.cs
- FlatButtonAppearance.cs
- ellipse.cs
- AppendHelper.cs
- StyleModeStack.cs
- webeventbuffer.cs
- ProjectionRewriter.cs
- DES.cs
- TypeDependencyAttribute.cs
- XmlDocument.cs
- EnvelopedPkcs7.cs
- ToolStripDropDownButton.cs
- SqlCacheDependency.cs
- XmlSchemaComplexType.cs
- UserControlBuildProvider.cs
- DataViewManagerListItemTypeDescriptor.cs
- ProvidePropertyAttribute.cs
- DataServiceRequestArgs.cs
- LZCodec.cs
- SamlSubject.cs
- DataGridViewRowPostPaintEventArgs.cs
- configsystem.cs
- parserscommon.cs
- StorageSetMapping.cs
- ListCommandEventArgs.cs
- InputReport.cs
- XmlAnyElementAttributes.cs
- XslNumber.cs
- ProgressBarBrushConverter.cs
- SpAudioStreamWrapper.cs
- TypeValidationEventArgs.cs
- FacetValues.cs
- ServerValidateEventArgs.cs
- ToolStripArrowRenderEventArgs.cs
- _SSPISessionCache.cs
- HttpTransportElement.cs
- SerialStream.cs
- System.Data_BID.cs
- SqlServer2KCompatibilityCheck.cs
- OrderPreservingPipeliningSpoolingTask.cs
- SplitContainer.cs
- SessionStateSection.cs
- OletxDependentTransaction.cs
- DynamicValidatorEventArgs.cs
- CacheVirtualItemsEvent.cs
- GroupBox.cs
- Attributes.cs
- ObfuscationAttribute.cs
- WorkflowOwnershipException.cs
- EncryptedHeaderXml.cs
- PropertySegmentSerializationProvider.cs
- Base64Encoder.cs
- PropertyItem.cs
- SqlCachedBuffer.cs
- GeometryCombineModeValidation.cs
- StreamWithDictionary.cs
- CopyAttributesAction.cs
- SymbolType.cs
- XhtmlTextWriter.cs
- ExtensionCollection.cs
- ColumnMapCopier.cs
- SevenBitStream.cs
- ProtocolsConfigurationEntry.cs
- ListViewSortEventArgs.cs
- StatusBarPanel.cs
- TargetParameterCountException.cs
- SafeRightsManagementPubHandle.cs
- FlowDocumentPage.cs
- Wizard.cs
- PrintPreviewControl.cs
- RawKeyboardInputReport.cs
- FigureHelper.cs
- HttpCacheVaryByContentEncodings.cs
- SQLDateTimeStorage.cs
- WindowsIdentity.cs
- Icon.cs
- RoleManagerModule.cs
- WebPartConnectionsEventArgs.cs
- Visual3D.cs
- CodeAccessSecurityEngine.cs
- SystemTcpStatistics.cs
- ObjectListDesigner.cs
- SQLByteStorage.cs
- CacheMode.cs
- OleDbPropertySetGuid.cs
- ParameterCollection.cs
- WCFBuildProvider.cs
- SystemThemeKey.cs
- GridViewColumnCollectionChangedEventArgs.cs
- SourceInterpreter.cs
- MetadataCollection.cs
- BrowserDefinitionCollection.cs
- OdbcRowUpdatingEvent.cs
- EventProperty.cs
- WebPartsPersonalizationAuthorization.cs
- PointAnimationUsingKeyFrames.cs
- BindingMemberInfo.cs