BaseParaClient.cs source code in C# .NET

                        
Code:
                         / 4.0 / 4.0 / DEVDIV_TFS / Dev10 / Releases / RTMRel / wpf / src / Framework / MS / Internal / PtsHost / BaseParaClient.cs / 1305600 / BaseParaClient.cs
                        

                        
                            //---------------------------------------------------------------------------- 
//
// Copyright (C) Microsoft Corporation.  All rights reserved.
//
// Description: BaseParagraph provides identity for displayable part of 
//              paragraph in PTS world.
// 
// History: 
//  05/05/2003 : [....] - moving from Avalon branch.
//  10/30/2004 : [....] - ElementReference cleanup. 
//
//---------------------------------------------------------------------------

using System; 
using System.Collections.Generic; // ReadOnlyCollection
using System.Collections; 
using System.Diagnostics; 
using System.Security;
using System.Windows; 
using System.Windows.Documents; // TextPointer
using System.Windows.Media;
using MS.Internal;
using MS.Internal.Documents; // ParagraphResult 
using MS.Internal.Text;
 
using MS.Internal.PtsHost.UnsafeNativeMethods; 

namespace MS.Internal.PtsHost 
{
    // ---------------------------------------------------------------------
    // BaseParagraph provides identity for displayable part of paragraph in
    // PTS world. 
    // ---------------------------------------------------------------------
    internal abstract class BaseParaClient : UnmanagedHandle 
    { 
        //--------------------------------------------------------------------
        // 
        //  Constructors
        //
        //-------------------------------------------------------------------
 
        #region Constructors
 
        // ------------------------------------------------------------------ 
        // Constructor.
        // 
        //      paragraph - Paragraph owner of the ParaClient.
        // ------------------------------------------------------------------
        /// 
        /// Critical - as this invokes the constructor for SecurityCriticalDataForSet. 
        /// Safe - as this just initializes to zero.
        ///  
        [SecurityCritical, SecurityTreatAsSafe] 
        protected BaseParaClient(BaseParagraph paragraph) : base(paragraph.PtsContext)
        { 
            _paraHandle = new SecurityCriticalDataForSet(IntPtr.Zero);
            _paragraph = paragraph;
        }
 
        #endregion Constructors
 
        //------------------------------------------------------------------- 
        //
        //  Internal Methods 
        //
        //--------------------------------------------------------------------

        #region Internal Methods 

        // ----------------------------------------------------------------- 
        // Update internal cache of ParaClient and arrange its content. 
        //
        //      paraDesc - paragraph handle 
        //      rcPara - rectangle of the paragraph
        //      dvrTopSpace - top space calculated as a result of margin
        //                    collapsing
        //      fswdirParent - Flow direction of track 
        // -----------------------------------------------------------------
        ///  
        /// Critical, because: 
        ///     a) calls the setter _paraHandle.Value and passes the parameter it
        ///        gets directly. 
        /// 
        [SecurityCritical]
        internal void Arrange(IntPtr pfspara, PTS.FSRECT rcPara, int dvrTopSpace, uint fswdirParent)
        { 
            // Make sure that paragraph handle (PFSPARA) is set. It is required to query paragraph content.
            Debug.Assert(_paraHandle.Value == IntPtr.Zero || _paraHandle.Value == pfspara); 
            _paraHandle.Value = pfspara; 

            // Set paragraph rectangle (relative to the page) 
            _rect = rcPara;

            // Cache dvrTopSpace
            // Note: currently used only by tight geometry bound calculation code 
            _dvrTopSpace = dvrTopSpace;
 
            // Current page context (used for mirroring and offsets) 
            _pageContext = Paragraph.StructuralCache.CurrentArrangeContext.PageContext;
 
            // Cache flow directions
            _flowDirectionParent = PTS.FswdirToFlowDirection(fswdirParent);
            _flowDirection = (FlowDirection)Paragraph.Element.GetValue(FrameworkElement.FlowDirectionProperty);
 
            // Do paragraph specifc arrange
            OnArrange(); 
        } 

