Rect Rect Rect Rect Struct

Определение

Описывает ширину, высоту и расположение прямоугольника.Describes the width, height, and location of a rectangle.

public value class Rect : IFormattable
[System.ComponentModel.TypeConverter(typeof(System.Windows.RectConverter))]
[System.Serializable]
public struct Rect : IFormattable
type Rect = struct
    interface IFormattable
Public Structure Rect
Implements IFormattable
Наследование
Атрибуты
Реализации

Примеры

В следующем примере показано, как использовать Rect структуры, чтобы указать размеры и расположение прямоугольника с помощью XAML.The following example shows how to use a Rect structure to specify the dimensions and location of a rectangle using XAML.

using System;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;
using System.Windows.Shapes;

namespace SDKSample
{
    public partial class RectExample : Page
    {
        public RectExample()
        {   
            Path myPath1 = new Path();
            myPath1.Stroke = Brushes.Black;
            myPath1.StrokeThickness = 1;
            SolidColorBrush mySolidColorBrush = new SolidColorBrush();
            mySolidColorBrush.Color = Color.FromArgb(255, 204, 204, 255);
            myPath1.Fill = mySolidColorBrush;

            // Create the rectangle.
            // This RectangleGeometry specifies a rectangle that is 100 pixels high and
            // 150 wide. The left side of the rectangle is 10 pixels from the left of the 
            // Canvas and the top side of the rectangle is 100 pixels from the top of the Canvas.  
            // Note: You could alternatively use the Rect Constructor to create this:
            // Rect my Rect1 = new Rect(10,100,150,100");
            Rect myRect1 = new Rect();
            myRect1.X = 10;
            myRect1.Y = 100;
            myRect1.Width = 150;
            myRect1.Height = 100;
            RectangleGeometry myRectangleGeometry1 = new RectangleGeometry();
            myRectangleGeometry1.Rect = myRect1;

            GeometryGroup myGeometryGroup1 = new GeometryGroup();
            myGeometryGroup1.Children.Add(myRectangleGeometry1);

            myPath1.Data = myGeometryGroup1;

            Path myPath2 = new Path();
            myPath2.Stroke = Brushes.Black;
            myPath2.StrokeThickness = 1;
            myPath2.Fill = mySolidColorBrush;

            // Create the rectangle.
            // This Rect uses the Size property to specify a height of 50 and width
            // of 200. The Location property uses a Point value to determine the location of the
            // top-left corner of the rectangle.
            Rect myRect2 = new Rect();
            myRect2.Size = new Size(50, 200);
            myRect2.Location = new Point(300, 100);
            RectangleGeometry myRectangleGeometry2 = new RectangleGeometry();
            myRectangleGeometry2.Rect = myRect2;

            GeometryGroup myGeometryGroup2 = new GeometryGroup();
            myGeometryGroup2.Children.Add(myRectangleGeometry2);

            myPath2.Data = myGeometryGroup2;

            // Add path shape to the UI.
            Canvas myCanvas = new Canvas();
            myCanvas.Children.Add(myPath1);
            myCanvas.Children.Add(myPath2);
            this.Content = myCanvas;       
        }
    }

}

Imports System
Imports System.Windows
Imports System.Windows.Controls
Imports System.Windows.Media
Imports System.Windows.Shapes

