Code:
/ 4.0 / 4.0 / DEVDIV_TFS / Dev10 / Releases / RTMRel / wpf / src / Core / CSharp / System / Windows / Media / DrawingGroup.cs / 1305600 / DrawingGroup.cs
//----------------------------------------------------------------------------
//
// Copyright (c) Microsoft Corporation. All rights reserved.
//
// Description: DrawingGroup represents a collection of Drawing objects, and
// can apply group-operations such as clip and opacity to it's
// collections
//
// History:
//
// 2004/11/17 : timothyc - Created it.
//
//---------------------------------------------------------------------------
using System;
using System.Windows.Threading;
using MS.Win32;
using System.Security;
using System.Security.Permissions;
using System.Windows.Markup;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Media.Animation;
using System.Windows.Media.Composition;
using System.Windows.Media.Effects;
using System.Diagnostics;
using System.Collections;
using System.Collections.Generic;
using MS.Internal;
using MS.Internal.Media;
using System.Resources;
using MS.Utility;
using System.Runtime.InteropServices;
using MS.Internal.PresentationCore;
using System.ComponentModel.Design.Serialization;
using System.ComponentModel;
using SR = MS.Internal.PresentationCore.SR;
using SRID = MS.Internal.PresentationCore.SRID;
namespace System.Windows.Media
{
///
/// DrawingGroup represents a collection of Drawing objects, and
/// can apply group-operations such as clip and opacity to it's
/// collections.
///
[ContentProperty("Children")]
public sealed partial class DrawingGroup : Drawing
{
#region Constructors
///
/// Default DrawingGroup constructor.
/// Constructs an object with all properties set to their default values.
///
public DrawingGroup()
{
}
#endregion Constructors
#region Public methods
///
/// Opens the DrawingGroup for re-populating it's children, clearing any existing
/// children.
///
///
/// Returns DrawingContext to populate the DrawingGroup's children.
///
public DrawingContext Open()
{
VerifyOpen();
_openedForAppend = false;
return new DrawingGroupDrawingContext(this);
}
///
/// Opens the DrawingGroup for populating it's children, appending to
/// any existing children in the collection.
///
///
/// Returns DrawingContext to populate the DrawingGroup's children.
///
public DrawingContext Append()
{
VerifyOpen();
_openedForAppend = true;
return new DrawingGroupDrawingContext(this);
}
#endregion Public methods
#region Internal methods
///
/// Called by a DrawingContext returned from Open or Append when the content
/// created by it needs to be committed (because DrawingContext.Close/Dispose
/// was called)
///
///
/// Collection containing the Drawing elements created by a DrawingContext
/// returned from Open or Append.
///
internal void Close(DrawingCollection rootDrawingGroupChildren)
{
WritePreamble();
Debug.Assert(_open);
Debug.Assert(rootDrawingGroupChildren != null);
if (!_openedForAppend)
{
// Clear out the previous contents by replacing the current collection with
// the new collection.
//
// When more than one element exists in rootDrawingGroupChildren, the
// DrawingContext had to create this new collection anyways. To behave
// consistently between the one-element and many-element cases,
// we always set Children to a new DrawingCollection instance during Close().
//
// Doing this also avoids having to protect against exceptions being thrown
// from user-code, which could be executed if a Changed event was fired when
// we tried to add elements to a pre-existing collection.
//
// The collection created by the DrawingContext will no longer be
// used after the DrawingContext is closed, so we can take ownership
// of the reference here to avoid any more unneccesary copies.
Children = rootDrawingGroupChildren;
}
else
{
//
//
// Append the collection to the current Children collection
//
//
DrawingCollection children = Children;
//
// Ensure that we can Append to the Children collection
//
if (children == null)
{
throw new InvalidOperationException(SR.Get(SRID.DrawingGroup_CannotAppendToNullCollection));
}
if (children.IsFrozen)
{
throw new InvalidOperationException(SR.Get(SRID.DrawingGroup_CannotAppendToFrozenCollection));
}
// Append the new collection to our current Children.
//
// TransactionalAppend rolls-back the Append operation in the event
// an exception is thrown from the Changed event.
children.TransactionalAppend(rootDrawingGroupChildren);
}
// This DrawingGroup is no longer open
_open = false;
}
///
/// Calls methods on the DrawingContext that are equivalent to the
/// Drawing with the Drawing's current value.
///
internal override void WalkCurrentValue(DrawingContextWalker ctx)
{
int popCount = 0;
// We avoid unneccessary ShouldStopWalking checks based on assumptions
// about when ShouldStopWalking is set. Guard that assumption with an
// assertion.
//
// ShouldStopWalking is currently only set during a hit-test walk after
// an object has been hit. Because a DrawingGroup can't be hit until after
// the first Drawing is tested, this method doesn't check ShouldStopWalking
// until after the first child.
//
// We don't need to add this check to other Drawing subclasses for
// the same reason -- if the Drawing being tested isn't a DrawingGroup,
// they are always the 'first child'.
//
// If this assumption is ever broken then the ShouldStopWalking
// check should be done on the first child -- including in the
// WalkCurrentValue method of other Drawing subclasses.
Debug.Assert(!ctx.ShouldStopWalking);
//
// Draw the transform property
//
// Avoid calling PushTransform if the base value is set to the default and
// no animations have been set on the property.
if (!IsBaseValueDefault(DrawingGroup.TransformProperty) ||
(null != AnimationStorage.GetStorage(this, DrawingGroup.TransformProperty)))
{
ctx.PushTransform(Transform);
popCount++;
}
//
// Draw the clip property
//
// Avoid calling PushClip if the base value is set to the default and
// no animations have been set on the property.
if (!IsBaseValueDefault(DrawingGroup.ClipGeometryProperty) ||
(null != AnimationStorage.GetStorage(this, DrawingGroup.ClipGeometryProperty)))
{
ctx.PushClip(ClipGeometry);
popCount++;
}
//
// Draw the opacity property
//
// Avoid calling PushOpacity if the base value is set to the default and
// no animations have been set on the property.
if (!IsBaseValueDefault(DrawingGroup.OpacityProperty) ||
(null != AnimationStorage.GetStorage(this, DrawingGroup.OpacityProperty)))
{
// Push the current value of the opacity property, which
// is what Opacity returns.
ctx.PushOpacity(Opacity);
popCount++;
}
// Draw the opacity mask property
//
if (OpacityMask != null)
{
ctx.PushOpacityMask(OpacityMask);
popCount++;
}
//
// Draw the effect property
//
// Push the current value of the effect property, which
// is what BitmapEffect returns.
if (BitmapEffect != null)
{
// Disable warning about obsolete method. This code must remain active
// until we can remove the public BitmapEffect APIs.
#pragma warning disable 0618
ctx.PushEffect(BitmapEffect, BitmapEffectInput);
#pragma warning restore 0618
popCount++;
}
//
// Draw the Children collection
//
// Get the current value of the children collection
DrawingCollection collection = Children;
// Call Walk on each child
if (collection != null)
{
for (int i = 0; i < collection.Count; i++)
{
Drawing drawing = collection.Internal_GetItem(i);
if (drawing != null)
{
drawing.WalkCurrentValue(ctx);
// Don't visit the remaining children if the previous
// child caused us to stop walking.
if (ctx.ShouldStopWalking)
{
break;
}
}
}
}
//
// Call Pop() for every Push
//
// Avoid placing this logic in a finally block because if an exception is
// thrown, the Walk is simply aborted. There is no requirement to Walk
// through Pop instructions when an exception is thrown.
//
for (int i = 0; i < popCount; i++)
{
ctx.Pop();
}
}
#endregion Internal methods
#region Private Methods
///
/// Called by both Open() and Append(), this method verifies the
/// DrawingGroup isn't already open, and set's the open flag.
///
private void VerifyOpen()
{
WritePreamble();
// Throw an exception if we are already opened
if (_open)
{
throw new InvalidOperationException(SR.Get(SRID.DrawingGroup_AlreadyOpen));
}
_open = true;
}
#endregion Private Methods
#region Private fields
private bool _openedForAppend;
private bool _open;
#endregion Private fields
}
}
// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
//----------------------------------------------------------------------------
//
// Copyright (c) Microsoft Corporation. All rights reserved.
//
// Description: DrawingGroup represents a collection of Drawing objects, and
// can apply group-operations such as clip and opacity to it's
// collections
//
// History:
//
// 2004/11/17 : timothyc - Created it.
//
//---------------------------------------------------------------------------
using System;
using System.Windows.Threading;
using MS.Win32;
using System.Security;
using System.Security.Permissions;
using System.Windows.Markup;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Media.Animation;
using System.Windows.Media.Composition;
using System.Windows.Media.Effects;
using System.Diagnostics;
using System.Collections;
using System.Collections.Generic;
using MS.Internal;
using MS.Internal.Media;
using System.Resources;
using MS.Utility;
using System.Runtime.InteropServices;
using MS.Internal.PresentationCore;
using System.ComponentModel.Design.Serialization;
using System.ComponentModel;
using SR = MS.Internal.PresentationCore.SR;
using SRID = MS.Internal.PresentationCore.SRID;
namespace System.Windows.Media
{
///
/// DrawingGroup represents a collection of Drawing objects, and
/// can apply group-operations such as clip and opacity to it's
/// collections.
///
[ContentProperty("Children")]
public sealed partial class DrawingGroup : Drawing
{
#region Constructors
///
/// Default DrawingGroup constructor.
/// Constructs an object with all properties set to their default values.
///
public DrawingGroup()
{
}
#endregion Constructors
#region Public methods
///
/// Opens the DrawingGroup for re-populating it's children, clearing any existing
/// children.
///
///
/// Returns DrawingContext to populate the DrawingGroup's children.
///
public DrawingContext Open()
{
VerifyOpen();
_openedForAppend = false;
return new DrawingGroupDrawingContext(this);
}
///
/// Opens the DrawingGroup for populating it's children, appending to
/// any existing children in the collection.
///
///
/// Returns DrawingContext to populate the DrawingGroup's children.
///
public DrawingContext Append()
{
VerifyOpen();
_openedForAppend = true;
return new DrawingGroupDrawingContext(this);
}
#endregion Public methods
#region Internal methods
///
/// Called by a DrawingContext returned from Open or Append when the content
/// created by it needs to be committed (because DrawingContext.Close/Dispose
/// was called)
///
///
/// Collection containing the Drawing elements created by a DrawingContext
/// returned from Open or Append.
///
internal void Close(DrawingCollection rootDrawingGroupChildren)
{
WritePreamble();
Debug.Assert(_open);
Debug.Assert(rootDrawingGroupChildren != null);
if (!_openedForAppend)
{
// Clear out the previous contents by replacing the current collection with
// the new collection.
//
// When more than one element exists in rootDrawingGroupChildren, the
// DrawingContext had to create this new collection anyways. To behave
// consistently between the one-element and many-element cases,
// we always set Children to a new DrawingCollection instance during Close().
//
// Doing this also avoids having to protect against exceptions being thrown
// from user-code, which could be executed if a Changed event was fired when
// we tried to add elements to a pre-existing collection.
//
// The collection created by the DrawingContext will no longer be
// used after the DrawingContext is closed, so we can take ownership
// of the reference here to avoid any more unneccesary copies.
Children = rootDrawingGroupChildren;
}
else
{
//
//
// Append the collection to the current Children collection
//
//
DrawingCollection children = Children;
//
// Ensure that we can Append to the Children collection
//
if (children == null)
{
throw new InvalidOperationException(SR.Get(SRID.DrawingGroup_CannotAppendToNullCollection));
}
if (children.IsFrozen)
{
throw new InvalidOperationException(SR.Get(SRID.DrawingGroup_CannotAppendToFrozenCollection));
}
// Append the new collection to our current Children.
//
// TransactionalAppend rolls-back the Append operation in the event
// an exception is thrown from the Changed event.
children.TransactionalAppend(rootDrawingGroupChildren);
}
// This DrawingGroup is no longer open
_open = false;
}
///
/// Calls methods on the DrawingContext that are equivalent to the
/// Drawing with the Drawing's current value.
///
internal override void WalkCurrentValue(DrawingContextWalker ctx)
{
int popCount = 0;
// We avoid unneccessary ShouldStopWalking checks based on assumptions
// about when ShouldStopWalking is set. Guard that assumption with an
// assertion.
//
// ShouldStopWalking is currently only set during a hit-test walk after
// an object has been hit. Because a DrawingGroup can't be hit until after
// the first Drawing is tested, this method doesn't check ShouldStopWalking
// until after the first child.
//
// We don't need to add this check to other Drawing subclasses for
// the same reason -- if the Drawing being tested isn't a DrawingGroup,
// they are always the 'first child'.
//
// If this assumption is ever broken then the ShouldStopWalking
// check should be done on the first child -- including in the
// WalkCurrentValue method of other Drawing subclasses.
Debug.Assert(!ctx.ShouldStopWalking);
//
// Draw the transform property
//
// Avoid calling PushTransform if the base value is set to the default and
// no animations have been set on the property.
if (!IsBaseValueDefault(DrawingGroup.TransformProperty) ||
(null != AnimationStorage.GetStorage(this, DrawingGroup.TransformProperty)))
{
ctx.PushTransform(Transform);
popCount++;
}
//
// Draw the clip property
//
// Avoid calling PushClip if the base value is set to the default and
// no animations have been set on the property.
if (!IsBaseValueDefault(DrawingGroup.ClipGeometryProperty) ||
(null != AnimationStorage.GetStorage(this, DrawingGroup.ClipGeometryProperty)))
{
ctx.PushClip(ClipGeometry);
popCount++;
}
//
// Draw the opacity property
//
// Avoid calling PushOpacity if the base value is set to the default and
// no animations have been set on the property.
if (!IsBaseValueDefault(DrawingGroup.OpacityProperty) ||
(null != AnimationStorage.GetStorage(this, DrawingGroup.OpacityProperty)))
{
// Push the current value of the opacity property, which
// is what Opacity returns.
ctx.PushOpacity(Opacity);
popCount++;
}
// Draw the opacity mask property
//
if (OpacityMask != null)
{
ctx.PushOpacityMask(OpacityMask);
popCount++;
}
//
// Draw the effect property
//
// Push the current value of the effect property, which
// is what BitmapEffect returns.
if (BitmapEffect != null)
{
// Disable warning about obsolete method. This code must remain active
// until we can remove the public BitmapEffect APIs.
#pragma warning disable 0618
ctx.PushEffect(BitmapEffect, BitmapEffectInput);
#pragma warning restore 0618
popCount++;
}
//
// Draw the Children collection
//
// Get the current value of the children collection
DrawingCollection collection = Children;
// Call Walk on each child
if (collection != null)
{
for (int i = 0; i < collection.Count; i++)
{
Drawing drawing = collection.Internal_GetItem(i);
if (drawing != null)
{
drawing.WalkCurrentValue(ctx);
// Don't visit the remaining children if the previous
// child caused us to stop walking.
if (ctx.ShouldStopWalking)
{
break;
}
}
}
}
//
// Call Pop() for every Push
//
// Avoid placing this logic in a finally block because if an exception is
// thrown, the Walk is simply aborted. There is no requirement to Walk
// through Pop instructions when an exception is thrown.
//
for (int i = 0; i < popCount; i++)
{
ctx.Pop();
}
}
#endregion Internal methods
#region Private Methods
///
/// Called by both Open() and Append(), this method verifies the
/// DrawingGroup isn't already open, and set's the open flag.
///
private void VerifyOpen()
{
WritePreamble();
// Throw an exception if we are already opened
if (_open)
{
throw new InvalidOperationException(SR.Get(SRID.DrawingGroup_AlreadyOpen));
}
_open = true;
}
#endregion Private Methods
#region Private fields
private bool _openedForAppend;
private bool _open;
#endregion Private fields
}
}
// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
Link Menu
This book is available now!
Buy at Amazon US or
Buy at Amazon UK
- SessionStateModule.cs
- RemoteHelper.cs
- FileDetails.cs
- ConfigurationConverterBase.cs
- _WinHttpWebProxyDataBuilder.cs
- MemberAssignmentAnalysis.cs
- HtmlListAdapter.cs
- CodeTypeDelegate.cs
- DataGridViewHitTestInfo.cs
- XmlSchemaSimpleTypeList.cs
- Grant.cs
- XmlDomTextWriter.cs
- AVElementHelper.cs
- OutputScopeManager.cs
- QilInvokeEarlyBound.cs
- CmsInterop.cs
- ValidationHelpers.cs
- ProcessModule.cs
- HwndProxyElementProvider.cs
- complextypematerializer.cs
- ConnectorEditor.cs
- CodePageEncoding.cs
- FormsAuthenticationTicket.cs
- SchemaImporterExtensionElement.cs
- MenuItem.cs
- RadioButton.cs
- ActivityMarkupSerializationProvider.cs
- COM2ExtendedUITypeEditor.cs
- XmlSchemaValidator.cs
- StdRegProviderWrapper.cs
- DecoderNLS.cs
- StyleSheetDesigner.cs
- UInt64.cs
- ObjectKeyFrameCollection.cs
- SolidBrush.cs
- LayoutTable.cs
- XmlBinaryWriter.cs
- XmlNamespaceMappingCollection.cs
- SafeViewOfFileHandle.cs
- EqualityComparer.cs
- DataRowView.cs
- SystemWebCachingSectionGroup.cs
- SHA384.cs
- Point.cs
- XmlTextAttribute.cs
- SafePointer.cs
- WindowsEditBox.cs
- SerializationEventsCache.cs
- TemplateControlCodeDomTreeGenerator.cs
- XmlSerializerVersionAttribute.cs
- ServiceChannelProxy.cs
- ConnectionManagementElementCollection.cs
- DataGridViewCellCancelEventArgs.cs
- HTTPNotFoundHandler.cs
- HiddenFieldPageStatePersister.cs
- FileSystemInfo.cs
- NumberFormatInfo.cs
- ObjectQuery_EntitySqlExtensions.cs
- WebUtil.cs
- HTMLTextWriter.cs
- LockedActivityGlyph.cs
- GroupQuery.cs
- ContractUtils.cs
- ScopelessEnumAttribute.cs
- EntityParameterCollection.cs
- DateTimeSerializationSection.cs
- Size3DValueSerializer.cs
- DataRowView.cs
- DetectRunnableInstancesTask.cs
- HostingPreferredMapPath.cs
- IntPtr.cs
- DomainUpDown.cs
- DataServiceExpressionVisitor.cs
- ImpersonateTokenRef.cs
- TrackingProfileSerializer.cs
- CompilerInfo.cs
- TemplatePropertyEntry.cs
- MetadataProperty.cs
- ThreadPool.cs
- GridToolTip.cs
- DataTable.cs
- WindowsTitleBar.cs
- EntityDataSourceView.cs
- FastPropertyAccessor.cs
- SafeNativeMethods.cs
- ColorConvertedBitmap.cs
- TextOptionsInternal.cs
- RegexStringValidatorAttribute.cs
- DataGridViewComboBoxColumnDesigner.cs
- Matrix.cs
- Object.cs
- WeakReferenceKey.cs
- ErrorTableItemStyle.cs
- SHA384Managed.cs
- ParameterCollection.cs
- ListViewGroupItemCollection.cs
- SubpageParagraph.cs
- StyleXamlTreeBuilder.cs
- ToolStripOverflow.cs
- RelatedPropertyManager.cs