        // ----------------------------------------------------------------- 
        // Returns baseline for first text line
        // ------------------------------------------------------------------
        internal virtual int GetFirstTextLineBaseline()
        { 
            return _rect.v + _rect.dv;
        } 
 
        // -----------------------------------------------------------------
        // Transfer display related information from another ParaClient. 
        //
        //      oldParaClient - another ParaClient
        // ------------------------------------------------------------------
        internal void TransferDisplayInfo(BaseParaClient oldParaClient) 
        {
            Debug.Assert(oldParaClient._visual != null); 
 
            // Transfer visual node ownership
            _visual = oldParaClient._visual; 
            oldParaClient._visual = null;
        }

        // ------------------------------------------------------------------ 
        // Hit tests to the correct IInputElement within the paragraph
        // that the mouse is over. 
        // ----------------------------------------------------------------- 
        internal virtual IInputElement InputHitTest(PTS.FSPOINT pt)
        { 
            return null;
        }

        // ------------------------------------------------------------------ 
        // Returns ArrayList of rectangles for the ContentElement e.
        // Returns empty list if the paraClient does not contain e. 
        // start: int representing start offset of e 
        // length: int representing number of characters occupied by e.
        // parentOffset: indicates offset of parent element. Used only by 
        //               subpage para clients when calculating rectangles
        // -----------------------------------------------------------------
        internal virtual List GetRectangles(ContentElement e, int start, int length)
        { 
            // Return empty collection as default
            return new List(); 
        } 

        // ----------------------------------------------------------------- 
        // Returns rectangles for a the Paragraph element if we have found
        // that it matches the element for which rectangles are needed.
        // Converts the _rect member to the layout DPI and returns it
        // ----------------------------------------------------------------- 
        internal virtual void GetRectanglesForParagraphElement(out List rectangles)
        { 
            rectangles = new List(); 
            // Convert rect from Text DPI values
            Rect rect = TextDpi.FromTextRect(_rect); 

            rectangles.Add(rect);
        }
 
        // ------------------------------------------------------------------
        // Validate visual node associated with paragraph. 
        // 
        //      fskupdInherited - inherited update info
        // ----------------------------------------------------------------- 
        internal virtual void ValidateVisual(PTS.FSKUPDATE fskupdInherited) { }

        // ------------------------------------------------------------------
        // Updates the para content with current viewport 
        //
        // ------------------------------------------------------------------ 
        internal virtual void UpdateViewport(ref PTS.FSRECT viewport) { } 

        // ----------------------------------------------------------------- 
        // Create paragraph result representing this paragraph.
        // ------------------------------------------------------------------
        internal abstract ParagraphResult CreateParagraphResult();
 
        // -----------------------------------------------------------------
        // Return TextContentRange for the content of the paragraph. 
        // ----------------------------------------------------------------- 
        internal abstract TextContentRange GetTextContentRange();
 
        #endregion Internal Methods

        //-------------------------------------------------------------------
        // 
        //  Internal Properties
        // 
        //-------------------------------------------------------------------- 

        #region Internal Properties 

        // -----------------------------------------------------------------
        // Visual associated with paragraph
        // ------------------------------------------------------------------ 
        internal virtual ParagraphVisual Visual
        { 
            get 
            {
                if (_visual == null) 
                {
                    _visual = new ParagraphVisual();
                }
                return _visual; 
            }
        } 
 
        // ------------------------------------------------------------------
        // Is this the first chunk of paginated content. 
        // -----------------------------------------------------------------
        internal virtual bool IsFirstChunk { get { return true; } }

        // ------------------------------------------------------------------ 
        // Is this the last chunk of paginated content.
        // ----------------------------------------------------------------- 
        internal virtual bool IsLastChunk { get { return true; } } 

        // ----------------------------------------------------------------- 
        // Paragraph owner of the ParaClient.
        // -----------------------------------------------------------------
        internal BaseParagraph Paragraph { get { return _paragraph; } }
 
        // ------------------------------------------------------------------
        // Rect of para client 
        // ----------------------------------------------------------------- 
        internal PTS.FSRECT Rect { get { return _rect; } }
 
