Метод LinearGradientBrush::SetWrapMode (gdiplusbrush.h)
Метод LinearGradientBrush::SetWrapMode задает режим оболочки для этой кисти линейного градиента.
Синтаксис
Status SetWrapMode(
[in] WrapMode wrapMode
);
Параметры
[in] wrapMode
Тип: WrapMode
Элемент перечисления WrapMode , указывающий, каким образом области, окрашенные с помощью этой кисти линейного градиента, будут мозаичны. Значение этого параметра должно быть одним из следующих элементов:
- WrapModeTile
- WrapModeTileFlipX
- WrapModeTileFlipY
- WrapModeTileFlipXY
Возвращаемое значение
Тип: Состояние
В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .
Если метод завершается ошибкой, он возвращает один из других элементов перечисления Status .
Комментарии
Линии границ линейной кисти градиента образуют плитку. При рисовании области с помощью кисти линейного градиента плитка повторяется. Кисть линейного градиента может иметь альтернативные плитки, перевернутые в определенном направлении, как указано в режиме переноса. При переворачивании происходит обратный порядок цветов.
Режим оболочки по умолчанию имеет значение WrapModeTile при построении объекта LinearGradientBrush .
Примеры
В следующем примере создается линейная кисть градиента и она используется для заполнения прямоугольника. Затем код изменяет режим переноса кисти и использует измененную кисть для заполнения другого прямоугольника.
VOID Example_SetWrapMode(HDC hdc)
{
Graphics myGraphics(hdc);
LinearGradientBrush linGrBrush(
Rect(0, 0, 100, 50),
Color(255, 255, 0, 0), // red
Color(255, 0, 0, 255), // blue
LinearGradientModeHorizontal);
// Fill a large area using the gradient brush with the default wrap mode.
myGraphics.FillRectangle(&linGrBrush, 0, 0, 800, 50);
linGrBrush.SetWrapMode(WrapModeTileFlipX);
// Fill a large area using the gradient brush with the new wrap mode.
myGraphics.FillRectangle(&linGrBrush, 0, 75, 800, 50);
}
Требования
Минимальная версия клиента | Windows XP, Windows 2000 Профессиональная [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | gdiplusbrush.h (включая Gdiplus.h) |
Библиотека | Gdiplus.lib |
DLL | Gdiplus.dll |
См. также раздел
LinearGradientBrush::GetWrapMode