Working with handout master slides

A handout master describes how printed handouts should look. It is separate from normal slide content and is related from the presentation part.

Handout master structure

The root element is <p:handoutMaster/>. It can contain common slide data, a color map override, header and footer settings, extension data, and relationships to resources such as themes or images.

<p:handoutMaster
  xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main">
  <p:cSld name="Handout Master"/>
  <p:clrMapOvr>
    <a:masterClrMapping xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
  </p:clrMapOvr>
</p:handoutMaster>

Common elements:

p:clrMap maps theme color names such as bg1, tx1, accent1, hlink, and folHlink to actual theme slots. p:cSld holds the common slide data for the handout master, including the shape tree and text bodies used by handout placeholders.

If a handout master is created from scratch, the package also needs a handout master part relationship and any required theme or image relationships. The upstream sample creates common slide data, a shape tree, a title placeholder shape, and a color map.

Rust workflow

Open the package and get the presentation part. If the deck has a handout master, use presentation_part.handout_master_part(&document) and read the part data through the package.

#![allow(unused)]
fn main() {
use std::io::Cursor;
use std::path::Path;

use ooxmlsdk::parts::comment_authors_part::CommentAuthorsPart;
use ooxmlsdk::parts::presentation_document::PresentationDocument;
use ooxmlsdk::parts::presentation_part::PresentationPart;
use ooxmlsdk::parts::slide_comments_part::SlideCommentsPart;
use ooxmlsdk::parts::slide_part::SlidePart;
use ooxmlsdk::sdk::MediaDataPartType;
use ooxmlsdk::sdk::{OpenSettings, PackageOpenMode, PresentationDocumentType};

pub fn open_presentation_read_only(path: &Path) -> Result<usize, Box<dyn std::error::Error>> {
  let document = PresentationDocument::new_from_file_with_settings(path, lazy_settings())?;
  let presentation_part = document.presentation_part()?;

  Ok(presentation_part.slide_parts(&document).count())
}
}

Not every presentation contains a handout master. Treat the accessor as optional and avoid creating one from scratch until the document also has matching relationships and content type entries.