Code:
/ Net / Net / 3.5.50727.3053 / DEVDIV / depot / DevDiv / releases / Orcas / SP / wpf / src / Core / CSharp / System / Windows / DataObjectSettingDataEventArgs.cs / 1 / DataObjectSettingDataEventArgs.cs
//---------------------------------------------------------------------------- // //// Copyright (C) Microsoft Corporation. All rights reserved. // // // Description: DataObjectSettingData event arguments // //--------------------------------------------------------------------------- using System; namespace System.Windows { ////// Arguments for the DataObject.SettingData event. /// The DataObject.SettingData event is raised during /// Copy (or Drag start) command when an editor /// is going to start data conversion for some /// of data formats. By handling this event an application /// can prevent from editon doing that thus making /// Copy performance better. /// public sealed class DataObjectSettingDataEventArgs : DataObjectEventArgs { //----------------------------------------------------- // // Constructors // //----------------------------------------------------- #region Constructors ////// Creates a DataObjectSettingDataEventArgs. /// /// /// DataObject to which a new data format is going to be added. /// /// /// Format which is going to be added to the DataObject. /// public DataObjectSettingDataEventArgs(IDataObject dataObject, string format) // : base(System.Windows.DataObject.SettingDataEvent, /*isDragDrop:*/false) { if (dataObject == null) { throw new ArgumentNullException("dataObject"); } if (format == null) { throw new ArgumentNullException("format"); } _dataObject = dataObject; _format = format; } #endregion Constructors //------------------------------------------------------ // // Public Properties // //----------------------------------------------------- #region Public Properties ////// DataObject to which a new data format is going to be added. /// public IDataObject DataObject { get { return _dataObject; } } ////// Format which is going to be added to the DataObject. /// public string Format { get { return _format; } } #endregion Public Properties #region Protected Methods //------------------------------------------------------ // // Protected Methods // //------------------------------------------------------ ////// The mechanism used to call the type-specific handler on the target. /// /// /// The generic handler to call in a type-specific way. /// /// /// The target to call the handler on. /// protected override void InvokeEventHandler(Delegate genericHandler, object genericTarget) { DataObjectSettingDataEventHandler handler = (DataObjectSettingDataEventHandler)genericHandler; handler(genericTarget, this); } #endregion Protected Methods //----------------------------------------------------- // // Private Fields // //------------------------------------------------------ #region Private Fields private IDataObject _dataObject; private string _format; #endregion Private Fields } ////// The delegate to use for handlers that receive the DataObject.QueryingCopy/QueryingPaste events. /// ////// A handler for a DataObject.SettingData event. /// Te event is fired as part of Copy (or Drag) command /// once for each of data formats added to a DataObject. /// The purpose of this handler is mostly copy command /// optimization. With the help of it application /// can filter some formats from being added to DataObject. /// The other opportunity of doing that exists in /// DataObject.Copying event, which could set all undesirable /// formats to null, but in this case the work for data /// conversion is already done, which may be too expensive. /// By handling DataObject.SettingData event an application /// can prevent from each particular data format conversion. /// By calling DataObjectSettingDataEventArgs.CancelCommand /// method the handler tells an editor to skip one particular /// data format (identified by DataObjectSettingDataEventArgs.Format /// property). Note that calling CancelCommand method /// for this event does not cancel the whole Copy or Drag /// command. /// public delegate void DataObjectSettingDataEventHandler(object sender, DataObjectSettingDataEventArgs e); } // File provided for Reference Use Only by Microsoft Corporation (c) 2007. // Copyright (c) Microsoft Corporation. All rights reserved. //---------------------------------------------------------------------------- // //// Copyright (C) Microsoft Corporation. All rights reserved. // // // Description: DataObjectSettingData event arguments // //--------------------------------------------------------------------------- using System; namespace System.Windows { ////// Arguments for the DataObject.SettingData event. /// The DataObject.SettingData event is raised during /// Copy (or Drag start) command when an editor /// is going to start data conversion for some /// of data formats. By handling this event an application /// can prevent from editon doing that thus making /// Copy performance better. /// public sealed class DataObjectSettingDataEventArgs : DataObjectEventArgs { //----------------------------------------------------- // // Constructors // //----------------------------------------------------- #region Constructors ////// Creates a DataObjectSettingDataEventArgs. /// /// /// DataObject to which a new data format is going to be added. /// /// /// Format which is going to be added to the DataObject. /// public DataObjectSettingDataEventArgs(IDataObject dataObject, string format) // : base(System.Windows.DataObject.SettingDataEvent, /*isDragDrop:*/false) { if (dataObject == null) { throw new ArgumentNullException("dataObject"); } if (format == null) { throw new ArgumentNullException("format"); } _dataObject = dataObject; _format = format; } #endregion Constructors //------------------------------------------------------ // // Public Properties // //----------------------------------------------------- #region Public Properties ////// DataObject to which a new data format is going to be added. /// public IDataObject DataObject { get { return _dataObject; } } ////// Format which is going to be added to the DataObject. /// public string Format { get { return _format; } } #endregion Public Properties #region Protected Methods //------------------------------------------------------ // // Protected Methods // //------------------------------------------------------ ////// The mechanism used to call the type-specific handler on the target. /// /// /// The generic handler to call in a type-specific way. /// /// /// The target to call the handler on. /// protected override void InvokeEventHandler(Delegate genericHandler, object genericTarget) { DataObjectSettingDataEventHandler handler = (DataObjectSettingDataEventHandler)genericHandler; handler(genericTarget, this); } #endregion Protected Methods //----------------------------------------------------- // // Private Fields // //------------------------------------------------------ #region Private Fields private IDataObject _dataObject; private string _format; #endregion Private Fields } ////// The delegate to use for handlers that receive the DataObject.QueryingCopy/QueryingPaste events. /// ////// A handler for a DataObject.SettingData event. /// Te event is fired as part of Copy (or Drag) command /// once for each of data formats added to a DataObject. /// The purpose of this handler is mostly copy command /// optimization. With the help of it application /// can filter some formats from being added to DataObject. /// The other opportunity of doing that exists in /// DataObject.Copying event, which could set all undesirable /// formats to null, but in this case the work for data /// conversion is already done, which may be too expensive. /// By handling DataObject.SettingData event an application /// can prevent from each particular data format conversion. /// By calling DataObjectSettingDataEventArgs.CancelCommand /// method the handler tells an editor to skip one particular /// data format (identified by DataObjectSettingDataEventArgs.Format /// property). Note that calling CancelCommand method /// for this event does not cancel the whole Copy or Drag /// command. /// public delegate void DataObjectSettingDataEventHandler(object sender, DataObjectSettingDataEventArgs e); } // File provided for Reference Use Only by Microsoft Corporation (c) 2007. // Copyright (c) Microsoft Corporation. All rights reserved.
Link Menu
This book is available now!
Buy at Amazon US or
Buy at Amazon UK
- RecordBuilder.cs
- HorizontalAlignConverter.cs
- ImageMap.cs
- LogExtentCollection.cs
- KeyedCollection.cs
- BadImageFormatException.cs
- OrderedEnumerableRowCollection.cs
- BamlCollectionHolder.cs
- BooleanToVisibilityConverter.cs
- ManagedFilter.cs
- EntityDataSourceEntityTypeFilterItem.cs
- CodeChecksumPragma.cs
- MenuItemBinding.cs
- TableLayoutStyleCollection.cs
- DataComponentMethodGenerator.cs
- TdsParserStateObject.cs
- ProtocolException.cs
- ScrollProperties.cs
- MethodRental.cs
- ButtonBase.cs
- EdmPropertyAttribute.cs
- XmlEntity.cs
- SQLString.cs
- DesigntimeLicenseContext.cs
- NGCSerializationManagerAsync.cs
- EncodingNLS.cs
- COM2IVsPerPropertyBrowsingHandler.cs
- ColorBlend.cs
- QueueProcessor.cs
- EventLogTraceListener.cs
- IdentityNotMappedException.cs
- NativeMethods.cs
- WCFBuildProvider.cs
- TreeNodeConverter.cs
- ClickablePoint.cs
- OleDbEnumerator.cs
- ResourceAssociationType.cs
- _KerberosClient.cs
- HostingEnvironmentException.cs
- WindowsStartMenu.cs
- FontFamilyConverter.cs
- ProbeRequestResponseAsyncResult.cs
- TextChangedEventArgs.cs
- DbConnectionHelper.cs
- BlurBitmapEffect.cs
- DataServiceProviderWrapper.cs
- TypeLoadException.cs
- ReadWriteSpinLock.cs
- EdmComplexTypeAttribute.cs
- RowCache.cs
- GlyphElement.cs
- StateMachineAction.cs
- SatelliteContractVersionAttribute.cs
- StructuredTypeEmitter.cs
- SchemaImporterExtensionElement.cs
- DataGridColumnFloatingHeader.cs
- TypeElementCollection.cs
- IdentityReference.cs
- VarRemapper.cs
- ElapsedEventArgs.cs
- SystemNetworkInterface.cs
- CommandField.cs
- Inflater.cs
- CodeVariableReferenceExpression.cs
- ImageIndexEditor.cs
- ExpressionDumper.cs
- DataGridTableCollection.cs
- StrongNameKeyPair.cs
- RequestBringIntoViewEventArgs.cs
- AuthenticationSection.cs
- MessageDecoder.cs
- RoutedEvent.cs
- DispatcherObject.cs
- WorkflowDesigner.cs
- Random.cs
- TokenBasedSet.cs
- WorkerRequest.cs
- GPRECTF.cs
- WpfWebRequestHelper.cs
- IsolatedStoragePermission.cs
- WebPartUtil.cs
- OrderByQueryOptionExpression.cs
- SchemaTypeEmitter.cs
- CompositeScriptReferenceEventArgs.cs
- CodeChecksumPragma.cs
- ContentFileHelper.cs
- ToolboxItemLoader.cs
- EncryptRequest.cs
- CachedBitmap.cs
- TextTreePropertyUndoUnit.cs
- SerializationTrace.cs
- SubMenuStyle.cs
- DocumentXmlWriter.cs
- WindowsFont.cs
- AliasedExpr.cs
- TextAction.cs
- ViewGenerator.cs
- XmlEncodedRawTextWriter.cs
- FixedPosition.cs
- DocumentEventArgs.cs