Namespace SDKSample
	Partial Public Class RectExample
		Inherits Page
		Public Sub New()
			Dim myPath1 As New Path()
			myPath1.Stroke = Brushes.Black
			myPath1.StrokeThickness = 1
			Dim mySolidColorBrush As New SolidColorBrush()
			mySolidColorBrush.Color = Color.FromArgb(255, 204, 204, 255)
			myPath1.Fill = mySolidColorBrush

			' Create the rectangle.
			' This RectangleGeometry specifies a rectangle that is 100 pixels high and
			' 150 wide. The left side of the rectangle is 10 pixels from the left of the 
			' Canvas and the top side of the rectangle is 100 pixels from the top of the Canvas.  
			' Note: You could alternatively use the Rect Constructor to create this:
			' Dim myRect1 As New Rect(10,100,150,100")
			Dim myRect1 As New Rect()
			myRect1.X = 10
			myRect1.Y = 100
			myRect1.Width = 150
			myRect1.Height = 100
			Dim myRectangleGeometry1 As New RectangleGeometry()
			myRectangleGeometry1.Rect = myRect1

			Dim myGeometryGroup1 As New GeometryGroup()
			myGeometryGroup1.Children.Add(myRectangleGeometry1)

			myPath1.Data = myGeometryGroup1

			Dim myPath2 As New Path()
			myPath2.Stroke = Brushes.Black
			myPath2.StrokeThickness = 1
			myPath2.Fill = mySolidColorBrush

			' Create the rectangle.
			' This Rect uses the Size property to specify a height of 50 and width
			' of 200. The Location property uses a Point value to determine the location of the
			' top-left corner of the rectangle.
			Dim myRect2 As New Rect()
			myRect2.Size = New Size(50, 200)
			myRect2.Location = New Point(300, 100)
			Dim myRectangleGeometry2 As New RectangleGeometry()
			myRectangleGeometry2.Rect = myRect2

			Dim myGeometryGroup2 As New GeometryGroup()
			myGeometryGroup2.Children.Add(myRectangleGeometry2)

			myPath2.Data = myGeometryGroup2

			' Add path shape to the UI.
			Dim myCanvas As New Canvas()
			myCanvas.Children.Add(myPath1)
			myCanvas.Children.Add(myPath2)
			Me.Content = myCanvas
		End Sub
	End Class

End Namespace
<Page  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
  <Canvas>
    
    <!-- This rectangle demonstrates using the X, Y, Width, and Height properties
         of a Rect object. -->
    <Path Stroke="Black" StrokeThickness="1" Fill="LemonChiffon">
      <Path.Data>

        <!-- This RectangleGeometry specifies a rectangle that is 100 pixels high and
             150 wide. The left side of the rectangle is 10 pixels from the left of the 
             Canvas and the top side of the rectangle is 100 pixels from the top of the Canvas.  
             Note: An abbreviated syntax for creating an equivalent rectangle is:
             <RectangleGeometry Rect="10,100,150,100" /> -->
        <RectangleGeometry>
          <RectangleGeometry.Rect>
            <Rect X="10" Y="100" Width="150" Height="100" />
          </RectangleGeometry.Rect>
        </RectangleGeometry>
      </Path.Data>
    </Path>

    <!-- This rectangle demonstrates using the Size and Location properties of a Rect object. -->
    <Path Stroke="Black" StrokeThickness="1" Fill="LemonChiffon">
      <Path.Data>

        <!-- This RectangleGeometry uses the Size property to specify a height of 50 and width
             of 200. The Location property uses a Point value to determine the location of the
             top-left corner of the rectangle. /> -->
        <RectangleGeometry>
          <RectangleGeometry.Rect>
            <Rect Size="50,200" Location="300,100" />
          </RectangleGeometry.Rect>
        </RectangleGeometry>
      </Path.Data>
    </Path>
  </Canvas>
</Page>

Приведенный ниже показано, как использовать код, чтобы создать прямоугольник и добавить его на страницу.The following example shows how to use code to create a rectangle and add it to the page. В примере также показано, как размер и координата сведения о нового прямоугольника и вывести ее в TextBox под прямоугольником.The example also illustrates how to find size and coordinate information about the new rectangle and render the information in a TextBox below the rectangle.