        internal FlowDirection ThisFlowDirection { get { return _flowDirection; } }
        internal FlowDirection ParentFlowDirection { get { return _flowDirectionParent; } }
        internal FlowDirection PageFlowDirection { get { return Paragraph.StructuralCache.PageFlowDirection; } }
 
        #endregion Internal Properties
 
        //-------------------------------------------------------------------- 
        //
        //  Protected Methods 
        //
        //--------------------------------------------------------------------

        #region Protected Methods 

        // ----------------------------------------------------------------- 
        // Arrange paragraph. 
        // ------------------------------------------------------------------
        protected virtual void OnArrange() 
        {
            Paragraph.UpdateLastFormatPositions();
        }
 
        #endregion Protected Methods
 
        //------------------------------------------------------------------- 
        //
        //  Protected Fields 
        //
        //-------------------------------------------------------------------

        #region Protected Fields 

        // ----------------------------------------------------------------- 
        // Paragraph owner of the ParaClient. 
        // ------------------------------------------------------------------
        protected readonly BaseParagraph _paragraph; 

        // -----------------------------------------------------------------
        // PTS paragraph handle.
        // ------------------------------------------------------------------ 
        /// 
        /// _paraHandle is passed to some Critical PTS functions and will be written 
        /// to directly in managed code.  Hence encapsulating this so all code that 
        /// sets this variable will become critical.
        ///  
        protected SecurityCriticalDataForSet _paraHandle;

        // ------------------------------------------------------------------
        // Rectangle occupied by this portion of the paragraph (relative 
        // to the page).
        // ----------------------------------------------------------------- 
        protected PTS.FSRECT _rect; 

        // ------------------------------------------------------------------ 
        // TopSpace value for the paragraph (margin accumulated
        // during margin collapsing process).
        // -----------------------------------------------------------------
        protected int _dvrTopSpace; 

        // ----------------------------------------------------------------- 
        // Associated visual. 
        // -----------------------------------------------------------------
        protected ParagraphVisual _visual; 

        // ------------------------------------------------------------------
        // Page context
        // ----------------------------------------------------------------- 
        protected PageContext _pageContext;
 
        // ------------------------------------------------------------------ 
        // Cached flow directions
        // ------------------------------------------------------------------ 
        protected FlowDirection _flowDirectionParent;
        protected FlowDirection _flowDirection;

        #endregion Protected Fields 
    }
} 

// 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: BaseParagraph provides identity for displayable part of 
//              paragraph in PTS world.
// 
// History: 
//  05/05/2003 : [....] - moving from Avalon branch.
//  10/30/2004 : [....] - ElementReference cleanup. 
//
//---------------------------------------------------------------------------

using System; 
using System.Collections.Generic; // ReadOnlyCollection
using System.Collections; 
using System.Diagnostics; 
using System.Security;
using System.Windows; 
using System.Windows.Documents; // TextPointer
using System.Windows.Media;
using MS.Internal;
using MS.Internal.Documents; // ParagraphResult 
using MS.Internal.Text;
 
using MS.Internal.PtsHost.UnsafeNativeMethods; 

namespace MS.Internal.PtsHost 
{
    // ---------------------------------------------------------------------
    // BaseParagraph provides identity for displayable part of paragraph in
    // PTS world. 
    // ---------------------------------------------------------------------
    internal abstract class BaseParaClient : UnmanagedHandle 
    { 
        //--------------------------------------------------------------------
        // 
        //  Constructors
        //
        //-------------------------------------------------------------------
 
        #region Constructors
 
        // ------------------------------------------------------------------ 
        // Constructor.
        // 
        //      paragraph - Paragraph owner of the ParaClient.
        // ------------------------------------------------------------------
        /// 
        /// Critical - as this invokes the constructor for SecurityCriticalDataForSet. 
        /// Safe - as this just initializes to zero.
        ///  
        [SecurityCritical, SecurityTreatAsSafe] 
        protected BaseParaClient(BaseParagraph paragraph) : base(paragraph.PtsContext)
        { 
            _paraHandle = new SecurityCriticalDataForSet(IntPtr.Zero);
            _paragraph = paragraph;
        }
 
