WPF自定義空心文字

原文:WPF自定義空心文字

　　首先創建一個自定義控件，繼承自FrameworkElement，“Generic.xaml”中可以不添加樣式。

　　要自定義空心文字，要用到繪制格式化文本FormattedText類。FormattedText對象提供的文本格式設置功能比WPF提供的已有文本控件提供的相應功能更為強大。調用FormattedText構造函數，可以傳入相應的參數，得到我們想要的文本樣式。使用 MaxTextWidth 屬性可以將文本約束為特定寬度。 文本將自動換行，以避免超過指定寬度。 使用 MaxTextHeight 屬性可以將文本約束為特定高度。 超過指定高度的文本將顯示一個省略號“…”。

　　接下來重寫OnRender方法，在方法體中調用DrawingContext對象的DrawGeometry方法即可完成文本的繪制工作。

?

    public class OutlinedText : FrameworkElement, IAddChild
    {
        /// <summary>
        /// 靜態構造函數
        /// </summary>
        static OutlinedText()
        {
            DefaultStyleKeyProperty.OverrideMetadata(typeof(OutlinedText), new FrameworkPropertyMetadata(typeof(OutlinedText)));
        }


        #region Private Fields

        /// <summary>
        /// 文字幾何形狀
        /// </summary>
        private Geometry m_TextGeometry;

        #endregion


        #region Private Methods

        /// <summary>     
        /// 當依賴項屬性改變文字無效時，創建新的空心文字對象來顯示。
        /// </summary>     
        /// <param name="d"></param>     
        /// <param name="e"></param>     
        private static void OnOutlineTextInvalidated(DependencyObject d, DependencyPropertyChangedEventArgs e)
        {
            if (Convert.ToString(e.NewValue) != Convert.ToString(e.OldValue))
            {
                ((OutlinedText)d).CreateText();
            }
        }

        #endregion


        #region FrameworkElement Overrides

        /// <summary>     
        /// 重寫繪制文字的方法。   
        /// </summary>     
        /// <param name="drawingContext">空心文字控件的繪制上下文。</param>     
        protected override void OnRender(DrawingContext drawingContext)
        {
            //CreateText();
            // 基于設置的屬性繪制空心文字控件。         
            drawingContext.DrawGeometry(Fill, new Pen(Stroke, StrokeThickness), m_TextGeometry);
        }

        /// <summary>     
        /// 基于格式化文字創建文字的幾何輪廓。    
        /// </summary>     
        public void CreateText()
        {
            FontStyle fontStyle = FontStyles.Normal;
            FontWeight fontWeight = FontWeights.Medium;
            if (Bold == true)
                fontWeight = FontWeights.Bold;
            if (Italic == true)
                fontStyle = FontStyles.Italic;
            // 基于設置的屬性集創建格式化的文字。        
            FormattedText formattedText = new FormattedText(
                Text, CultureInfo.GetCultureInfo("en-us"), FlowDirection.LeftToRight,
                new Typeface(Font, fontStyle, fontWeight, FontStretches.Normal),
                FontSize, Brushes.Black);
            formattedText.MaxTextWidth = this.MaxTextWidth;
            formattedText.MaxTextHeight = this.MaxTextHeight;
            // 創建表示文字的幾何對象。        
            m_TextGeometry = formattedText.BuildGeometry(new Point(0, 0));
            // 基于格式化文字的大小設置空心文字的大小。         
            this.MinWidth = formattedText.Width;
            this.MinHeight = formattedText.Height;
        }

        #endregion


        #region DependencyProperties

        /// <summary>
        /// 指定將文本約束為特定寬度
        /// </summary>
        public double MaxTextWidth
        {
            get { return (double)GetValue(MaxTextWidthProperty); }
            set { SetValue(MaxTextWidthProperty, value); }
        }
        /// <summary>
        /// 指定將文本約束為特定寬度依賴屬性
        /// </summary>
        public static readonly DependencyProperty MaxTextWidthProperty =
            DependencyProperty.Register("MaxTextWidth", typeof(double), typeof(OutlinedText),
                new FrameworkPropertyMetadata(1000.0, FrameworkPropertyMetadataOptions.AffectsRender, new PropertyChangedCallback(OnOutlineTextInvalidated), null));

        /// <summary>
        /// 指定將文本約束為特定高度
        /// </summary>
        public double MaxTextHeight
        {
            get { return (double)GetValue(MaxTextHeightProperty); }
            set { SetValue(MaxTextHeightProperty, value); }
        }
        /// <summary>
        /// 指定將文本約束為特定高度依賴屬性
        /// </summary>
        public static readonly DependencyProperty MaxTextHeightProperty =
            DependencyProperty.Register("MaxTextHeight", typeof(double), typeof(OutlinedText),
                 new FrameworkPropertyMetadata(1000.0, FrameworkPropertyMetadataOptions.AffectsRender, new PropertyChangedCallback(OnOutlineTextInvalidated), null));

        /// <summary>     
        /// 指定字體是否加粗。   
        /// </summary>     
        public bool Bold
        {
            get { return (bool)GetValue(BoldProperty); }
            set { SetValue(BoldProperty, value); }
        }
        /// <summary>     
        /// 指定字體是否加粗依賴屬性。    
        /// </summary>     
        public static readonly DependencyProperty BoldProperty = DependencyProperty.Register(
            "Bold", typeof(bool), typeof(OutlinedText),
            new FrameworkPropertyMetadata(false, FrameworkPropertyMetadataOptions.AffectsRender, new PropertyChangedCallback(OnOutlineTextInvalidated), null));

        /// <summary>     
        /// 指定填充字體的畫刷顏色。    
        /// </summary>     
        /// 
        public Brush Fill
        {
            get { return (Brush)GetValue(FillProperty); }
            set { SetValue(FillProperty, value); }
        }
        /// <summary>     
        /// 指定填充字體的畫刷顏色依賴屬性。    
        /// </summary>     
        public static readonly DependencyProperty FillProperty = DependencyProperty.Register(
            "Fill", typeof(Brush), typeof(OutlinedText),
            new FrameworkPropertyMetadata(new SolidColorBrush(Colors.LightSteelBlue), FrameworkPropertyMetadataOptions.AffectsRender, new PropertyChangedCallback(OnOutlineTextInvalidated), null));

        /// <summary>     
        /// 指定文字顯示的字體。   
        /// </summary>    
        public FontFamily Font
        {
            get { return (FontFamily)GetValue(FontProperty); }
            set { SetValue(FontProperty, value); }
        }
        /// <summary>     
        /// 指定文字顯示的字體依賴屬性。     
        /// </summary>     
        public static readonly DependencyProperty FontProperty = DependencyProperty.Register(
            "Font", typeof(FontFamily), typeof(OutlinedText),
            new FrameworkPropertyMetadata(new FontFamily("Arial"), FrameworkPropertyMetadataOptions.AffectsRender, new PropertyChangedCallback(OnOutlineTextInvalidated), null));

        /// <summary>     
        /// 指定字體大小。
        /// </summary>     
        public double FontSize
        {
            get { return (double)GetValue(FontSizeProperty); }
            set { SetValue(FontSizeProperty, value); }
        }
        /// <summary>     
        /// 指定字體大小依賴屬性。     
        /// </summary>     
        public static readonly DependencyProperty FontSizeProperty = DependencyProperty.Register(
            "FontSize", typeof(double), typeof(OutlinedText),
            new FrameworkPropertyMetadata((double)48.0, FrameworkPropertyMetadataOptions.AffectsRender, new PropertyChangedCallback(OnOutlineTextInvalidated), null));

        /// <summary>     
        /// 指定字體是否顯示斜體字體樣式。  
        /// </summary>     
        public bool Italic
        {
            get { return (bool)GetValue(ItalicProperty); }
            set { SetValue(ItalicProperty, value); }
        }
        /// <summary>     
        /// 指定字體是否顯示斜體字體樣式依賴屬性。   
        /// </summary>     
        public static readonly DependencyProperty ItalicProperty = DependencyProperty.Register(
            "Italic", typeof(bool), typeof(OutlinedText),
            new FrameworkPropertyMetadata(false, FrameworkPropertyMetadataOptions.AffectsRender, new PropertyChangedCallback(OnOutlineTextInvalidated), null));

        /// <summary>     
        /// 指定繪制空心字體邊框畫刷的顏色。    
        /// </summary>     
        public Brush Stroke
        {
            get { return (Brush)GetValue(StrokeProperty); }
            set { SetValue(StrokeProperty, value); }
        }
        /// <summary>     
        /// 指定繪制空心字體邊框畫刷的顏色依賴屬性。    
        /// </summary>     
        public static readonly DependencyProperty StrokeProperty = DependencyProperty.Register(
            "Stroke", typeof(Brush), typeof(OutlinedText),
            new FrameworkPropertyMetadata(new SolidColorBrush(Colors.Teal), FrameworkPropertyMetadataOptions.AffectsRender, new PropertyChangedCallback(OnOutlineTextInvalidated), null));

        /// <summary>     
        /// 指定空心字體邊框大小。  
        /// </summary>     
        public ushort StrokeThickness
        {
            get { return (ushort)GetValue(StrokeThicknessProperty); }
            set { SetValue(StrokeThicknessProperty, value); }
        }
        /// <summary>     
        /// 指定空心字體邊框大小依賴屬性。      
        /// </summary>     
        public static readonly DependencyProperty StrokeThicknessProperty =
            DependencyProperty.Register("StrokeThickness",
            typeof(ushort), typeof(OutlinedText),
            new FrameworkPropertyMetadata((ushort)0, FrameworkPropertyMetadataOptions.AffectsRender, new PropertyChangedCallback(OnOutlineTextInvalidated), null));

        /// <summary>    
        /// 指定要顯示的文字字符串。  
        /// </summary>     
        public string Text
        {
            get { return (string)GetValue(TextProperty); }
            set { SetValue(TextProperty, value); }
        }
        /// <summary>     
        /// 指定要顯示的文字字符串依賴屬性。  
        ///  </summary>    
        public static readonly DependencyProperty TextProperty = DependencyProperty.Register(
            "Text", typeof(string), typeof(OutlinedText),
            new FrameworkPropertyMetadata("",
                FrameworkPropertyMetadataOptions.AffectsRender,
                new PropertyChangedCallback(OnOutlineTextInvalidated),
                null));

        #endregion


        #region Public Methods

        /// <summary>
        /// 添加子對象。
        /// </summary>
        /// <param name="value">要添加的子對象。</param>
        public void AddChild(Object value)
        { }

        /// <summary>
        /// 將節點的文字內容添加到對象。
        /// </summary>
        /// <param name="value">要添加到對象的文字。</param>
        public void AddText(string value)
        {
            Text = value;
        }

        #endregion
    }

?

?

?源碼下載

?