Gestionar conectores en presentaciones usando C++

Un conector de PowerPoint es una línea especial que conecta o enlaza dos formas y permanece unida a las formas incluso cuando se mueven o reubican en una diapositiva dada.

Los conectores generalmente se conectan a puntos de conexión (puntos verdes), que existen en todas las formas por defecto. Los puntos de conexión aparecen cuando el cursor se acerca a ellos.

Puntos de ajuste (puntos naranjas), que existen solo en ciertos conectores, se utilizan para modificar las posiciones y formas de los conectores.

Tipos de conectores

En PowerPoint, puedes usar conectores rectos, de codo (angulados) y curvos.

Aspose.Slides proporciona estos conectores:

Conector Imagen Número de puntos de ajuste
ShapeType.Line shapetype-lineconnector 0
ShapeType.StraightConnector1 shapetype-straightconnector1 0
ShapeType.BentConnector2 shapetype-bent-connector2 0
ShapeType.BentConnector3 shapetype-bentconnector3 1
ShapeType.BentConnector4 shapetype-bentconnector4 2
ShapeType.BentConnector5 shapetype-bentconnector5 3
ShapeType.CurvedConnector2 shapetype-curvedconnector2 0
ShapeType.CurvedConnector3 shapetype-curvedconnector3 1
ShapeType.CurvedConnector4 shapetype-curvedconnector4 2
ShapeType.CurvedConnector5 shapetype.curvedconnector5 3

Conectar formas usando conectores

  1. Crea una instancia de la clase Presentation.
  2. Obtén una referencia a una diapositiva mediante su índice.
  3. Agrega dos AutoShape a la diapositiva usando el método AddAutoShape expuesto por el objeto Shapes.
  4. Agrega un conector usando el método AddConnector expuesto por el objeto Shapes definiendo el tipo de conector.
  5. Conecta las formas usando el conector.
  6. Llama al método Reroute para aplicar la ruta de conexión más corta.
  7. Guarda la presentación.

Este código C++ muestra cómo agregar un conector (un conector doblado) entre dos formas (una elipse y un rectángulo):

// La ruta al directorio de documentos.
	const String outPath = u"../out/ConnectShapesUsingConnectors_out.pptx";
	const String templatePath = u"../templates/ConnectorLineAngle.pptx";

	// Carga la presentación deseada
	SharedPtr<Presentation> pres = MakeObject<Presentation>();

	// Accede a la primera diapositiva
	SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

	// Accede a la colección de formas de una diapositiva específica
	SharedPtr<IShapeCollection> shapes = slide->get_Shapes();

	// Añade una forma autogenerada elipse
	SharedPtr<IAutoShape> ellipse = slide->get_Shapes()->AddAutoShape(ShapeType::Ellipse, 0, 100, 100, 100);

	// Añade una forma autogenerada rectángulo
	SharedPtr<IAutoShape> rect = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 100, 300, 100, 100);

	// Añade una forma de conector a la colección de formas de la diapositiva
	SharedPtr<IConnector> connector = shapes->AddConnector(ShapeType::BentConnector2, 0, 0, 10, 10);

	// Conecta las formas usando el conector
	connector->set_StartShapeConnectedTo ( ellipse);
	connector->set_EndShapeConnectedTo (rect);

	// Llama a reroute que establece la ruta automática más corta entre las formas
	connector->Reroute();
	
	// Guarda la presentación
	pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

Especificar un punto de conexión

Si deseas que un conector enlace dos formas usando puntos específicos en las formas, debes especificar tus puntos de conexión preferidos de esta manera:

  1. Crea una instancia de la clase Presentation.
  2. Obtén una referencia a una diapositiva mediante su índice.
  3. Agrega dos AutoShape a la diapositiva usando el método AddAutoShape expuesto por el objeto Shapes.
  4. Agrega un conector usando el método AddConnector expuesto por el objeto Shapes definiendo el tipo de conector.
  5. Conecta las formas usando el conector.
  6. Establece tus puntos de conexión preferidos en las formas.
  7. Guarda la presentación.

