Code:
/ Dotnetfx_Vista_SP2 / Dotnetfx_Vista_SP2 / 8.0.50727.4016 / DEVDIV / depot / DevDiv / releases / Orcas / QFE / 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
- TextTreeTextElementNode.cs
- DesignerUtils.cs
- IfJoinedCondition.cs
- CompiledRegexRunnerFactory.cs
- IndentedWriter.cs
- PropertyToken.cs
- AttachedPropertyBrowsableAttribute.cs
- BitmapEffectDrawingContextState.cs
- Utilities.cs
- WindowsListViewItemCheckBox.cs
- System.Data_BID.cs
- SettingsPropertyIsReadOnlyException.cs
- FlowLayoutSettings.cs
- WorkerRequest.cs
- MenuItem.cs
- EmbossBitmapEffect.cs
- JpegBitmapEncoder.cs
- ParagraphResult.cs
- SslSecurityTokenParameters.cs
- DelegatingConfigHost.cs
- PlainXmlWriter.cs
- TextSegment.cs
- SignatureDescription.cs
- DrawingAttributeSerializer.cs
- ImagingCache.cs
- PointAnimationUsingPath.cs
- ConstructorBuilder.cs
- FileNotFoundException.cs
- DbConnectionPoolCounters.cs
- SettingsPropertyCollection.cs
- FileFormatException.cs
- InputEventArgs.cs
- DocumentReferenceCollection.cs
- ApplicationBuildProvider.cs
- TcpTransportSecurityElement.cs
- WebErrorHandler.cs
- safelinkcollection.cs
- GACIdentityPermission.cs
- CompoundFileIOPermission.cs
- NavigationProperty.cs
- RadioButton.cs
- TcpClientCredentialType.cs
- CompositeTypefaceMetrics.cs
- ServiceDesigner.cs
- Hex.cs
- SoapRpcMethodAttribute.cs
- WindowsGrip.cs
- ListViewTableCell.cs
- ProbeRequestResponseAsyncResult.cs
- ConstructorBuilder.cs
- VisualTarget.cs
- BidirectionalDictionary.cs
- TypeSource.cs
- ToolStripAdornerWindowService.cs
- DSACryptoServiceProvider.cs
- SafeBuffer.cs
- StorageMappingFragment.cs
- Root.cs
- ClientConfigurationHost.cs
- CodeRegionDirective.cs
- ValidationPropertyAttribute.cs
- ExtendedProperty.cs
- InstrumentationTracker.cs
- ProtocolsConfigurationHandler.cs
- ForwardPositionQuery.cs
- ObjectSpanRewriter.cs
- ContextMenuStrip.cs
- ListItemCollection.cs
- XmlNamespaceManager.cs
- DataGridColumn.cs
- SuppressIldasmAttribute.cs
- ColorBuilder.cs
- DbConnectionPoolIdentity.cs
- VersionedStreamOwner.cs
- SoapSchemaImporter.cs
- EntityException.cs
- SingleTagSectionHandler.cs
- DependencyPropertyDescriptor.cs
- XmlSchemaType.cs
- TableDesigner.cs
- PrintDialog.cs
- SettingsPropertyIsReadOnlyException.cs
- Queue.cs
- WSSecurityOneDotOneReceiveSecurityHeader.cs
- RSAPKCS1KeyExchangeFormatter.cs
- SecurityManager.cs
- VerificationException.cs
- GrammarBuilder.cs
- Repeater.cs
- OracleRowUpdatingEventArgs.cs
- PathSegment.cs
- FontWeight.cs
- LineVisual.cs
- ToolboxBitmapAttribute.cs
- EventToken.cs
- StorageMappingItemLoader.cs
- PersonalizationProvider.cs
- TypeKeyValue.cs
- DeferredTextReference.cs
- FixedDocumentPaginator.cs