        #endregion Constructors
 
        //------------------------------------------------------------------- 
        //
        //  Internal Methods 
        //
        //--------------------------------------------------------------------

        #region Internal Methods 

        // ----------------------------------------------------------------- 
        // Update internal cache of ParaClient and arrange its content. 
        //
        //      paraDesc - paragraph handle 
        //      rcPara - rectangle of the paragraph
        //      dvrTopSpace - top space calculated as a result of margin
        //                    collapsing
        //      fswdirParent - Flow direction of track 
        // -----------------------------------------------------------------
        ///  
        /// Critical, because: 
        ///     a) calls the setter _paraHandle.Value and passes the parameter it
        ///        gets directly. 
        /// 
        [SecurityCritical]
        internal void Arrange(IntPtr pfspara, PTS.FSRECT rcPara, int dvrTopSpace, uint fswdirParent)
        { 
            // Make sure that paragraph handle (PFSPARA) is set. It is required to query paragraph content.
            Debug.Assert(_paraHandle.Value == IntPtr.Zero || _paraHandle.Value == pfspara); 
            _paraHandle.Value = pfspara; 

            // Set paragraph rectangle (relative to the page) 
            _rect = rcPara;

            // Cache dvrTopSpace
            // Note: currently used only by tight geometry bound calculation code 
            _dvrTopSpace = dvrTopSpace;
 
            // Current page context (used for mirroring and offsets) 
            _pageContext = Paragraph.StructuralCache.CurrentArrangeContext.PageContext;
 
            // Cache flow directions
            _flowDirectionParent = PTS.FswdirToFlowDirection(fswdirParent);
            _flowDirection = (FlowDirection)Paragraph.Element.GetValue(FrameworkElement.FlowDirectionProperty);
 
            // Do paragraph specifc arrange
            OnArrange(); 
        } 

        // ----------------------------------------------------------------- 
        // Returns baseline for first text line
        // ------------------------------------------------------------------
        internal virtual int GetFirstTextLineBaseline()
        { 
            return _rect.v + _rect.dv;
        } 
 
        // -----------------------------------------------------------------
        // Transfer display related information from another ParaClient. 
        //
        //      oldParaClient - another ParaClient
        // ------------------------------------------------------------------
        internal void TransferDisplayInfo(BaseParaClient oldParaClient) 
        {
            Debug.Assert(oldParaClient._visual != null); 
 
            // Transfer visual node ownership
            _visual = oldParaClient._visual; 
            oldParaClient._visual = null;
        }

        // ------------------------------------------------------------------ 
        // Hit tests to the correct IInputElement within the paragraph
        // that the mouse is over. 
        // ----------------------------------------------------------------- 
        internal virtual IInputElement InputHitTest(PTS.FSPOINT pt)
        { 
            return null;
        }

        // ------------------------------------------------------------------ 
        // Returns ArrayList of rectangles for the ContentElement e.
        // Returns empty list if the paraClient does not contain e. 
        // start: int representing start offset of e 
        // length: int representing number of characters occupied by e.
        // parentOffset: indicates offset of parent element. Used only by 
        //               subpage para clients when calculating rectangles
        // -----------------------------------------------------------------
        internal virtual List GetRectangles(ContentElement e, int start, int length)
        { 
            // Return empty collection as default
            return new List(); 
        } 

        // ----------------------------------------------------------------- 
        // Returns rectangles for a the Paragraph element if we have found
        // that it matches the element for which rectangles are needed.
        // Converts the _rect member to the layout DPI and returns it
        // ----------------------------------------------------------------- 
        internal virtual void GetRectanglesForParagraphElement(out List rectangles)
        { 
            rectangles = new List(); 
            // Convert rect from Text DPI values
            Rect rect = TextDpi.FromTextRect(_rect); 

            rectangles.Add(rect);
        }
 
