Управление гиперссылками

Гиперссылка — это ссылка на объект или данные или место в чем-то. Вот обычные гиперссылки в презентациях PowerPoint:

• Ссылки на веб-сайты внутри текстов, фигур или медиа
• Ссылки на слайды

Aspose.Slides для C++ позволяет выполнять множество задач, связанных с гиперссылками в презентациях.

Вы можете ознакомиться с простым, бесплатным онлайн редактором PowerPoint Aspose.

Добавление гиперссылок на URL

Добавление гиперссылок на URL к текстам

Этот код на C++ показывает, как добавить гиперссылку на веб-сайт к тексту:

auto presentation = System::MakeObject<Presentation>();
auto shapes = presentation->get_Slides()->idx_get(0)->get_Shapes();
auto shape = shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 600.0f, 50.0f, false);
shape->AddTextFrame(u"Aspose: File Format APIs");

auto portionFormat = shape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)->get_PortionFormat();
portionFormat->set_HyperlinkClick(MakeObject<Hyperlink>(u"https://www.aspose.com/"));
portionFormat->get_HyperlinkClick()->set_Tooltip(u"Более 70% компаний из списка Fortune 100 доверяют API Aspose");
portionFormat->set_FontHeight(32.0f);

presentation->Save(u"presentation-out.pptx", SaveFormat::Pptx);

Добавление гиперссылок на URL к фигурам или рамкам

Этот образец кода на C++ показывает, как добавить гиперссылку на веб-сайт к фигуре:

auto pres = System::MakeObject<Presentation>();
auto shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
auto shape = shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 600.0f, 50.0f);

shape->set_HyperlinkClick(System::MakeObject<Hyperlink>(u"https://www.aspose.com/"));
shape->get_HyperlinkClick()->set_Tooltip(u"Более 70% компаний из списка Fortune 100 доверяют API Aspose");

pres->Save(u"pres-out.pptx", SaveFormat::Pptx);

Добавление гиперссылок на URL к медиа

Aspose.Slides позволяет добавлять гиперссылки на изображения, аудио и видео файлы.

Этот образец кода показывает, как добавить гиперссылку к изображению:

auto pres = System::MakeObject<Presentation>();
auto shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
// Добавляет изображение в презентацию
auto image = pres->get_Images()->AddImage(File::ReadAllBytes(u"image.png"));
// Создает кадр изображения на слайде 1 на основе ранее добавленного изображения
auto pictureFrame = shapes->AddPictureFrame(ShapeType::Rectangle, 10.0f, 10.0f, 100.0f, 100.0f, image);

pictureFrame->set_HyperlinkClick(MakeObject<Hyperlink>(u"https://www.aspose.com/"));
pictureFrame->get_HyperlinkClick()->set_Tooltip(u"Более 70% компаний из списка Fortune 100 доверяют API Aspose");

pres->Save(u"pres-out.pptx", SaveFormat::Pptx);

Этот образец кода показывает, как добавить гиперссылку к аудиофайлу:

auto pres = System::MakeObject<Presentation>();
auto shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
auto audio = pres->get_Audios()->AddAudio(File::ReadAllBytes(u"audio.mp3"));
auto audioFrame = shapes->AddAudioFrameEmbedded(10.0f, 10.0f, 100.0f, 100.0f, audio);

audioFrame->set_HyperlinkClick(MakeObject<Hyperlink>(u"https://www.aspose.com/"));
audioFrame->get_HyperlinkClick()->set_Tooltip(u"Более 70% компаний из списка Fortune 100 доверяют API Aspose");

pres->Save(u"pres-out.pptx", SaveFormat::Pptx);

Этот образец кода показывает, как добавить гиперссылку к видео:

auto pres = System::MakeObject<Presentation>();
auto shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
auto video = pres->get_Videos()->AddVideo(File::ReadAllBytes(u"video.avi"));
auto videoFrame = shapes->AddVideoFrame(10.0f, 10.0f, 100.0f, 100.0f, video);

videoFrame->set_HyperlinkClick(MakeObject<Hyperlink>(u"https://www.aspose.com/"));
videoFrame->get_HyperlinkClick()->set_Tooltip(u"Более 70% компаний из списка Fortune 100 доверяют API Aspose");

pres->Save(u"pres-out.pptx", SaveFormat::Pptx);

Совет

Вы можете ознакомиться с Управление OLE.

Использование гиперссылок для создания оглавления

Поскольку гиперссылки позволяют добавлять ссылки на объекты или места, вы можете использовать их для создания оглавления.

Этот образец кода показывает, как создать оглавление с гиперссылками:

auto presentation = System::MakeObject<Presentation>();
auto firstSlide = presentation->get_Slides()->idx_get(0);
auto secondSlide = presentation->get_Slides()->AddEmptySlide(firstSlide->get_LayoutSlide());

auto contentTable = firstSlide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 40.0f, 40.0f, 300.0f, 100.0f);
contentTable->get_FillFormat()->set_FillType(FillType::NoFill);
contentTable->get_LineFormat()->get_FillFormat()->set_FillType(FillType::NoFill);
contentTable->get_TextFrame()->get_Paragraphs()->Clear();

auto paragraph = System::MakeObject<Paragraph>();
auto paragraphFillFormat = paragraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat();
paragraphFillFormat->set_FillType(FillType::Solid);
paragraphFillFormat->get_SolidFillColor()->set_Color(Color::get_Black());
paragraph->set_Text(u"Заголовок слайда 2 .......... ");

