Skip to main content
All docs
V24.1

ClipboardAccessPolicy.Clearing Event

Fires when a DevExpress UI control attempts to clear the clipboard and allows you to allow (or cancel) the operation.

Namespace: DevExpress.Data.Utils

Assembly: DevExpress.Data.Desktop.v24.1.dll

NuGet Packages: DevExpress.Data.Desktop, DevExpress.ExpressApp.Win.Design

Declaration

public static event EventHandler<ClipboardAccessPolicy.ClipboardOperationRequestEventArgs> Clearing

Event Data

The Clearing event's data class is ClipboardAccessPolicy.ClipboardOperationRequestEventArgs. The following properties provide information specific to this event:

Property Description
Cancel Gets or sets a value indicating whether the event should be canceled. Inherited from CancelEventArgs.
DataFormat Gets the data format.
DataObject Gets an object that defines a format-independent mechanism for transferring data.
IsClearOperation Gets a value that indicates whether the clipboard clear operation is being processed.
IsCopyOperation Gets a value that indicates whether the copy-to-clipboard operation is being processed.
IsDataObjectRequested
IsPasteOperation Gets a value that indicates whether the paste-from-clipboard operation is being processed.
IsUIStateQuery Gets a value that indicates whether a DevExpress UI control requests a copy/paste operation to update its UI (for example, menu commands).
Operation Gets the clipboard-related operation being processed.

The event data class exposes the following methods:

Method Description
ToString() Returns a string representation of the current object.

Remarks

DevExpress controls clear the clipboard on demand. The Clipboard Access Policy fires the Clearing event when a DevExpress UI control attempts to clear the clipboard. Handle the Clearing event to allow (or cancel) the operation based on a specific condition. Use the e.Cancel parameter to allow or cancel the operation.

The following example demonstrates how to allow DevExpress UI controls to clear the clipboard if the clipboard containts data in ANSI text format. If the clipboard contains data in a different format, the operation is canceled:

using System;
using System.Windows.Forms;
using DevExpress.Data.Utils;

namespace DXApplication {
    internal static class Program {
        /// <summary>
        /// The main entry point for the application.
        /// </summary>
        [STAThread]
        static void Main() {
            Application.EnableVisualStyles();
            Application.SetCompatibleTextRenderingDefault(false);
            ClipboardAccessPolicy.SuppressClearOperations();
            ClipboardAccessPolicy.Clearing += ClipboardAccessPolicy_Clearing;
            Application.Run(new Form1());
        }
        private static void ClipboardAccessPolicy_Clearing(object sender, ClipboardAccessPolicy.ClipboardOperationRequestEventArgs e) {
            if (e.DataFormat == DataFormats.Text)
                e.Cancel = false;
        }
    }
}

Read the following topic for additional information: Clipboard Access Policy.

See Also