Este código C++ demuestra una operación donde se especifica un punto de conexión preferido:

	// La ruta al directorio de documentos.
	const String outPath = u"../out/ConnectShapeUsingConnectionSite_out.pptx";
	const String templatePath = u"../templates/ConnectorLineAngle.pptx";

	// Carga la presentación deseada
	SharedPtr<Presentation> pres = MakeObject<Presentation>();

	// Accede a la primera diapositiva
	SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

	// Accede a la colección de formas de una diapositiva específica
	SharedPtr<IShapeCollection> shapes = slide->get_Shapes();

	// Añade una forma autogenerada Elipse
	SharedPtr<IAutoShape> ellipse = slide->get_Shapes()->AddAutoShape(ShapeType::Ellipse, 0, 100, 100, 100);

	// Añade una forma autogenerada Rectángulo
	SharedPtr<IAutoShape> rect = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 100, 200, 100, 100);

	// Añade una forma de conector a la colección de formas de la diapositiva
	SharedPtr<IConnector> connector = shapes->AddConnector(ShapeType::BentConnector3, 0, 0, 10, 10);

	// Conecta las formas usando el conector
	connector->set_StartShapeConnectedTo(ellipse);
	connector->set_EndShapeConnectedTo(rect);


	// Establece el índice del punto de conexión preferido en la forma Elipse
	int wantedIndex = 6;

	// Comprueba si el índice preferido es menor que el número máximo de índices de sitio
	if (ellipse->get_ConnectionSiteCount() > wantedIndex)
	{
		// Establece el punto de conexión preferido en la autoshape Elipse
		connector->set_StartShapeConnectionSiteIndex ( wantedIndex);
	}

	// Guarda la presentación
	pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

Ajustar un punto de conector

Puedes ajustar un conector existente a través de sus puntos de ajuste. Solo los conectores con puntos de ajuste pueden modificarse de esta manera. Consulta la tabla bajo Tipos de conectores.

Caso simple

Considera un caso donde un conector entre dos formas (A y B) pasa a través de una tercera forma (C):

connector-obstruction

Código:

auto pres = System::MakeObject<Presentation>();
auto slide = pres->get_Slides()->idx_get(0);
auto shapes = slide->get_Shapes();
auto shape = shapes->AddAutoShape(ShapeType::Rectangle, 300.0f, 150.0f, 150.0f, 75.0f);
auto shapeFrom = shapes->AddAutoShape(ShapeType::Rectangle, 500.0f, 400.0f, 100.0f, 50.0f);
auto shapeTo = shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 70.0f, 30.0f);

auto connector = shapes->AddConnector(ShapeType::BentConnector5, 20.0f, 20.0f, 400.0f, 300.0f);

auto lineFormat = connector->get_LineFormat();
lineFormat->set_EndArrowheadStyle(LineArrowheadStyle::Triangle);
auto lineFillFormat = lineFormat->get_FillFormat();
lineFillFormat->set_FillType(FillType::Solid);
lineFillFormat->get_SolidFillColor()->set_Color(System::Drawing::Color::get_Black());

connector->set_StartShapeConnectedTo(shapeFrom);
connector->set_EndShapeConnectedTo(shapeTo);
connector->set_StartShapeConnectionSiteIndex(2);

Para evitar o eludir la tercera forma, podemos ajustar el conector moviendo su línea vertical hacia la izquierda de esta manera:

connector-obstruction-fixed

auto adj2 = connector->get_Adjustments()->idx_get(1);
adj2->set_RawValue(adj2->get_RawValue() + 10000);

Casos complejos

Para realizar ajustes más complicados, debes tener en cuenta lo siguiente:

  • El punto ajustable de un conector está fuertemente vinculado a una fórmula que calcula y determina su posición. Por lo tanto, los cambios en la ubicación del punto pueden alterar la forma del conector.
  • Los puntos de ajuste de un conector se definen en un orden estricto dentro de una matriz. Los puntos de ajuste se numeran desde el punto inicial del conector hasta su final.
  • Los valores de los puntos de ajuste reflejan el porcentaje del ancho/alto de la forma del conector.
    • La forma está limitada por los puntos de inicio y fin del conector multiplicados por 1000.
    • El primer punto, segundo punto y tercer punto definen respectivamente el porcentaje del ancho, el porcentaje del alto y nuevamente el porcentaje del ancho.
  • Para los cálculos que determinan las coordenadas de los puntos de ajuste de un conector, debes tener en cuenta la rotación del conector y su reflexión. Nota que el ángulo de rotación para todos los conectores mostrados bajo Tipos de conectores es 0.

Caso 1

Considera un caso donde dos objetos de marco de texto están ligados entre sí mediante un conector:

connector-shape-complex

