Aspose.Slides for .NET 24.11 Release Notes

/// <summary>
/// Returns or sets the grid spacing that should be used for the grid underlying the presentation document, in points. 
/// Read/write <see cref="float"/>.
/// </summary>
/// <remarks>
/// The grid spacing value must be a positive number.
/// The typical value range is from 1 mm (2.8349607 points) to 2 inches (144 points).
/// </remarks>
/// <example>
/// The following sample code shows how to change the grid spacing in a PowerPoint presentation.
/// <code>
/// [C#]
/// using (Presentation pres = new Presentation())
/// {
///     pres.ViewProperties.GridSpacing = 72f;
///     pres.Save(GridSpacing_out.pptx", SaveFormat.Pptx);
/// }
/// </code>
/// </example>
float GridSpacing { get; set; }

/// <summary>
/// Represents an adjustable drawing guide.
/// </summary>
public interface IDrawingGuide
{
	/// <summary>
	/// Returns or sets orientation of the drawing guide.
	/// Read/write <see cref="Slides.Orientation"/>.
	/// </summary>
	Orientation Orientation { get; set; }

	/// <summary>
	/// Returns or sets position of the drawing guide in points from the top, left corner of the slide.
	/// Read/write <see cref="float"/>.
	/// </summary>
	/// <remarks>
	/// The typical value range is from zero to slide height for a horizontal guide and from zero to slide width for a vertical guide.
	/// </remarks>
	float Position { get; set; }
}

/// <summary>
/// Represents a collection of the adjustable drawing guides.
/// </summary>
public interface IDrawingGuidesCollection : IEnumerable<IDrawingGuide>
{
    /// <summary>
    /// Returns the drawing guide by index.
    /// Read-only <see cref="IDrawingGuide"/>.
    /// </summary>
    IDrawingGuide this[int index] { get; }

    /// <summary>
    /// Adds the drawing guide at the end of the collection.
    /// </summary>
    /// <param name="orientation">Orientation of the drawing guide.</param>
    /// <param name="position">Position of the the drawing guide in points.</param>
    IDrawingGuide Add(Orientation orientation, float position);

    /// <summary>
    /// Removes the drawing guide at the specified index.
    /// </summary>
    /// <param name="index">Index of the drawing guide that should be deleted.</param>
    void RemoveAt(int index);

    /// <summary>
    /// Removes all elements from the collection.
    /// </summary>
    void Clear();

    /// <summary>
    /// Gets the number of all elements in the collection.
    /// Read-only <see cref="int"/>.
    /// </summary>
    int Count { get; }
}

/// <summary>
/// Returns the collection of the drawing guides.
/// Read-only <see cref="IDrawingGuidesCollection"/>
/// </summary>
/// <example>
/// The following sample code shows how to add the new drawing guides in a PowerPoint presentation.
/// <code>
/// [C#]
/// using (Presentation pres = new Presentation())
/// {
///     var slideSize = pres.SlideSize.Size;
///     
///     IDrawingGuidesCollection guides = pres.ViewProperties.SlideViewProperties.DrawingGuides;
///     // Adding the new vertical drawing guide to the right of the slide center
///     guides.Add(Orientation.Vertical, slideSize.Width / 2 + 12.5f);
///     // Adding the new horizontal drawing guide below the slide center
///     guides.Add(Orientation.Horizontal, slideSize.Height / 2 + 12.5f);
///     
///     pres.Save("DrawingGuides_out.pptx", SaveFormat.Pptx);
/// }
/// </code>
/// </example>
IDrawingGuidesCollection DrawingGuides { get; }

using (Presentation pres = new Presentation())
{
    pres.ViewProperties.GridSpacing = 72f;
    pres.Save("GridSpacing_out.pptx", SaveFormat.Pptx);
}

using (Presentation pres = new Presentation())
{
    var slideSize = pres.SlideSize.Size;
    
    IDrawingGuidesCollection guides = pres.ViewProperties.SlideViewProperties.DrawingGuides;
    // Adding the new vertical drawing guide to the right of the slide center
    guides.Add(Orientation.Vertical, slideSize.Width / 2 + 12.5f);
    // Adding the new horizontal drawing guide below the slide center
    guides.Add(Orientation.Horizontal, slideSize.Height / 2 + 12.5f);
    
    pres.Save("DrawingGuides_out.pptx", SaveFormat.Pptx);
}