Метод Region::Translate(REAL,REAL) (gdiplusheaders.h)

Статья
08/24/2023

Метод Region::Translate смещает эту область заданными значениями в горизонтальном и вертикальном направлениях.

Синтаксис

Status Translate(
  REAL dx,
  REAL dy
);

Параметры

dx

Целое число, указывающее величину смещения области в направлении x.

dy

Целое число, указывающее величину смещения области в направлении y.

Возвращаемое значение

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

Remarks

Примеры

В следующем примере создается область из пути и выполняется ее заполнение. Затем код преобразует регион и заполняет преобразованную область, чтобы показать, как регион сместился.

VOID Example_Translate(HDC hdc)
{
   Graphics graphics(hdc);

   Point points[] = {
      Point(110, 20),
      Point(120, 30),
      Point(100, 60),
      Point(120, 70),
      Point(150, 60),
      Point(140, 10)};

   GraphicsPath path;
   SolidBrush solidBrush(Color(255, 255, 0, 0));

   path.AddClosedCurve(points, 6);

   // Create a region from a path.
   Region pathRegion(&path);
   graphics.FillRegion(&solidBrush, &pathRegion);

   // Translate the region.
   INT dx = 100;
   INT dy = 60;
   pathRegion.Translate(dx, dy);
   graphics.FillRegion(&solidBrush, &pathRegion);
}