Código:

	// Instancia una clase de presentación que representa un archivo PPTX
	auto pres = System::MakeObject<Presentation>();
	// Obtiene la primera diapositiva de la presentación
	auto slide = pres->get_Slides()->idx_get(0);
	// Obtiene las formas de la primera diapositiva
	auto shapes = slide->get_Shapes();
	// Añade formas que se unirán mediante un conector
	auto shapeFrom = shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 60.0f, 25.0f);
	shapeFrom->get_TextFrame()->set_Text(u"From");
	auto shapeTo = shapes->AddAutoShape(ShapeType::Rectangle, 500.0f, 100.0f, 60.0f, 25.0f);
	shapeTo->get_TextFrame()->set_Text(u"To");
	// Añade un conector
	auto connector = shapes->AddConnector(ShapeType::BentConnector4, 20.0f, 20.0f, 400.0f, 300.0f);
	auto lineFormat = connector->get_LineFormat();
	// Especifica la dirección del conector
	lineFormat->set_EndArrowheadStyle(LineArrowheadStyle::Triangle);
	// Especifica el grosor de la línea del conector
	lineFormat->set_Width(3);
	// Especifica el color del conector
	auto lineFillFormat = lineFormat->get_FillFormat();
	lineFillFormat->set_FillType(Aspose::Slides::FillType::Solid);
	lineFillFormat->get_SolidFillColor()->set_Color(System::Drawing::Color::get_Crimson());

	// Enlaza las formas con el conector
	connector->set_StartShapeConnectedTo(shapeFrom);
	connector->set_StartShapeConnectionSiteIndex(3);
	connector->set_EndShapeConnectedTo(shapeTo);
	connector->set_EndShapeConnectionSiteIndex(2);

	// Obtiene los puntos de ajuste del conector
	auto adjustments = connector->get_Adjustments();
	auto adjValue_0 = adjustments->idx_get(0);
	auto adjValue_1 = adjustments->idx_get(1);

Ajuste

Podemos cambiar los valores de los puntos de ajuste del conector aumentando el porcentaje de ancho y alto correspondientes en un 20% y 200%, respectivamente:

// Cambia los valores de los puntos de ajuste
adjValue_0->set_RawValue(adjValue_0->get_RawValue() + 20000);
adjValue_1->set_RawValue(adjValue_1->get_RawValue() + 200000);

El resultado:

connector-adjusted-1

Para definir un modelo que nos permita determinar las coordenadas y la forma de las partes individuales del conector, vamos a crear una forma que corresponda al componente horizontal del conector en el punto connector.Adjustments[0]:

// Dibuja el componente vertical del conector
float x = connector->get_X() + connector->get_Width() * adjValue_0->get_RawValue() / 100000;
float y = connector->get_Y();
float height = connector->get_Height() * adjValue_1->get_RawValue() / 100000;
shapes->AddAutoShape(ShapeType::Rectangle, x, y, 0.0f, height);

El resultado:

connector-adjusted-2

Caso 2

En el Caso 1, demostramos una operación sencilla de ajuste de conector usando principios básicos. En situaciones normales, debes tener en cuenta la rotación del conector y su visualización (que se establecen mediante connector.Rotation, connector.Frame.FlipH y connector.Frame.FlipV). Ahora demostraremos el proceso.

Primero, agreguemos un nuevo objeto de marco de texto (To 1) a la diapositiva (para propósitos de conexión) y creemos un nuevo conector (verde) que lo conecte a los objetos que ya creamos.

// Crea un nuevo objeto de enlace
auto shapeTo_1 = shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 400.0f, 60.0f, 25.0f);
shapeTo_1->get_TextFrame()->set_Text(u"To 1");
// Crea un nuevo conector
connector = shapes->AddConnector(ShapeType::BentConnector4, 20.0f, 20.0f, 400.0f, 300.0f);
lineFormat->set_EndArrowheadStyle(LineArrowheadStyle::Triangle);
lineFormat->set_Width(3);
lineFillFormat->set_FillType(Aspose::Slides::FillType::Solid);
lineFillFormat->get_SolidFillColor()->set_Color(System::Drawing::Color::get_MediumAquamarine());
// Conecta los objetos usando el conector recién creado
connector->set_StartShapeConnectedTo(shapeFrom);
connector->set_StartShapeConnectionSiteIndex(2);
connector->set_EndShapeConnectedTo(shapeTo_1);
connector->set_EndShapeConnectionSiteIndex(3);
// Obtiene los puntos de ajuste del conector
adjValue_0 = adjustments->idx_get(0);
adjValue_1 = adjustments->idx_get(1);
// Cambia los valores de los puntos de ajuste
adjValue_0->set_RawValue(adjValue_0->get_RawValue() + 20000);
adjValue_1->set_RawValue(adjValue_1->get_RawValue() + 200000);

El resultado:

connector-adjusted-3

Segundo, creemos una forma que corresponda al componente horizontal del conector que pasa por el nuevo punto de ajuste del conector connector.Adjustments[0]. Utilizaremos los valores de los datos del conector para connector.Rotation, connector.Frame.FlipH y connector.Frame.FlipV y aplicaremos la popular fórmula de conversión de coordenadas para rotación alrededor de un punto dado x0:

X = (x — x0) * cos(alpha) — (y — y0) * sin(alpha) + x0; Y = (x — x0) * sin(alpha) + (y — y0) * cos(alpha) + y0;

En nuestro caso, el ángulo de rotación del objeto es 90 grados y el conector se muestra verticalmente, por lo que este es el código correspondiente:

