Code:
/ DotNET / DotNET / 8.0 / untmp / whidbey / REDBITS / ndp / fx / src / Designer / WinForms / System / WinForms / Design / Behavior / SnapLine.cs / 1 / SnapLine.cs
namespace System.Windows.Forms.Design.Behavior { using System; using System.Collections; using System.ComponentModel; using System.ComponentModel.Design; using System.Design; using System.Diagnostics; using System.Drawing; using System.Windows.Forms.Design; ////// /// The SnapLine class represents a UI-guideline that will be rendered /// during control movement (drag, keyboard, and resize) operations. /// SnapLines will assist a user in aligning controls relative to one /// one another. Each SnapLine will have a type: top, bottom, etc... /// Only SnapLines of like-types are allowed to align with each other. /// The 'offset' will represent the distance from the origin (upper-left /// corner) of the control to where the SnapLine is located. And finally /// the 'filter' is a string used to define custome types of SnapLines. /// This enables a SnapLine with a filter of "TypeX" to only snap to /// other "TypeX" filtered lines. /// public sealed class SnapLine { private SnapLineType type;//the type of SnapLine private SnapLinePriority priority;//priority of the line private int offset;//distance, in pixels, from the origin of the control to the snap location private string filter;//used to specifiy custom SnapLine types //These are used in the SnapLine filter to define custom margin/padding SnapLines. //Margins will have special rules of equality, basically opposites will attract one another //(ex: margin right == margin left) and paddings will be attracted to like-margins. internal const string Margin = "Margin"; internal const string MarginRight = Margin + ".Right"; internal const string MarginLeft = Margin + ".Left"; internal const string MarginBottom = Margin + ".Bottom"; internal const string MarginTop = Margin + ".Top"; internal const string Padding = "Padding"; internal const string PaddingRight = Padding + ".Right"; internal const string PaddingLeft = Padding + ".Left"; internal const string PaddingBottom = Padding + ".Bottom"; internal const string PaddingTop = Padding + ".Top"; ////// /// SnapLine constructor that takes the type and offset of SnapLine. /// public SnapLine(SnapLineType type, int offset) : this(type, offset, null, SnapLinePriority.Low) { } ////// /// SnapLine constructor that takes the type, offset and filter of SnapLine. /// public SnapLine(SnapLineType type, int offset, string filter) : this(type, offset, filter, SnapLinePriority.Low) { } ////// /// SnapLine constructor that takes the type, offset, and priority of SnapLine. /// public SnapLine(SnapLineType type, int offset, SnapLinePriority priority) : this(type, offset, null, priority) { } ////// /// SnapLine constructor that takes the type, offset, filter, and priority of the SnapLine. /// public SnapLine(SnapLineType type, int offset, string filter, SnapLinePriority priority) { this.type = type; this.offset = offset; this.filter = filter; this.priority = priority; } ////// /// This property returns a string representing an optional user-defined filter. /// Setting this filter will allow only those SnapLines with similar filters to align /// to one another. /// public string Filter { get { return filter; } } ////// /// Returns true if the SnapLine is of a horizontal type. /// public bool IsHorizontal { get { return (type == SnapLineType.Top || type == SnapLineType.Bottom || type == SnapLineType.Horizontal ||type == SnapLineType.Baseline); } } ////// /// Returns true if the SnapLine is of a vertical type. /// public bool IsVertical { get { return (type == SnapLineType.Left || type == SnapLineType.Right ||type == SnapLineType.Vertical); } } ////// /// Read-only property that returns the distance from the origin to where this SnapLine is defined. /// public int Offset { get { return offset; } } ////// /// Read-only property that returns the priority of the SnapLine. /// public SnapLinePriority Priority { get { return priority; } } ////// /// Read-only property that represents the 'type' of SnapLine. /// public SnapLineType SnapLineType { get { return type; } } ////// /// Adjusts the offset property of the SnapLine. /// public void AdjustOffset(int adjustment) { offset += adjustment; } ////// /// Returns true if SnapLine s1 should snap to SnapLine s2. /// public static bool ShouldSnap(SnapLine line1, SnapLine line2) { //types must first be equal if (line1.SnapLineType != line2.SnapLineType) { return false; } //if the filters are both null - then return true if ((line1.Filter == null && line2.Filter == null)) { return true; } //at least one filter is non-null so if the other is null //then we don't have a match if (line1.Filter == null || line2.Filter == null) { return false; } //check for our special-cased margin filter if (line1.Filter.Contains(Margin)) { if (line1.Filter.Equals(MarginRight) && (line2.Filter.Equals(MarginLeft) ||line2.Filter.Equals(PaddingRight)) || line1.Filter.Equals(MarginLeft) && (line2.Filter.Equals(MarginRight) ||line2.Filter.Equals(PaddingLeft)) || line1.Filter.Equals(MarginTop) && (line2.Filter.Equals(MarginBottom) ||line2.Filter.Equals(PaddingTop)) || line1.Filter.Equals(MarginBottom) && (line2.Filter.Equals(MarginTop)) ||line2.Filter.Equals(PaddingBottom)) { return true; } return false; } //check for padding & margins if (line1.Filter.Contains(Padding)) { if (line1.Filter.Equals(PaddingLeft) && line2.Filter.Equals(MarginLeft) || line1.Filter.Equals(PaddingRight) && line2.Filter.Equals(MarginRight) || line1.Filter.Equals(PaddingTop) && line2.Filter.Equals(MarginTop) || line1.Filter.Equals(PaddingBottom) && line2.Filter.Equals(MarginBottom)) { return true; } return false; } //basic filter equality if (line1.Filter.Equals(line2.Filter)) { return true; } //not equal! return false; } ////// /// ToString implementation for SnapLines. /// public override string ToString() { return "SnapLine: {type = " + type + ", offset = " + offset + ", priority = " + priority + ", filter = " + (filter == null ? "" : filter) + "}"; } } } // 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
- TemplateControlParser.cs
- Model3DCollection.cs
- XmlSchemaExporter.cs
- SchemaElementLookUpTable.cs
- InheritanceContextHelper.cs
- RTTrackingProfile.cs
- ApplicationFileCodeDomTreeGenerator.cs
- ImageDrawing.cs
- SlipBehavior.cs
- XmlSortKeyAccumulator.cs
- LogManagementAsyncResult.cs
- DetailsViewModeEventArgs.cs
- HttpInputStream.cs
- VariantWrapper.cs
- ColumnClickEvent.cs
- MatrixKeyFrameCollection.cs
- ErrorWebPart.cs
- BitmapEffect.cs
- RegistrySecurity.cs
- StringHandle.cs
- EnumerationRangeValidationUtil.cs
- ToggleButton.cs
- SQLInt32Storage.cs
- NotImplementedException.cs
- Signature.cs
- EmptyEnumerator.cs
- HtmlTableRow.cs
- DataControlImageButton.cs
- MultiBinding.cs
- Assembly.cs
- WorkflowControlEndpoint.cs
- ControlLocalizer.cs
- WsdlParser.cs
- TagNameToTypeMapper.cs
- figurelengthconverter.cs
- BaseProcessor.cs
- ByteKeyFrameCollection.cs
- ResolveDuplex11AsyncResult.cs
- XPathMessageFilterElement.cs
- Substitution.cs
- InheritablePropertyChangeInfo.cs
- MemberListBinding.cs
- TextElementCollection.cs
- LinkUtilities.cs
- RootBrowserWindow.cs
- ObjectRef.cs
- LogExtentCollection.cs
- GenericIdentity.cs
- WebBrowserProgressChangedEventHandler.cs
- Exceptions.cs
- PropertyRecord.cs
- HttpModulesSection.cs
- BasicHttpSecurityElement.cs
- TextRenderer.cs
- EventDescriptor.cs
- DiscreteKeyFrames.cs
- ProxyGenerationError.cs
- TimeSpanMinutesConverter.cs
- ConfigurationSectionCollection.cs
- Compilation.cs
- DataGridAutoFormat.cs
- DataListItemEventArgs.cs
- SystemThemeKey.cs
- TextDataBindingHandler.cs
- WmlLiteralTextAdapter.cs
- DelegateHelpers.Generated.cs
- PrintPreviewDialog.cs
- SqlCachedBuffer.cs
- InternalCompensate.cs
- RoleManagerEventArgs.cs
- TextLine.cs
- Profiler.cs
- TypeReference.cs
- MultipartContentParser.cs
- TextElementCollection.cs
- SelectQueryOperator.cs
- PersonalizationProviderHelper.cs
- BitmapCodecInfoInternal.cs
- TripleDESCryptoServiceProvider.cs
- ClientType.cs
- CellConstant.cs
- Vertex.cs
- ClientRoleProvider.cs
- Coordinator.cs
- StreamResourceInfo.cs
- PointConverter.cs
- ASCIIEncoding.cs
- Hash.cs
- ToggleButtonAutomationPeer.cs
- NameScopePropertyAttribute.cs
- FileSecurity.cs
- TextSelectionHelper.cs
- OleDbEnumerator.cs
- ObjectListDesigner.cs
- DuplicateWaitObjectException.cs
- WebPartConnectVerb.cs
- Rect.cs
- SystemWebExtensionsSectionGroup.cs
- TextEditorThreadLocalStore.cs
- Resources.Designer.cs