        // ------------------------------------------------------------------
        // Validate visual node associated with paragraph. 
        // 
        //      fskupdInherited - inherited update info
        // ----------------------------------------------------------------- 
        internal virtual void ValidateVisual(PTS.FSKUPDATE fskupdInherited) { }

        // ------------------------------------------------------------------
        // Updates the para content with current viewport 
        //
        // ------------------------------------------------------------------ 
        internal virtual void UpdateViewport(ref PTS.FSRECT viewport) { } 

        // ----------------------------------------------------------------- 
        // Create paragraph result representing this paragraph.
        // ------------------------------------------------------------------
        internal abstract ParagraphResult CreateParagraphResult();
 
        // -----------------------------------------------------------------
        // Return TextContentRange for the content of the paragraph. 
        // ----------------------------------------------------------------- 
        internal abstract TextContentRange GetTextContentRange();
 
        #endregion Internal Methods

        //-------------------------------------------------------------------
        // 
        //  Internal Properties
        // 
        //-------------------------------------------------------------------- 

        #region Internal Properties 

        // -----------------------------------------------------------------
        // Visual associated with paragraph
        // ------------------------------------------------------------------ 
        internal virtual ParagraphVisual Visual
        { 
            get 
            {
                if (_visual == null) 
                {
                    _visual = new ParagraphVisual();
                }
                return _visual; 
            }
        } 
 
        // ------------------------------------------------------------------
        // Is this the first chunk of paginated content. 
        // -----------------------------------------------------------------
        internal virtual bool IsFirstChunk { get { return true; } }

        // ------------------------------------------------------------------ 
        // Is this the last chunk of paginated content.
        // ----------------------------------------------------------------- 
        internal virtual bool IsLastChunk { get { return true; } } 

        // ----------------------------------------------------------------- 
        // Paragraph owner of the ParaClient.
        // -----------------------------------------------------------------
        internal BaseParagraph Paragraph { get { return _paragraph; } }
 
        // ------------------------------------------------------------------
        // Rect of para client 
        // ----------------------------------------------------------------- 
        internal PTS.FSRECT Rect { get { return _rect; } }
 
        internal FlowDirection ThisFlowDirection { get { return _flowDirection; } }
        internal FlowDirection ParentFlowDirection { get { return _flowDirectionParent; } }
        internal FlowDirection PageFlowDirection { get { return Paragraph.StructuralCache.PageFlowDirection; } }
 
        #endregion Internal Properties
 
        //-------------------------------------------------------------------- 
        //
        //  Protected Methods 
        //
        //--------------------------------------------------------------------

        #region Protected Methods 

        // ----------------------------------------------------------------- 
        // Arrange paragraph. 
        // ------------------------------------------------------------------
        protected virtual void OnArrange() 
        {
            Paragraph.UpdateLastFormatPositions();
        }
 
        #endregion Protected Methods
 
        //------------------------------------------------------------------- 
        //
        //  Protected Fields 
        //
        //-------------------------------------------------------------------

        #region Protected Fields 

        // ----------------------------------------------------------------- 
        // Paragraph owner of the ParaClient. 
        // ------------------------------------------------------------------
        protected readonly BaseParagraph _paragraph; 

        // -----------------------------------------------------------------
        // PTS paragraph handle.
        // ------------------------------------------------------------------ 
        /// 
        /// _paraHandle is passed to some Critical PTS functions and will be written 
        /// to directly in managed code.  Hence encapsulating this so all code that 
        /// sets this variable will become critical.
        ///  
        protected SecurityCriticalDataForSet _paraHandle;

        // ------------------------------------------------------------------
        // Rectangle occupied by this portion of the paragraph (relative 
        // to the page).
        // ----------------------------------------------------------------- 
        protected PTS.FSRECT _rect; 

        // ------------------------------------------------------------------ 
        // TopSpace value for the paragraph (margin accumulated
        // during margin collapsing process).
        // -----------------------------------------------------------------
        protected int _dvrTopSpace; 

