CoordOrigin

ShapeBase.CoordOrigin property

Las coordenadas en la esquina superior izquierda del bloque que contiene esta forma.

public Point CoordOrigin { get; set; }

Observaciones

El valor predeterminado es (0,0).

Ejemplos

Muestra cómo trasladar la ubicación de las coordenadas xey en el plano de coordenadas de una forma a una ubicación en el plano de coordenadas de la forma principal.

Document doc = new Document();

// Inserta una forma de grupo y colócala 100 puntos debajo y a la derecha de
// el punto de origen de las coordenadas x e Y del documento.
GroupShape group = new GroupShape(doc);
group.Bounds = new RectangleF(100, 100, 500, 500);

// Usa el método "LocalToParent" para determinar que (0, 0) en las coordenadas x e y internas del grupo
// se encuentra en (100, 100) del sistema de coordenadas de su forma principal. El padre de la forma del grupo es el documento mismo.
Assert.AreEqual(new PointF(100, 100), group.LocalToParent(new PointF(0, 0)));

// De forma predeterminada, el plano de coordenadas interno de una forma tiene la esquina superior izquierda en (0, 0),
// y la esquina inferior derecha en (1000, 1000). Debido a su tamaño, la forma de nuestro grupo cubre un área de 500 pt x 500 pt.
// en el plano del documento. Esto significa que un movimiento de 1 punto en el plano de coordenadas del documento se traducirá
// a un movimiento de 2 puntos en el plano de coordenadas de la forma del grupo.
Assert.AreEqual(new PointF(150, 150), group.LocalToParent(new PointF(100, 100)));
Assert.AreEqual(new PointF(200, 200), group.LocalToParent(new PointF(200, 200)));
Assert.AreEqual(new PointF(250, 250), group.LocalToParent(new PointF(300, 300)));

// Mueve el origen de los ejes xey de la forma del grupo desde la esquina superior izquierda al centro.
// Esto compensará aún más las coordenadas internas del grupo en relación con las coordenadas del documento.
group.CoordOrigin = new Point(-250, -250);

Assert.AreEqual(new PointF(375, 375), group.LocalToParent(new PointF(300, 300)));

// Cambiar la escala del plano de coordenadas también afectará las ubicaciones relativas.
group.CoordSize = new Size(500, 500);

Assert.AreEqual(new PointF(650, 650), group.LocalToParent(new PointF(300, 300)));

// Si deseamos agregar una forma a este grupo mientras definimos su ubicación en función de una ubicación en el documento,
// primero necesitaremos confirmar una ubicación en la forma del grupo que coincida con la ubicación del documento.
Assert.AreEqual(new PointF(700, 700), group.LocalToParent(new PointF(350, 350)));

Shape shape = new Shape(doc, ShapeType.Rectangle)
{
    Width = 100,
    Height = 100,
    Left = 700,
    Top = 700
};

group.AppendChild(shape);
doc.FirstSection.Body.FirstParagraph.AppendChild(group);

doc.Save(ArtifactsDir + "Shape.LocalToParent.docx");

Muestra cómo crear y rellenar una forma de grupo.

Document doc = new Document();

// Crea una forma de grupo. Una forma de grupo puede mostrar una colección de nodos de formas secundarias.
// En Microsoft Word, al hacer clic dentro de los límites de la forma del grupo o en una de las formas secundarias de la forma del grupo,
// selecciona todas las demás formas secundarias dentro de este grupo y nos permite escalar y mover todas las formas a la vez.
GroupShape group = new GroupShape(doc);

Assert.AreEqual(WrapType.None, group.WrapType);

// Cree una forma de grupo de 400 pt x 400 pt y colóquela en el origen de coordenadas de la forma flotante del documento.
group.Bounds = new RectangleF(0, 0, 400, 400);

// Establece el tamaño del plano de coordenadas interno del grupo en 500 x 500 puntos. 
// La esquina superior izquierda del grupo tendrá una coordenada xey de (0, 0),
// y la esquina inferior derecha tendrá una coordenada xey de (500, 500).
group.CoordSize = new Size(500, 500);

// Establece las coordenadas de la esquina superior izquierda del grupo en (-250, -250). 
// El centro del grupo ahora tendrá un valor de coordenadas xey de (0, 0),
// y la esquina inferior derecha estará en (250, 250).
group.CoordOrigin = new Point(-250, -250);

// Crea un rectángulo que mostrará el límite de esta forma de grupo y agrégalo al grupo.
group.AppendChild(new Shape(doc, ShapeType.Rectangle)
{
    Width = group.CoordSize.Width,
    Height = group.CoordSize.Height,
    Left = group.CoordOrigin.X,
    Top = group.CoordOrigin.Y
});

// Una vez que una forma forma parte de una forma de grupo, podemos acceder a ella como un nodo secundario y luego modificarla.
((Shape)group.GetChild(NodeType.Shape, 0, true)).Stroke.DashStyle = DashStyle.Dash;

// Crea una pequeña estrella roja e insértala en el grupo.
// Alinea la forma con el origen de coordenadas del grupo, que hemos movido al centro.
group.AppendChild(new Shape(doc, ShapeType.Star)
{
    Width = 20,
    Height = 20,
    Left = -10,
    Top = -10,
    FillColor = Color.Red
});

// Inserta un rectángulo y luego inserta un rectángulo un poco más pequeño en el mismo lugar con una imagen. 
// Las formas más nuevas que agregamos al grupo se superponen a las formas más antiguas. El rectángulo azul claro se superpondrá parcialmente a la estrella roja,
// y luego la forma con la imagen se superpondrá al rectángulo azul claro, usándolo como marco.
// No podemos usar las propiedades "ZOrder" de las formas para manipular su disposición dentro de una forma de grupo. 
group.AppendChild(new Shape(doc, ShapeType.Rectangle)
{
    Width = 250,
    Height = 250,
    Left = -250,
    Top = -250,
    FillColor = Color.LightBlue
});

group.AppendChild(new Shape(doc, ShapeType.Image)
{
    Width = 200,
    Height = 200,
    Left = -225,
    Top = -225
});

((Shape)group.GetChild(NodeType.Shape, 3, true)).ImageData.SetImage(ImageDir + "Logo.jpg");

// Inserta un cuadro de texto en la forma del grupo. Establezca la propiedad "Izquierda" para que el borde derecho del cuadro de texto
// toca el límite derecho de la forma del grupo. Establezca la propiedad "Superior" para que el cuadro de texto quede afuera
// el límite de la forma del grupo, con su tamaño superior alineado a lo largo del margen inferior de la forma del grupo.
group.AppendChild(new Shape(doc, ShapeType.TextBox)
{
    Width = 200,
    Height = 50,
    Left = group.CoordSize.Width + group.CoordOrigin.X - 200,
    Top = group.CoordSize.Height + group.CoordOrigin.Y
});

DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertNode(group);
builder.MoveTo(((Shape)group.GetChild(NodeType.Shape, 4, true)).AppendChild(new Paragraph(doc)));
builder.Write("Hello world!");

doc.Save(ArtifactsDir + "Shape.GroupShape.docx");

Ver también

ShapeBase.CanHaveImage ShapeBase.CoordSize