Метод PathGradientBrush::RotateTransform (gdipluspath.h)
Метод PathGradientBrush::RotateTransform обновляет текущую матрицу преобразования этой кисти с помощью собственного произведения и матрицы поворота.
Синтаксис
Status RotateTransform(
[in] REAL angle,
[in] MatrixOrder order
);
Параметры
[in] angle
Тип: REAL
Вещественное число, указывающее угол поворота в градусах.
[in] order
Тип: MatrixOrder
Необязательный элемент. Элемент перечисления MatrixOrder , указывающий порядок умножения. MatrixOrderPrepend указывает, что матрица поворота находится слева, а MatrixOrderAppend указывает, что матрица поворота находится справа. Значение по умолчанию — MatrixOrderPrepend.
Возвращаемое значение
Тип: Состояние
В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .
Если метод завершается ошибкой, он возвращает один из других элементов перечисления Status .
Комментарии
В одной матрице из 3 ×3 может храниться любая последовательность аффинных преобразований. При наличии нескольких трех матриц ×3, каждая из которых представляет аффинное преобразование, произведением этих матриц будет одна матрица из 3 ×3, представляющая всю последовательность преобразований. Преобразование, представленное этим продуктом, называется составным преобразованием. Например, предположим, что матрица T представляет преобразование, а матрица R — поворот. Если матрица M является TR продукта, то матрица M представляет составное преобразование: сначала перевести, а затем повернуть.
Примеры
В следующем примере создается объект PathGradientBrush на основе треугольного пути. Вызовы методов PathGradientBrush::ScaleTransform и PathGradientBrush::RotateTransform объекта PathGradientBrush задают элементы матрицы преобразования кисти, чтобы она представляла составное преобразование: сначала масштаб, а затем поворот. Код использует кисть градиента пути дважды, чтобы закрасить прямоугольник: один раз до задания преобразования и один раз после задания преобразования.
VOID Example_RotateTransform(HDC hdc)
{
Graphics graphics(hdc);
// Create a path gradient brush based on an array of points.
Point pts[] = {Point(0, 0), Point(50, 0), Point(50, 50)};
PathGradientBrush pthGrBrush(pts, 3);
// Fill an area with the path gradient brush (no transformation).
graphics.FillRectangle(&pthGrBrush, 0, 0, 500, 500);
pthGrBrush.ScaleTransform(3.0f, 1.0f); // first scale
pthGrBrush.RotateTransform(60.0f, MatrixOrderAppend); // then rotate
// Fill the same area with the transformed path gradient brush.
graphics.FillRectangle(&pthGrBrush, 0, 0, 500, 500);
}
Требования
Минимальная версия клиента | Windows XP, Windows 2000 Профессиональная [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | gdipluspath.h (включая Gdiplus.h) |
Библиотека | Gdiplus.lib |
DLL | Gdiplus.dll |
См. также раздел
Заполнение фигуры цветным градиентом
Матричное представление преобразований
PathGradientBrush::GetTransform
PathGradientBrush::MultiplyTransform
PathGradientBrush::ResetTransform
PathGradientBrush::ScaleTransform
PathGradientBrush::SetTransform