        // ----------------------------------------------------------------- 
        // Associated visual. 
        // -----------------------------------------------------------------
        protected ParagraphVisual _visual; 

        // ------------------------------------------------------------------
        // Page context
        // ----------------------------------------------------------------- 
        protected PageContext _pageContext;
 
        // ------------------------------------------------------------------ 
        // Cached flow directions
        // ------------------------------------------------------------------ 
        protected FlowDirection _flowDirectionParent;
        protected FlowDirection _flowDirection;

        #endregion Protected Fields 
    }
} 

// 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

• InternalBufferOverflowException.cs
• ParseHttpDate.cs
• IsolatedStorageFileStream.cs
• Padding.cs
• HandlerFactoryCache.cs
• ListItemParagraph.cs
• ComponentEvent.cs
• XXXInfos.cs
• RequiredFieldValidator.cs
• ColorPalette.cs
• CompleteWizardStep.cs
• Container.cs
• SafeHandles.cs
• CookieHandler.cs
• LicenseContext.cs
• UnsafeNativeMethodsTablet.cs
• Deflater.cs
• UInt32.cs
• EntityTypeEmitter.cs
• CounterSampleCalculator.cs
• TextDocumentView.cs
• SqlNotificationRequest.cs
• HitTestWithPointDrawingContextWalker.cs
• NumberAction.cs
• TextDecoration.cs
• FontFamily.cs
• ResourcePermissionBase.cs
• SystemResourceHost.cs
• TextRangeAdaptor.cs
• IUnknownConstantAttribute.cs
• ConnectionPoint.cs
• CollectionChangeEventArgs.cs
• ApplicationServiceHelper.cs
• FixedTextPointer.cs
• ViewLoader.cs
• PathSegment.cs
• DataControlFieldCell.cs
• XmlSchemaSimpleContent.cs
• IncomingWebResponseContext.cs
• HostedTcpTransportManager.cs
• Rotation3DKeyFrameCollection.cs
• TrustManager.cs
• ExecutedRoutedEventArgs.cs
• XmlILIndex.cs
• KnowledgeBase.cs
• DataControlFieldCollection.cs
• FileEnumerator.cs
• EventMappingSettings.cs
• GetImportFileNameRequest.cs
• OrderByBuilder.cs
• PrinterUnitConvert.cs
• ZipIOZip64EndOfCentralDirectoryBlock.cs
• DataGridPagerStyle.cs
• DomainConstraint.cs
• XmlName.cs
• SecurityPermission.cs
• ObjectListCommand.cs
• VBCodeProvider.cs
• ProgressBarRenderer.cs
• RulePatternOps.cs
• PerformanceCounterPermission.cs
• TripleDES.cs
• BitmapDecoder.cs
• SearchForVirtualItemEventArgs.cs
• XmlQueryStaticData.cs
• ActivityDesignerAccessibleObject.cs
• ChannelSinkStacks.cs
• WsatConfiguration.cs
• BitmapEffectGeneralTransform.cs
• HttpRawResponse.cs
• SelectionProviderWrapper.cs
• HttpFileCollection.cs
• GenericIdentity.cs
• DataSourceXmlClassAttribute.cs
• HttpContext.cs
• SizeChangedEventArgs.cs
• MatcherBuilder.cs
• ImageCodecInfo.cs
• InvalidFilterCriteriaException.cs
• MessageSecurityException.cs
• BitmapImage.cs
• VoiceSynthesis.cs
• FixedSOMElement.cs
• SqlPersistenceProviderFactory.cs
• BindingMAnagerBase.cs
• EntityDataSourceContextDisposingEventArgs.cs
• SQLMembershipProvider.cs
• ObjectMemberMapping.cs
• DataList.cs
• CompilationRelaxations.cs
• TabItem.cs
• AutomationElement.cs
• XmlWrappingWriter.cs
• DataGridViewRowPostPaintEventArgs.cs
• StorageConditionPropertyMapping.cs
• OutArgumentConverter.cs
• HttpRuntime.cs
• CacheEntry.cs
• RootBuilder.cs
• SubclassTypeValidatorAttribute.cs