# Spravovat štítky citlivosti v prezentacích PowerPoint v C++ > Číst, přidávat, aktualizovat, odstraňovat a migrovat štítky citlivosti Microsoft Purview v prezentacích PowerPoint PPTX pomocí Aspose.Slides pro C++. Source: https://docs.aspose.com/slides/cs/cpp/sensitivity-labels/ Updated: 2026-09-02 ## **Přehled** Microsoft Purview sensitivity labels pomáhají organizacím klasifikovat a spravovat dokumenty. Během automatického zpracování prezentace může aplikace potřebovat zachovat existující štítek, použít štítek vybraný politikou, aktualizovat jeho stav nebo migrovat metadata štítku zapsaná starším pracovním postupem Microsoft Information Protection (MIP). Aspose.Slides poskytuje moderní metadata štítků citlivosti prostřednictvím [IPresentation::get_SensitivityLabels](https://reference.aspose.com/slides/cs/cpp/aspose.slides/ipresentation/get_sensitivitylabels/). Tato metoda vrací [ISensitivityLabelCollection](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabelcollection/), kterou lze prozkoumat a upravit před uložením prezentace jako PPTX. {{% alert color="primary" title="Note" %}} Identifikátory štítků citlivosti a informace o politice jsou definovány ve vaší konfiguraci Microsoft Purview. Ověřte dostupnost štítků a požadavky politiky ve vašem prostředí před přidáním nebo migrací metadat. Hodnoty [ISensitivityLabel::get_ContentMarkTypes](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/get_contentmarktypes/) popisují označení obsahu spojená se štítkem; samy o sobě nepřidávají viditelný text ani tvary do snímků. {{% /alert %}} ## **Pochopení vlastností štítku citlivosti** Každý [ISensitivityLabel](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/) obsahuje následující metadata: | Přístupy | Účel | | --- | --- | | [ISensitivityLabel::get_Id](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/get_id/), [ISensitivityLabel::set_Id](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/set_id/) | Identifikuje štítek citlivosti v politice Purview. | | [ISensitivityLabel::get_SiteId](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/get_siteid/), [ISensitivityLabel::set_SiteId](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/set_siteid/) | Identifikuje web (site) spojený s politikou štítku. | | [ISensitivityLabel::get_IsEnabled](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/get_isenabled/), [ISensitivityLabel::set_IsEnabled](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/set_isenabled/) | Udává, zda je štítek povolen. | | [ISensitivityLabel::get_IsRemoved](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/get_isremoved/), [ISensitivityLabel::set_IsRemoved](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/set_isremoved/) | Udává, že byl štítek odstraněn. Nastavte hodnotu na `true`, pokud musí být stav odstranění zachován v metadatech. | | [ISensitivityLabel::get_AssignmentMethodType](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/get_assignmentmethodtype/), [ISensitivityLabel::set_AssignmentMethodType](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/set_assignmentmethodtype/) | Určuje, zda byl štítek aplikován automaticky nebo na základě rozhodnutí uživatele. | | [ISensitivityLabel::get_ContentMarkTypes](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/get_contentmarktypes/) | Uvádí typy označení obsahu spojené se štítkem. | Výčtový typ [SensitivityLabelAssignmentType](https://reference.aspose.com/slides/cs/cpp/aspose.slides/sensitivitylabelassignmenttype/) popisuje, jak byl štítek přiřazen: - [SensitivityLabelAssignmentType::Standard](https://reference.aspose.com/slides/cs/cpp/aspose.slides/sensitivitylabelassignmenttype/) představuje výchozí nebo automaticky aplikovaný štítek. - [SensitivityLabelAssignmentType::Privileged](https://reference.aspose.com/slides/cs/cpp/aspose.slides/sensitivitylabelassignmenttype/) představuje štítek aplikovaný na základě rozhodnutí uživatele, včetně ručně aplikovaných, doporučených a povinných štítků. Výčtový typ [SensitivityLabelContentType](https://reference.aspose.com/slides/cs/cpp/aspose.slides/sensitivitylabelcontenttype/) určuje označení spojené se štítkem: | Hodnota | Význam | | --- | --- | | [SensitivityLabelContentType::None](https://reference.aspose.com/slides/cs/cpp/aspose.slides/sensitivitylabelcontenttype/) | Štítek byl aplikován výchozím nastavením nebo automaticky. | | [SensitivityLabelContentType::Header](https://reference.aspose.com/slides/cs/cpp/aspose.slides/sensitivitylabelcontenttype/) | K štítku je přiřazeno označení hlavičky. | | [SensitivityLabelContentType::Footer](https://reference.aspose.com/slides/cs/cpp/aspose.slides/sensitivitylabelcontenttype/) | K štítku je přiřazeno označení zápatí. | | [SensitivityLabelContentType::Watermark](https://reference.aspose.com/slides/cs/cpp/aspose.slides/sensitivitylabelcontenttype/) | K štítku je přiřazeno označení vodoznaku. | | [SensitivityLabelContentType::Encryption](https://reference.aspose.com/slides/cs/cpp/aspose.slides/sensitivitylabelcontenttype/) | K štítku je přiřazena ochrana šifrováním. | Více typů označení může být přiřazeno jednomu štítku. ## **Seznam existujících štítků citlivosti** Načtěte moderní kolekci štítků z [IPresentation::get_SensitivityLabels](https://reference.aspose.com/slides/cs/cpp/aspose.slides/ipresentation/get_sensitivitylabels/) a enumerujte ji. Následující příklad vypíše každou vlastnost a označení obsahu uložené pro každý štítek: ```cpp #include #include #include #include #include #include #include #include #include #include using Aspose::Slides::Presentation; using System::Console; using System::MakeObject; auto presentation = MakeObject(u"presentation.pptx"); auto sensitivityLabels = presentation->get_SensitivityLabels(); for (auto&& sensitivityLabel : sensitivityLabels) { auto labelIdentifier = sensitivityLabel->get_Id(); auto siteIdentifier = sensitivityLabel->get_SiteId(); auto isEnabled = sensitivityLabel->get_IsEnabled(); auto isRemoved = sensitivityLabel->get_IsRemoved(); auto assignmentMethod = sensitivityLabel->get_AssignmentMethodType(); Console::WriteLine(u"Label ID: {0}", labelIdentifier); Console::WriteLine(u"Site ID: {0}", siteIdentifier); Console::WriteLine(u"Enabled: {0}", isEnabled); Console::WriteLine(u"Removed: {0}", isRemoved); Console::WriteLine(u"Assignment method: {0}", assignmentMethod); for (auto contentMarkType : sensitivityLabel->get_ContentMarkTypes()) { Console::WriteLine(u"Content marking: {0}", contentMarkType); } } presentation->Dispose(); ``` ## **Přidání štítku citlivosti s označením obsahu** Použijte [ISensitivityLabelCollection::Add](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabelcollection/add/) s identifikátorem štítku, identifikátorem webu, stavem povolení a metodou přiřazení. Po vrácení nového [ISensitivityLabel](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/) přidejte požadované hodnoty označení pomocí [ISensitivityLabel::get_ContentMarkTypes](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/get_contentmarktypes/). Následující příklad přidá ručně vybraný štítek spojený s označením zápatí a vodoznaku a poté výsledek uloží jako PPTX: ```cpp #include #include #include #include #include #include #include #include #include using Aspose::Slides::Presentation; using Aspose::Slides::SensitivityLabelAssignmentType; using Aspose::Slides::SensitivityLabelContentType; using Aspose::Slides::Export::SaveFormat; using System::Guid; using System::MakeObject; auto presentation = MakeObject(u"presentation.pptx"); auto sensitivityLabels = presentation->get_SensitivityLabels(); auto labelIdentifier = u"{11111111-2222-3333-4444-555555555555}"; auto siteIdentifier = Guid::Parse(u"{aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee}"); bool isEnabled = true; auto assignmentMethod = SensitivityLabelAssignmentType::Privileged; auto sensitivityLabel = sensitivityLabels->Add( labelIdentifier, siteIdentifier, isEnabled, assignmentMethod); sensitivityLabel->get_ContentMarkTypes()->Add(SensitivityLabelContentType::Footer); sensitivityLabel->get_ContentMarkTypes()->Add(SensitivityLabelContentType::Watermark); presentation->Save(u"presentation_with_label.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` ## **Aktualizace štítku citlivosti** Hodnoty [ISensitivityLabel](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/) jsou čitelné i zapisovatelné prostřednictvím jejich getter a setter metod, s výjimkou kolekce vrácené metodou [ISensitivityLabel::get_ContentMarkTypes](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/get_contentmarktypes/), která se mění pomocí operací seznamu. Po nalezení požadovaného štítku můžete aktualizovat jeho identifikátor, identifikátor webu, stav povolení, metodu přiřazení, stav odstranění a typy označení obsahu. Uložte prezentaci, aby se změny projevily. Následující příklad aktualizuje stav povolení a metodu přiřazení prvního štítku: ```cpp #include #include #include #include #include #include using Aspose::Slides::Presentation; using Aspose::Slides::SensitivityLabelAssignmentType; using Aspose::Slides::Export::SaveFormat; using System::MakeObject; auto presentation = MakeObject(u"presentation.pptx"); auto sensitivityLabels = presentation->get_SensitivityLabels(); int labelCount = sensitivityLabels->get_Count(); if (labelCount > 0) { auto sensitivityLabel = sensitivityLabels->idx_get(0); sensitivityLabel->set_IsEnabled(true); sensitivityLabel->set_AssignmentMethodType(SensitivityLabelAssignmentType::Privileged); } presentation->Save(u"presentation_with_updated_label.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` ## **Označení štítku citlivosti jako odstraněného** Chcete‑li zachovat informaci, že byl štítek odstraněn, najděte štítek a zavolejte [ISensitivityLabel::set_IsRemoved](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/set_isremoved/) s hodnotou `true`. Tím se zachová záznam štítku a zaznamená se jeho stav odstranění. Pokud místo toho potřebujete ze moderní kolekce záznam smazat, použijte [ISensitivityLabelCollection::RemoveAt](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabelcollection/removeat/); pro smazání všech položek použijte [ISensitivityLabelCollection::Clear](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabelcollection/clear/). Následující příklad označí konkrétní štítek jako odstraněný a uloží aktualizovanou prezentaci: ```cpp #include #include #include #include #include #include #include using Aspose::Slides::Presentation; using Aspose::Slides::Export::SaveFormat; using System::MakeObject; using System::String; using System::StringComparison; auto presentation = MakeObject(u"presentation.pptx"); auto sensitivityLabels = presentation->get_SensitivityLabels(); auto targetLabelIdentifier = u"{11111111-2222-3333-4444-555555555555}"; for (auto&& sensitivityLabel : sensitivityLabels) { auto labelIdentifier = sensitivityLabel->get_Id(); bool isTargetLabel = String::Equals( labelIdentifier, targetLabelIdentifier, StringComparison::OrdinalIgnoreCase); if (isTargetLabel) { sensitivityLabel->set_IsRemoved(true); break; } } presentation->Save(u"presentation_with_removed_label.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` ## **Čtení a migrace starých štítků citlivosti MIP** Starší pracovní postupy založené na MIP mohou ukládat metadata štítků citlivosti do vlastních vlastností dokumentu místo moderní kolekce štítků. Načtěte tato metadata pomocí [IDocumentProperties::GetSensitivityLabels](https://reference.aspose.com/slides/cs/cpp/aspose.slides/idocumentproperties/getsensitivitylabels/). Metoda parsuje legacy vlastní vlastnosti a vrací pole objektů [ISensitivityLabel](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/). Pro migraci metadata přidejte každý vrácený štítek do moderní [ISensitivityLabelCollection](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabelcollection/) pomocí [ISensitivityLabelCollection::Add](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabelcollection/add/). Protože přidání duplicitního identifikátoru štítku vyvolá výjimku, příklad před kopírováním každého štítku kontroluje cílovou kolekci. Můžete přidat další ověření, aby bylo jisté, že každý starý štítek stále existuje v aktuální politice Purview. ```cpp #include #include #include #include #include #include #include #include #include using Aspose::Slides::Presentation; using Aspose::Slides::Export::SaveFormat; using System::MakeObject; using System::String; using System::StringComparison; auto presentation = MakeObject(u"presentation_with_legacy_labels.pptx"); auto documentProperties = presentation->get_DocumentProperties(); auto legacySensitivityLabels = documentProperties->GetSensitivityLabels(); auto modernSensitivityLabels = presentation->get_SensitivityLabels(); for (auto&& legacySensitivityLabel : legacySensitivityLabels) { bool labelAlreadyExists = false; auto legacyLabelIdentifier = legacySensitivityLabel->get_Id(); for (auto&& modernSensitivityLabel : modernSensitivityLabels) { auto modernLabelIdentifier = modernSensitivityLabel->get_Id(); labelAlreadyExists = String::Equals( modernLabelIdentifier, legacyLabelIdentifier, StringComparison::OrdinalIgnoreCase); if (labelAlreadyExists) { break; } } if (!labelAlreadyExists) { modernSensitivityLabels->Add(legacySensitivityLabel); } } presentation->Save(u"presentation_with_modern_labels.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` Migrace zkopíruje parsované objekty štítků do moderní kolekce. Není nutné vymazat všechny vlastní vlastnosti dokumentu, takže nesouvisející metadata dokumentu zůstávají nedotčena. Použijte [IPresentation::Save](https://reference.aspose.com/slides/cs/cpp/aspose.slides/ipresentation/save/) s [SaveFormat::Pptx](https://reference.aspose.com/slides/cs/cpp/aspose.slides.export/saveformat/) k zápisu moderních metadat štítků do souboru PPTX. ## **Často kladené otázky** **Vytvoří přidání typu označení obsahu viditelný záhlaví, zápatí nebo vodoznak na snímcích?** Ne. Hodnoty přidané přes [ISensitivityLabel::get_ContentMarkTypes](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/get_contentmarktypes/) popisují označení spojená se štítkem citlivosti. Nezobrazují žádný viditelný text ani tvary v prezentaci. Pokud váš pracovní postup musí tato označení vizuálně vykreslit, přidejte odpovídající obsah snímku samostatně. **Jaký je rozdíl mezi označením štítku jako odstraněného a jeho smazáním ze sbírky?** Volání [ISensitivityLabel::set_IsRemoved](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/set_isremoved/) s hodnotou `true` ponechá záznam štítku a zaznamená jeho stav odstranění. Volání [ISensitivityLabelCollection::RemoveAt](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabelcollection/removeat/) štítek ze sbírky úplně odstraní. Zvolte operaci, která odpovídá požadavkům vaší organizace na uchování metadat. **Může prezentace obsahovat jak stará MIP metadata, tak moderní štítky citlivosti?** Ano. Staré štítky mohou zůstat ve vlastních vlastnostech dokumentu, zatímco moderní štítky jsou dostupné přes [IPresentation::get_SensitivityLabels](https://reference.aspose.com/slides/cs/cpp/aspose.slides/ipresentation/get_sensitivitylabels/). Použijte [IDocumentProperties::GetSensitivityLabels](https://reference.aspose.com/slides/cs/cpp/aspose.slides/idocumentproperties/getsensitivitylabels/) k načtení starých metadat a migrujte jen platné štítky, které ještě nejsou v moderní kolekci. **Co se stane, když je štítek se stejným identifikátorem přidán vícekrát?** [ISensitivityLabelCollection::Add](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabelcollection/add/) vyhodí výjimku argumentu, pokud kolekce již obsahuje štítek se stejným identifikátorem. Před přidáním nebo migrací štítků zkontrolujte existující hodnoty [ISensitivityLabel::get_Id](https://reference.aspose.com/slides/cs/cpp/aspose.slides/isensitivitylabel/get_id/). **Jaký výstupní formát použít pro zachování aktualizovaných štítků citlivosti?** Uložte prezentaci jako PPTX voláním [IPresentation::Save](https://reference.aspose.com/slides/cs/cpp/aspose.slides/ipresentation/save/) s [SaveFormat::Pptx](https://reference.aspose.com/slides/cs/cpp/aspose.slides.export/saveformat/), jak je ukázáno v příkladech výše.