ImageEditorOptions.PredefinedImages Property

A collection of images that an end user can load to the image editor in Print Preview.

Namespace: DevExpress.Xpf.Printing

Assembly: DevExpress.Xpf.Printing.v24.1.dll

NuGet Package: DevExpress.Wpf.Printing

Declaration

C#

public ICollection<ImageGalleryItem> PredefinedImages { get; }

VB.NET

Public ReadOnly Property PredefinedImages As ICollection(Of ImageGalleryItem)

Property Value

Type	Description
ICollection<ImageGalleryItem>	The image editor’s image collection.

Property Paths

You can access this nested property as listed below:

Object Type	Path to PredefinedImages
ImageInplaceEditorInfo	.Options .PredefinedImages

Remarks

Specify the PredefinedImages property to add the item to the image editor’s menu. This item allows end users to choose one of the predefined images and load it to the editor.

The following code snippet demonstrates how you can specify the PredefinedImages property.

C#

using System.Collections.Generic;
using System.IO;
using DevExpress.Xpf.Printing;
using System.Drawing;

//...

Dictionary<string, Image> images = new Dictionary<string, Image>();
foreach (var file in Directory.GetFiles("Images/Flags/", "*.png")) {
        Image img = Image.FromFile(file);
        if (img != null) {
                string imageName = Path.GetFileNameWithoutExtension(file);
                images.Add(imageName, img);
        }
};
ImageEditorOptions imageEditorOptions = new ImageEditorOptions() {
        AllowLoadImage = false,
        AllowChangeSizeOptions = false,
        AllowDraw = false,
        AllowClear = true
};
foreach (var image in images)
        imageEditorOptions.PredefinedImages.Add(new ImageGalleryItem(image.Value, image.Key));
EditingFieldExtensions.Instance.RegisterImageEditorInfo("Nationality", imageEditorOptions, "Nationality");

VB.NET

Option Infer On

Imports System.Collections.Generic
Imports System.IO
Imports DevExpress.Xpf.Printing
Imports System.Drawing

'...

Private images As New Dictionary(Of String, Image)()
For Each file In Directory.GetFiles("Images/Flags", "*.png")
    Dim img As Image = Image.FromFile(file)
    If img IsNot Nothing Then
        Dim imageName As String = Path.GetFileNameWithoutExtension(file)
        images.Add(imageName, img)
    End If
Next file
Dim imageEditorOptions As New ImageEditorOptions() With {
    .AllowLoadImage = False,
    .AllowChangeSizeOptions = False,
    .AllowDraw = False,
    .AllowClear = True
}
For Each image In images
    imageEditorOptions.PredefinedImages.Add(New ImageGalleryItem(image.Value, image.Key))
Next image
EditingFieldExtensions.Instance.RegisterImageEditorInfo("Nationality", imageEditorOptions, "Nationality")

Do not specify image display names or set the AllowSearchPredefinedImages property to false if search within the image collection is not required.

If you want to allow end users to only choose an image in the predefined collection, you can use the RegisterImageCollectionEditorInfo method instead of the RegisterImageEditorInfo(String, ImageEditorOptions, String) method. The RegisterImageCollectionEditorInfo method takes an image collection directly, as a parameter.