auto linkPortion = System::MakeObject<Portion>();
linkPortion->set_Text(u"Страница 2");
linkPortion->get_PortionFormat()->get_HyperlinkManager()->SetInternalHyperlinkClick(secondSlide);

paragraph->get_Portions()->Add(linkPortion);
contentTable->get_TextFrame()->get_Paragraphs()->Add(paragraph);

Форматирование гиперссылок

Цвет

С помощью методов set_ColorSource() и get_ColorSource() в интерфейсе IHyperlink вы можете установить цвет для гиперссылок и получить информацию о цвете из гиперссылок. Эта функция была впервые введена в PowerPoint 2019, поэтому изменения, касающиеся свойства, не применимы к более ранним версиям PowerPoint.

Этот образец кода демонстрирует операцию, где гиперссылки с разными цветами были добавлены на один и тот же слайд:

auto presentation = System::MakeObject<Presentation>();
auto shapes = presentation->get_Slides()->idx_get(0)->get_Shapes();
auto shape1 = shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 450.0f, 50.0f, false);
shape1->AddTextFrame(u"Это пример цветной гиперссылки.");
auto shape1PortionFormat = shape1->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)->get_PortionFormat();
shape1PortionFormat->set_HyperlinkClick(MakeObject<Hyperlink>(u"https://www.aspose.com/"));
shape1PortionFormat->get_HyperlinkClick()->set_ColorSource(HyperlinkColorSource::PortionFormat);
shape1PortionFormat->get_FillFormat()->set_FillType(FillType::Solid);
shape1PortionFormat->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Red());

auto shape2 = shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 200.0f, 450.0f, 50.0f, false);
shape2->AddTextFrame(u"Это пример обычной гиперссылки.");
auto shape2PortionFormat = shape2->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)->get_PortionFormat();
shape2PortionFormat->set_HyperlinkClick(MakeObject<Hyperlink>(u"https://www.aspose.com/"));

presentation->Save(u"presentation-out-hyperlink.pptx", SaveFormat::Pptx);

Удаление гиперссылок в презентациях

Удаление гиперссылок из текстов

Этот код на C++ показывает, как удалить гиперссылку из текста на слайде презентации:

auto pres = System::MakeObject<Presentation>(u"pres.pptx");
auto slide = pres->get_Slides()->idx_get(0);
for (const auto& shape : slide->get_Shapes())
{
    auto autoShape = System::AsCast<IAutoShape>(shape);
    if (autoShape != nullptr)
    {
        for (const auto& paragraph : autoShape->get_TextFrame()->get_Paragraphs())
        {
            for (const auto& portion : paragraph->get_Portions())
            {
                auto hyperlinkManager = portion->get_PortionFormat()->get_HyperlinkManager();
                hyperlinkManager->RemoveHyperlinkClick();
            }
        }
    }
}

pres->Save(u"pres-removed-hyperlinks.pptx", SaveFormat::Pptx);

Удаление гиперссылок из фигур или рамок

Этот код на C++ показывает, как удалить гиперссылку из фигуры на слайде презентации:

auto pres = System::MakeObject<Presentation>(u"demo.pptx");
auto slide = pres->get_Slides()->idx_get(0);
for (const auto& shape : slide->get_Shapes())
{
    shape->get_HyperlinkManager()->RemoveHyperlinkClick();
}
pres->Save(u"pres-removed-hyperlinks.pptx", SaveFormat::Pptx);

Изменяемая гиперссылка

Класс Hyperlink является изменяемым. С помощью этого класса вы можете изменить значения для следующих методов:

• IHyperlink::set_TargetFrame()
• IHyperlink::set_Tooltip()
• IHyperlink.set_History()
• IHyperlink.set_HighlightClick()
• IHyperlink.set_StopSoundOnClick()

Фрагмент кода показывает, как добавить гиперссылку на слайд и изменить ее подсказку позже:

auto presentation = System::MakeObject<Presentation>();
auto shapes = presentation->get_Slides()->idx_get(0)->get_Shapes();
auto shape = shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 600.0f, 50.0f, false);

shape->AddTextFrame(u"Aspose: File Format APIs");

auto shapePortionFormat = shape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)->get_PortionFormat();
shapePortionFormat->set_HyperlinkClick(MakeObject<Hyperlink>(u"https://www.aspose.com/"));
shapePortionFormat->get_HyperlinkClick()->set_Tooltip(u"Более 70% компаний из списка Fortune 100 доверяют API Aspose");
shapePortionFormat->set_FontHeight(32.0f);

presentation->Save(u"presentation-out.pptx", SaveFormat::Pptx);

Поддерживаемые методы в IHyperlinkQueries

Вы можете получить доступ к IHyperlinkQueries из презентации, слайда или текста, для которого определена гиперссылка.

• IPresentation::get_HyperlinkQueries()
• IBaseSlide::get_HyperlinkQueries()
• ITextFrame::get_HyperlinkQueries()

Класс IHyperlinkQueries поддерживает следующие методы:

• IHyperlinkQueries::GetHyperlinkClicks()
• IHyperlinkQueries::GetHyperlinkMouseOvers()
• IHyperlinkQueries::GetAnyHyperlinks()
• IHyperlinkQueries::RemoveAllHyperlinks()