El resultado:

connector-adjusted-4

Demostramos cálculos que involucran ajustes simples y puntos de ajuste complicados (puntos de ajuste con ángulos de rotación). Con el conocimiento adquirido, puedes desarrollar tu propio modelo (o escribir un código) para obtener un objeto GraphicsPath o incluso establecer los valores de los puntos de ajuste del conector basados en coordenadas específicas de la diapositiva.

Encontrar el ángulo de líneas de conector

  1. Crea una instancia de la clase Presentation.
  2. Obtén una referencia a una diapositiva mediante su índice.
  3. Accede a la forma de línea del conector.
  4. Utiliza el ancho de línea, la altura, la altura del marco de la forma y el ancho del marco de la forma para calcular el ángulo.

Este código C++ demuestra una operación en la que calculamos el ángulo para una forma de línea de conector:

void ConnectorLineAngle()
{

	// La ruta al directorio de documentos.
	const String outPath = u"../out/ConnectorLineAngle_out.pptx";
	const String templatePath = u"../templates/ConnectorLineAngle.pptx";

	// Carga la presentación deseada
	SharedPtr<Presentation> pres = MakeObject<Presentation>(templatePath);

	// Accede a la primera diapositiva
	SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

	for (int i = 0; i < slide->get_Shapes()->get_Count(); i++)
	{
		double dir = 0.0;
		// Accede a la colección de formas de la diapositiva
		System::SharedPtr<IShape> shape = slide->get_Shapes()->idx_get(i);

		if (System::ObjectExt::Is<AutoShape>(shape))
		{
			SharedPtr<AutoShape> aShape = ExplicitCast<Aspose::Slides::AutoShape>(shape);
			if (aShape->get_ShapeType() == ShapeType::Line)
			{
				//                dir = getDirection(aShape->get_Width(), aShape->get_Height(), Convert::ToBoolean(aShape->get_Frame()->get_FlipH()), Convert::ToBoolean(aShape->get_Frame()->get_FlipV()));
				dir = getDirection(aShape->get_Width(), aShape->get_Height(), aShape->get_Frame()->get_FlipH(), aShape->get_Frame()->get_FlipV());

			}
		}

		else if (System::ObjectExt::Is<Connector>(shape))
		{
				SharedPtr<Connector> aShape = ExplicitCast<Aspose::Slides::Connector>(shape);
				//                dir = getDirection(aShape->get_Width(), aShape->get_Height(), Convert::ToBoolean(aShape->get_Frame()->get_FlipH()), Convert::ToBoolean(aShape->get_Frame()->get_FlipV()));
				dir = getDirection(aShape->get_Width(), aShape->get_Height(), aShape->get_Frame()->get_FlipH(),aShape->get_Frame()->get_FlipV());
		}

		Console::WriteLine(dir);
	
	}


}
//double ConnectorLineAngle::getDirection(float w, float h, NullableBool flipH, NullableBool flipV)
double getDirection(float w, float h, Aspose::Slides::NullableBool flipH, Aspose::Slides::NullableBool flipV)
{
	float endLineX = w;

	if (flipH == NullableBool::True)
		endLineX= endLineX * -1;
	else
		endLineX=endLineX *  1;
	//float endLineX = w * (flipH ? -1 : 1);
	float endLineY = h;
	if (flipV == NullableBool::True)
		endLineY = endLineY * -1;
	else
		endLineY = endLineY *  1;
	//float endLineY = h * (flipV ? -1 : 1);
	float endYAxisX = 0;
	float endYAxisY = h;
	double angle = (Math::Atan2(endYAxisY, endYAxisX) - Math::Atan2(endLineY, endLineX));
	if (angle < 0) angle += 2 * Math::PI;
	return angle * 180.0 / Math::PI;
}

Preguntas frecuentes

¿Cómo puedo saber si un conector puede “pegarse” a una forma específica?

Verifica que la forma exponga puntos de conexión. Si no hay ninguno o el recuento es cero, el pegado no está disponible; en ese caso, utiliza extremos libres y colócalos manualmente. Es prudente comprobar el recuento de sitios antes de adjuntar.

¿Qué ocurre con un conector si elimino una de las formas conectadas?

Sus extremos se desacoplarán; el conector permanecerá en la diapositiva como una línea ordinaria con inicio/final libres. Puedes eliminarlo o volver a asignar las conexiones y, si es necesario, reencaminar.

¿Se conservan las vinculaciones de los conectores al copiar una diapositiva a otra presentación?

Generalmente sí, siempre que las formas objetivo también se copien. Si la diapositiva se inserta en otro archivo sin las formas conectadas, los extremos se vuelven libres y deberás volver a adjuntarlos.

Personalizar formas de presentación en C++