Rect Struktura

Definice

Obor názvů:

System.Windows

Sestavení:

WindowsBase.dll

Popisuje šířku, výšku a umístění obdélníku.

public value class Rect : IFormattable

[System.ComponentModel.TypeConverter(typeof(System.Windows.RectConverter))]
[System.Serializable]
public struct Rect : IFormattable

[System.ComponentModel.TypeConverter(typeof(System.Windows.RectConverter))]
public struct Rect : IFormattable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.RectConverter))>]
[<System.Serializable>]
type Rect = struct
    interface IFormattable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.RectConverter))>]
type Rect = struct
    interface IFormattable

Public Structure Rect
Implements IFormattable

Dědičnost

Object

ValueType

Rect

Atributy

TypeConverterAttribute SerializableAttribute

Implementuje

IFormattable

Příklady

Následující příklad ukazuje, jak použít Rect strukturu k určení dimenzí a umístění obdélníku pomocí 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.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>

Následující příklad ukazuje, jak pomocí kódu vytvořit obdélník a přidat ho na stránku. Příklad také ukazuje, jak najít velikost a souřadnicové informace o novém obdélníku a vykreslit informace pod TextBox obdélníkem.

// 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;
}

Poznámky

Použití atributu XAML

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

Hodnoty XAML

x
System.Double

Umístění souřadnic x levé strany obdélníku.

Y
System.Double

Umístění souřadnic y horní strany obdélníku.

width
System.Double

Nezáporná hodnota, která představuje Width obdélník.

height
System.Double

Nezáporná hodnota, která představuje Height obdélník.

Konstruktory

Rect(Double, Double, Double, Double)	Inicializuje novou instanci Rect struktury, která má zadanou souřadnici x, souřadnici y, šířku a výšku.
Rect(Point, Point)	Inicializuje novou instanci Rect struktury, která je přesně velká, aby obsahovala dva zadané body.
Rect(Point, Size)	Inicializuje novou instanci Rect struktury, která má zadané umístění v levém horním rohu a zadanou šířku a výšku.
Rect(Point, Vector)	Inicializuje novou instanci Rect struktury, která je přesně velká, aby obsahovala zadaný bod a součet zadaného bodu a zadaného vektoru.
Rect(Size)	Inicializuje novou instanci Rect struktury, která má zadanou velikost a nachází se v umístění (0,0).

Vlastnosti

Bottom	Získá hodnotu osy y dolní části obdélníku.
BottomLeft	Získá pozici levého dolního rohu obdélníku.
BottomRight	Získá pozici pravého dolního rohu obdélníku.
Empty	Získá speciální hodnotu, která představuje obdélník bez pozice nebo oblasti.
Height	Získá nebo nastaví výšku obdélníku.
IsEmpty	Získá hodnotu, která označuje, zda obdélník je Empty obdélník.
Left	Získá hodnotu osy x levé strany obdélníku.
Location	Získá nebo nastaví pozici levého horního rohu obdélníku.
Right	Získá hodnotu osy x pravé strany obdélníku.
Size	Získá nebo nastaví šířku a výšku obdélníku.
Top	Získá pozici osy y horní části obdélníku.
TopLeft	Získá pozici levého horního rohu obdélníku.
TopRight	Získá pozici pravého horního rohu obdélníku.
Width	Získá nebo nastaví šířku obdélníku.
X	Získá nebo nastaví hodnotu osy x levé strany obdélníku.
Y	Získá nebo nastaví hodnotu osy y horní strany obdélníku.

Metody

Contains(Double, Double)	Určuje, zda obdélník obsahuje zadanou souřadnici x a souřadnici y.
Contains(Point)	Určuje, zda obdélník obsahuje zadaný bod.
Contains(Rect)	Určuje, zda obdélník obsahuje zadaný obdélník.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu obdélníku.
Equals(Rect)	Určuje, zda se zadaný obdélník rovná aktuálnímu obdélníku.
Equals(Rect, Rect)	Určuje, zda jsou zadané obdélníky stejné.
GetHashCode()	Vytvoří kód hash pro obdélník.
Inflate(Double, Double)	Rozbalí nebo zmenší obdélník pomocí zadané šířky a výšky ve všechsměrch
Inflate(Rect, Double, Double)	Vytvoří obdélník, který bude výsledkem rozbalení nebo zmenšení zadaného obdélníku podle zadané šířky a výšky ve všech směrech.
Inflate(Rect, Size)	Vrátí obdélník, který má za následek rozbalení zadaného obdélníku zadaným Size, ve všech směrech.
Inflate(Size)	Rozbalí obdélník pomocí zadaného Sizepříkazu , ve všech směrech.
Intersect(Rect)	Najde průsečík aktuálního obdélníku a zadaného obdélníku a uloží výsledek jako aktuální obdélník.
Intersect(Rect, Rect)	Vrátí průsečík zadaných obdélníků.
IntersectsWith(Rect)	Určuje, zda zadaný obdélník protíná aktuální obdélník.
Offset(Double, Double)	Přesune obdélník podle zadaných vodorovných a svislých částek.
Offset(Rect, Double, Double)	Vrátí obdélník, který je posun od zadaného obdélníku pomocí zadané vodorovné a svislé částky.
Offset(Rect, Vector)	Vrátí obdélník, který je posunut od zadaného obdélníku pomocí zadaného vektoru.
Offset(Vector)	Přesune obdélník podle zadaného vektoru.
Parse(String)	Vytvoří nový obdélník ze zadané řetězcové reprezentace.
Scale(Double, Double)	Vynásobí velikost aktuálního obdélníku zadanými hodnotami x a y.
ToString()	Vrátí řetězcovou reprezentaci obdélníku.
ToString(IFormatProvider)	Vrátí řetězcovou reprezentaci obdélníku pomocí zadaného zprostředkovatele formátu.
Transform(Matrix)	Transformuje obdélník použitím zadané matice.
Transform(Rect, Matrix)	Vrátí obdélník, který má za následek použití zadané matice na zadaný obdélník.
Union(Point)	Rozbalí aktuální obdélník přesně tak, aby obsahoval zadaný bod.
Union(Rect)	Rozbalí aktuální obdélník přesně tak, aby obsahoval zadaný obdélník.
Union(Rect, Point)	Vytvoří obdélník, který je přesně velký, aby zahrnoval zadaný obdélník a zadaný bod.
Union(Rect, Rect)	Vytvoří obdélník, který je přesně velký, aby obsahoval dva zadané obdélníky.

Operátory

Equality(Rect, Rect)	Porovná dva obdélníky pro přesnou rovnost.
Inequality(Rect, Rect)	Porovná dva obdélníky pro nerovnost.

Explicitní implementace rozhraní

IFormattable.ToString(String, IFormatProvider)

Naformátuje hodnotu aktuální instance pomocí zadaného formátu.