// Create a rectangle and add it to the page. Also,
// find size and coordinate information about this
// new rectangle and render information in a TextBox 
// below the rectangle.
private StackPanel createRectExample1()
{
    // Initialize new rectangle.
    Rect myRectangle = new Rect();

    // The Location property specifies the coordinates of the upper left-hand 
    // corner of the rectangle. Set the Location property to an X coordinate of 10 and a
    // Y coordinate of 5. 
    myRectangle.Location = new Point(10, 5);

    // Set the Size property of the rectangle with a width of 200
    // and a height of 50.
    myRectangle.Size = new Size(200, 50);

    RectangleGeometry myRectangleGeometry = new RectangleGeometry();
    myRectangleGeometry.Rect = myRectangle;

    // This path is defined by the rectangle.
    Path myPath = new Path();
    myPath.Fill = Brushes.LemonChiffon;
    myPath.Stroke = Brushes.Black;
    myPath.StrokeThickness = 1;
    myPath.Data = myRectangleGeometry;

    //////////// Create string of rectangle property information /////////////
    // This string will contain all the size and coordinate property
    // information about the rectangle.
    /////////////////////////////////////////////////////////////////////////
    string rectInfo = "Rectangle Property Information: ";

    // Bottom property gets the y-axis value of the bottom of the rectangle. 
    // For this rectangle the value is 55.
    rectInfo = rectInfo + "Bottom: " + myRectangle.Bottom;

    // BottomLeft property gets the coordinates of the bottom left corner of the rectangle. 
    // For this rectangle the value is 10,55.
    rectInfo = rectInfo + "| BottomLeft: " + myRectangle.BottomLeft;

    // BottomRight property gets the coordinates of the bottom right corner of the rectangle. 
    // For this rectangle the value is 210,55.
    rectInfo = rectInfo + "| BottomRight: " + myRectangle.BottomRight;

    // Height property gets or sets the height of the rectangle. 
    // For this rectangle the value is 50.
    rectInfo = rectInfo + "| Height: " + myRectangle.Height;

    // Width property gets or sets the width of the rectangle. 
    // For this rectangle the value is 200.
    rectInfo = rectInfo + "| Width: " + myRectangle.Width;

    // Left property gets the x-axis position of the left side of the rectangle which is 
    // equivalent to getting the rectangle's X property. 
    // For this rectangle the value is 10.
    rectInfo = rectInfo + "| Left: " + myRectangle.Left;

    // Location property gets or sets the position of the rectangle's top-left corner.
    // For this rectangle the value is 10,5.
    rectInfo = rectInfo + "| Location: " + myRectangle.Location;

    // Right property gets the x-axis value of the right side of the rectangle. 
    // For this rectangle the value is 210.
    rectInfo = rectInfo + "| Right: " + myRectangle.Right;

    // Size property gets or sets the width and height of the rectangle.  
    // For this rectangle the value is 200,50.
    rectInfo = rectInfo + "| Size: " + myRectangle.Size;

    // Top property gets the y-axis position of the top of the rectangle which is 
    // equivalent to getting the rectangle's Y property.
    // For this rectangle the value is 5.
    rectInfo = rectInfo + "| Top: " + myRectangle.Top;

    // TopLeft property gets the position of the top-left corner of the rectangle, which 
    // is equivalent to (X, Y).   
    // For this rectangle the value is 10,5.
    rectInfo = rectInfo + "| TopLeft: " + myRectangle.TopLeft;

    // TopRight property gets the position of the top-left corner of the rectangle, which 
    // is equivalent to (X + Width, Y).   
    // For this rectangle the value is 210,5.
    rectInfo = rectInfo + "| TopRight: " + myRectangle.TopRight;

    // X property gets or sets the location of the rectangle's left side.  
    // For this rectangle the value is 10.
    rectInfo = rectInfo + "| X: " + myRectangle.X;

    // Y property gets or sets the location of the rectangle's top side.  
    // For this rectangle the value is 5.
    rectInfo = rectInfo + "| Y: " + myRectangle.Y;

    //////// End of creating string containing rectangle property information ////////

    // This StackPanel will contain the rectangle and TextBlock.
    StackPanel parentPanel = new StackPanel();

    // Add the rectangle path to the StackPanel. This will display the rectangle.
    parentPanel.Children.Add(myPath);

    // Add a TextBlock to display the rectangle's size and coordinate information.
    TextBlock myTextBlock = new TextBlock();
    myTextBlock.Text = rectInfo;
    parentPanel.Children.Add(myTextBlock);

    // Return the parent container to be displayed to the screen.
    return parentPanel;
}

Комментарии

Использование атрибута XAMLXAML Attribute Usage

<object property="x,y,width,height"/>  

Значения XAMLXAML Values

xx
System.Double

Расположение координату x левой стороны прямоугольника.The x-coordinate location of the left side of the rectangle.

yy
System.Double

Расположение координату по оси y верхней стороны прямоугольника.The y-coordinate location of the top side of the rectangle.

widthwidth
System.Double

Неотрицательное значение, представляющее Width прямоугольника.A non-negative value that represents the Width of the rectangle.

Высотаheight
System.Double

Неотрицательное значение, представляющее Height прямоугольника.A non-negative value that represents the Height of the rectangle.

Конструкторы

Rect(Size) Rect(Size) Rect(Size) Rect(Size)

Инициализирует новый экземпляр структуры Rect, которая имеет указанный размер и расположена в точке с координатами (0,0).Initializes a new instance of the Rect structure that is of the specified size and is located at (0,0).

Rect(Point, Point) Rect(Point, Point) Rect(Point, Point) Rect(Point, Point)

Инициализирует новый экземпляр структуры Rect, которая достаточна велика, чтобы включать две указанных точки.Initializes a new instance of the Rect structure that is exactly large enough to contain the two specified points.

Rect(Point, Size) Rect(Point, Size) Rect(Point, Size) Rect(Point, Size)

Инициализирует новый экземпляр структуры Rect, которая имеет указанное расположение верхнего левого угла и указанные ширину и высоту.Initializes a new instance of the Rect structure that has the specified top-left corner location and the specified width and height.

Rect(Point, Vector) Rect(Point, Vector) Rect(Point, Vector) Rect(Point, Vector)

Инициализирует новый экземпляр структуры Rect, которая достаточно велика, чтобы включать указанную точку и сумму указанной точки и указанного вектора.Initializes a new instance of the Rect structure that is exactly large enough to contain the specified point and the sum of the specified point and the specified vector.

Rect(Double, Double, Double, Double) Rect(Double, Double, Double, Double) Rect(Double, Double, Double, Double) Rect(Double, Double, Double, Double)

Инициализирует новый экземпляр структуры Rect, которая имеет указанные координаты по оси Х и Y, а также ширину и высоту.Initializes a new instance of the Rect structure that has the specified x-coordinate, y-coordinate, width, and height.

Свойства

Bottom Bottom Bottom Bottom

Возвращает координату по оси Y нижней стороны прямоугольника.Gets the y-axis value of the bottom of the rectangle.

BottomLeft BottomLeft BottomLeft BottomLeft

Возвращает расположение левого нижнего угла прямоугольника.Gets the position of the bottom-left corner of the rectangle

BottomRight BottomRight BottomRight BottomRight

Возвращает расположение правого нижнего угла прямоугольника.Gets the position of the bottom-right corner of the rectangle.

Empty Empty Empty Empty

Возвращает специальное значение, которое представляет прямоугольник без расположения или области.Gets a special value that represents a rectangle with no position or area.

Height Height Height Height

Возвращает или задает высоту прямоугольника.Gets or sets the height of the rectangle.

IsEmpty IsEmpty IsEmpty IsEmpty

Возвращает значение, которое показывает является ли прямоугольник Empty.Gets a value that indicates whether the rectangle is the Empty rectangle.

Left Left Left Left

Возвращает координату по оси X левой стороны прямоугольника.Gets the x-axis value of the left side of the rectangle.

Location Location Location Location

Получает или задает расположение верхнего левого угла прямоугольника.Gets or sets the position of the top-left corner of the rectangle.

Right Right Right Right

Возвращает координату по оси X правой стороны прямоугольника.Gets the x-axis value of the right side of the rectangle.

Size Size Size Size

Получает или задает ширину и высоту прямоугольника.Gets or sets the width and height of the rectangle.

Top Top Top Top

Возвращает координату по оси Y верхней стороны прямоугольника.Gets the y-axis position of the top of the rectangle.

TopLeft TopLeft TopLeft TopLeft

Возвращает расположение верхнего левого угла прямоугольника.Gets the position of the top-left corner of the rectangle.

TopRight TopRight TopRight TopRight

Возвращает расположение верхнего правого угла прямоугольника.Gets the position of the top-right corner of the rectangle.

Width Width Width Width

Получает или задает ширину прямоугольника.Gets or sets the width of the rectangle.

X X X X

Получает или задает координату по оси X левой стороны прямоугольника.Gets or sets the x-axis value of the left side of the rectangle.

Y Y Y Y

Получает или задает координату по оси Y верхней стороны прямоугольника.Gets or sets the y-axis value of the top side of the rectangle.

Методы

Contains(Point) Contains(Point) Contains(Point) Contains(Point)

Определяет, включает ли прямоугольник указанную точку.Indicates whether the rectangle contains the specified point.

Contains(Rect) Contains(Rect) Contains(Rect) Contains(Rect)

Определяет, включает ли прямоугольник указанный прямоугольник.Indicates whether the rectangle contains the specified rectangle.

Contains(Double, Double) Contains(Double, Double) Contains(Double, Double) Contains(Double, Double)

Показывает, включает ли прямоугольник указанную координату по оси X и Y.Indicates whether the rectangle contains the specified x-coordinate and y-coordinate.

Equals(Rect, Rect) Equals(Rect, Rect) Equals(Rect, Rect) Equals(Rect, Rect)

Показывает, являются ли указанные прямоугольники равными.Indicates whether the specified rectangles are equal.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Показывает, равен ли указанный объект текущему прямоугольнику.Indicates whether the specified object is equal to the current rectangle.

Equals(Rect) Equals(Rect) Equals(Rect) Equals(Rect)

Показывает, равен ли указанный прямоугольник текущему прямоугольнику.Indicates whether the specified rectangle is equal to the current rectangle.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Создает хэш-код для прямоугольника.Creates a hash code for the rectangle.

Inflate(Size) Inflate(Size) Inflate(Size) Inflate(Size)

Расширяет прямоугольник во всех направлениях с использованием указанного значения Size.Expands the rectangle by using the specified Size, in all directions.

Inflate(Double, Double) Inflate(Double, Double) Inflate(Double, Double) Inflate(Double, Double)

Увеличивает или уменьшает прямоугольник по всем направлениям с использованием указанных значений ширины и высоты.Expands or shrinks the rectangle by using the specified width and height amounts, in all directions.

Inflate(Rect, Size) Inflate(Rect, Size) Inflate(Rect, Size) Inflate(Rect, Size)

Возвращает прямоугольник, который получается в результате увеличения данного прямоугольника с указанным коэффициентом Size по всем направлениям.Returns the rectangle that results from expanding the specified rectangle by the specified Size, in all directions.

Inflate(Rect, Double, Double) Inflate(Rect, Double, Double) Inflate(Rect, Double, Double) Inflate(Rect, Double, Double)

Создает прямоугольник, который получается в результате увеличения или уменьшения данного прямоугольника с указанным изменением ширины и высоты по всем направлениям.Creates a rectangle that results from expanding or shrinking the specified rectangle by the specified width and height amounts, in all directions.

Intersect(Rect) Intersect(Rect) Intersect(Rect) Intersect(Rect)

Находит пересечение текущего прямоугольника и указанного прямоугольника и сохраняет результат как текущий прямоугольник.Finds the intersection of the current rectangle and the specified rectangle, and stores the result as the current rectangle.

Intersect(Rect, Rect) Intersect(Rect, Rect) Intersect(Rect, Rect) Intersect(Rect, Rect)

Возвращает пересечение указанных прямоугольников.Returns the intersection of the specified rectangles.

IntersectsWith(Rect) IntersectsWith(Rect) IntersectsWith(Rect) IntersectsWith(Rect)

Показывает, пересекается ли указанный прямоугольник с текущим прямоугольником.Indicates whether the specified rectangle intersects with the current rectangle.

Offset(Vector) Offset(Vector) Offset(Vector) Offset(Vector)

Перемещает прямоугольник по указанному вектору.Moves the rectangle by the specified vector.

Offset(Double, Double) Offset(Double, Double) Offset(Double, Double) Offset(Double, Double)

Перемещает прямоугольник на указанную величину по горизонтали и вертикали.Moves the rectangle by the specified horizontal and vertical amounts.

Offset(Rect, Vector) Offset(Rect, Vector) Offset(Rect, Vector) Offset(Rect, Vector)

Возвращает прямоугольник, который получается в результате смещения указанного прямоугольника по заданному вектору.Returns a rectangle that is offset from the specified rectangle by using the specified vector.

Offset(Rect, Double, Double) Offset(Rect, Double, Double) Offset(Rect, Double, Double) Offset(Rect, Double, Double)

Возвращает прямоугольник, который получается в результате смещения указанного прямоугольника на заданные значения по горизонтали и вертикали.Returns a rectangle that is offset from the specified rectangle by using the specified horizontal and vertical amounts.

Parse(String) Parse(String) Parse(String) Parse(String)

Создает новый прямоугольник из заданного строкового представления.Creates a new rectangle from the specified string representation.

Scale(Double, Double) Scale(Double, Double) Scale(Double, Double) Scale(Double, Double)

Умножает размер текущего прямоугольника на указанные значения x и y.Multiplies the size of the current rectangle by the specified x and y values.

ToString() ToString() ToString() ToString()

Возвращает строковое представление прямоугольника.Returns a string representation of the rectangle.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Возвращает строковое представление прямоугольника с использованием указанного поставщика формата.Returns a string representation of the rectangle by using the specified format provider.

Transform(Matrix) Transform(Matrix) Transform(Matrix) Transform(Matrix)

Преобразовывает прямоугольник с использованием заданной матрицы.Transforms the rectangle by applying the specified matrix.

Transform(Rect, Matrix) Transform(Rect, Matrix) Transform(Rect, Matrix) Transform(Rect, Matrix)

Возвращает прямоугольник, который получается в результате применения указанной матрицы к заданному прямоугольнику.Returns the rectangle that results from applying the specified matrix to the specified rectangle.

Union(Point) Union(Point) Union(Point) Union(Point)

Увеличивает текущий прямоугольник на величину, достаточную, чтобы включить указанную точку.Expands the current rectangle exactly enough to contain the specified point.

Union(Rect) Union(Rect) Union(Rect) Union(Rect)

Увеличивает текущий прямоугольник на величину, достаточную, чтобы включить указанный прямоугольник.Expands the current rectangle exactly enough to contain the specified rectangle.

Union(Rect, Point) Union(Rect, Point) Union(Rect, Point) Union(Rect, Point)

Создает прямоугольник, который достаточно большой, чтобы включить указанный прямоугольник и указанную точку.Creates a rectangle that is exactly large enough to include the specified rectangle and the specified point.

Union(Rect, Rect) Union(Rect, Rect) Union(Rect, Rect) Union(Rect, Rect)

Создает прямоугольник, который достаточно большой, чтобы включить два указанных прямоугольника.Creates a rectangle that is exactly large enough to contain the two specified rectangles.

Операторы

Equality(Rect, Rect) Equality(Rect, Rect) Equality(Rect, Rect) Equality(Rect, Rect)

Проверяет точное равенство двух прямоугольников.Compares two rectangles for exact equality.

Inequality(Rect, Rect) Inequality(Rect, Rect) Inequality(Rect, Rect) Inequality(Rect, Rect)

Проверяет, различны ли два прямоугольника.Compares two rectangles for inequality.

Явные реализации интерфейса

IFormattable.ToString(String, IFormatProvider) IFormattable.ToString(String, IFormatProvider) IFormattable.ToString(String, IFormatProvider) IFormattable.ToString(String, IFormatProvider)

Форматирует значение текущего экземпляра, используя указанный формат.Formats the value of the current instance using the specified format.

Применяется к