WPF-FrameworkElement

#region 程序集 PresentationFramework, Version=10.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
// C:\Program Files\dotnet\packs\Microsoft.WindowsDesktop.App.Ref\10.0.9\ref\net10.0\PresentationFramework.dll
#endregion

using System.Collections;
using System.ComponentModel;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Input;
using System.Windows.Markup;
using System.Windows.Media;
using System.Windows.Media.Animation;

namespace System.Windows
{
    //
    // 摘要:
    //     Provides a WPF framework-level set of properties, events, and methods for Windows
    //     Presentation Foundation (WPF) elements. This class represents the provided WPF
    //     framework-level implementation that is built on the WPF core-level APIs that
    //     are defined by System.Windows.UIElement.
    [RuntimeNameProperty("Name")]
    [StyleTypedProperty(Property = "FocusVisualStyle", StyleTargetType = typeof(Control))]
    [UsableDuringInitialization(true)]
    [XmlLangProperty("Language")]
    public class FrameworkElement : UIElement, ISupportInitialize, IFrameworkInputElement, IInputElement, IQueryAmbient
    {
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.ActualHeight dependency property.
        public static readonly DependencyProperty ActualHeightProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.MaxWidth dependency property.
        public static readonly DependencyProperty MaxWidthProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.MinHeight dependency property.
        public static readonly DependencyProperty MinHeightProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.MinWidth dependency property.
        public static readonly DependencyProperty MinWidthProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.Name dependency property.
        public static readonly DependencyProperty NameProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.OverridesDefaultStyle dependency
        //     property.
        public static readonly DependencyProperty OverridesDefaultStyleProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.RequestBringIntoView routed event.
        public static readonly RoutedEvent RequestBringIntoViewEvent;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.SizeChanged routed event.
        public static readonly RoutedEvent SizeChangedEvent;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.Style dependency property.
        public static readonly DependencyProperty StyleProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.ToolTipClosing routed event.
        public static readonly RoutedEvent ToolTipClosingEvent;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.ToolTipOpening routed event.
        public static readonly RoutedEvent ToolTipOpeningEvent;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.ToolTip dependency property.
        public static readonly DependencyProperty ToolTipProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.Unloaded routed event.
        public static readonly RoutedEvent UnloadedEvent;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.UseLayoutRounding dependency property.
        public static readonly DependencyProperty UseLayoutRoundingProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.VerticalAlignment dependency property.
        public static readonly DependencyProperty VerticalAlignmentProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.Width dependency property.
        public static readonly DependencyProperty WidthProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.MaxHeight dependency property.
        public static readonly DependencyProperty MaxHeightProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.Margin dependency property.
        public static readonly DependencyProperty MarginProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.Tag dependency property.
        public static readonly DependencyProperty TagProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.LayoutTransform dependency property.
        public static readonly DependencyProperty LayoutTransformProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.Loaded routed event.
        public static readonly RoutedEvent LoadedEvent;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.ActualWidth dependency property.
        public static readonly DependencyProperty ActualWidthProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.BindingGroup dependency property.
        public static readonly DependencyProperty BindingGroupProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.ContextMenuClosing routed event.
        public static readonly RoutedEvent ContextMenuClosingEvent;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.ContextMenu dependency property.
        public static readonly DependencyProperty ContextMenuProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.Cursor dependency property.
        public static readonly DependencyProperty CursorProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.DataContext dependency property.
        public static readonly DependencyProperty DataContextProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.ContextMenuOpening routed event.
        public static readonly RoutedEvent ContextMenuOpeningEvent;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.FlowDirection dependency property.
        public static readonly DependencyProperty FlowDirectionProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.FocusVisualStyle dependency property.
        public static readonly DependencyProperty FocusVisualStyleProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.ForceCursor dependency property.
        public static readonly DependencyProperty ForceCursorProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.Height dependency property.
        public static readonly DependencyProperty HeightProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.HorizontalAlignment dependency
        //     property.
        public static readonly DependencyProperty HorizontalAlignmentProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.InputScope dependency property.
        public static readonly DependencyProperty InputScopeProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.Language dependency property.
        public static readonly DependencyProperty LanguageProperty;
        //
        // 摘要:
        //     Identifies the System.Windows.FrameworkElement.DefaultStyleKey dependency property.
        protected internal static readonly DependencyProperty DefaultStyleKeyProperty;

        //
        // 摘要:
        //     Initializes a new instance of the System.Windows.FrameworkElement class.
        public FrameworkElement();

        //
        // 摘要:
        //     Gets or sets localization/globalization language information that applies to
        //     an element.
        //
        // 返回结果:
        //     The language information for this element. The default value is an System.Windows.Markup.XmlLanguage
        //     with its System.Windows.Markup.XmlLanguage.IetfLanguageTag value set to the string
        //     "en-US".
        public XmlLanguage Language { get; set; }
        //
        // 摘要:
        //     Gets or sets a graphics transformation that should apply to this element when
        //     layout is performed.
        //
        // 返回结果:
        //     The transform this element should use. The default is System.Windows.Media.Transform.Identity.
        public Transform LayoutTransform { get; set; }
        //
        // 摘要:
        //     Gets or sets the outer margin of an element.
        //
        // 返回结果:
        //     Provides margin values for the element. The default value is a System.Windows.Thickness
        //     with all properties equal to 0 (zero).
        public Thickness Margin { get; set; }
        //
        // 摘要:
        //     Gets or sets the minimum width constraint of the element.
        //
        // 返回结果:
        //     The minimum width of the element, in device-independent units (1/96th inch per
        //     unit). The default value is 0.0. This value can be any value equal to or greater
        //     than 0.0. However, System.Double.PositiveInfinity is not valid, nor is System.Double.NaN.
        [Localizability(LocalizationCategory.None, Readability = Readability.Unreadable)]
        [TypeConverter(typeof(LengthConverter))]
        public double MinWidth { get; set; }
        //
        // 摘要:
        //     Gets or sets the maximum width constraint of the element.
        //
        // 返回结果:
        //     The maximum width of the element, in device-independent units (1/96th inch per
        //     unit). The default value is System.Double.PositiveInfinity. This value can be
        //     any value equal to or greater than 0.0. System.Double.PositiveInfinity is also
        //     valid.
        [Localizability(LocalizationCategory.None, Readability = Readability.Unreadable)]
        [TypeConverter(typeof(LengthConverter))]
        public double MaxWidth { get; set; }
        //
        // 摘要:
        //     Gets or sets the minimum height constraint of the element.
        //
        // 返回结果:
        //     The minimum height of the element, in device-independent units (1/96th inch per
        //     unit). The default value is 0.0. This value can be any value equal to or greater
        //     than 0.0. However, System.Double.PositiveInfinity is NOT valid, nor is System.Double.NaN.
        [Localizability(LocalizationCategory.None, Readability = Readability.Unreadable)]
        [TypeConverter(typeof(LengthConverter))]
        public double MinHeight { get; set; }
        //
        // 摘要:
        //     Gets a value that indicates whether this element has been loaded for presentation.
        //
        //
        // 返回结果:
        //     true if the current element is attached to an element tree; false if the element
        //     has never been attached to a loaded element tree.
        public bool IsLoaded { get; }
        //
        // 摘要:
        //     Gets or sets the maximum height constraint of the element.
        //
        // 返回结果:
        //     The maximum height of the element, in device-independent units (1/96th inch per
        //     unit). The default value is System.Double.PositiveInfinity. This value can be
        //     any value equal to or greater than 0.0. System.Double.PositiveInfinity is also
        //     valid.
        [Localizability(LocalizationCategory.None, Readability = Readability.Unreadable)]
        [TypeConverter(typeof(LengthConverter))]
        public double MaxHeight { get; set; }
        //
        // 摘要:
        //     Gets a value that indicates whether this element has been initialized, either
        //     during processing by a XAML processor, or by explicitly having its System.Windows.FrameworkElement.EndInit
        //     method called.
        //
        // 返回结果:
        //     true if the element is initialized per the aforementioned XAML processing or
        //     method calls; otherwise, false.
        [EditorBrowsable(EditorBrowsableState.Advanced)]
        public bool IsInitialized { get; }
        //
        // 摘要:
        //     Gets or sets the context menu element that should appear whenever the context
        //     menu is requested through user interface (UI) from within this element.
        //
        // 返回结果:
        //     The context menu assigned to this element.
        public ContextMenu ContextMenu { get; set; }
        //
        // 摘要:
        //     Gets or sets the horizontal alignment characteristics applied to this element
        //     when it is composed within a parent element, such as a panel or items control.
        //
        //
        // 返回结果:
        //     A horizontal alignment setting, as a value of the enumeration. The default is
        //     System.Windows.HorizontalAlignment.Stretch.
        public HorizontalAlignment HorizontalAlignment { get; set; }
        //
        // 摘要:
        //     Gets or sets the suggested height of the element.
        //
        // 返回结果:
        //     The height of the element, in device-independent units (1/96th inch per unit).
        //     The default value is System.Double.NaN. This value must be equal to or greater
        //     than 0.0.
        [Localizability(LocalizationCategory.None, Readability = Readability.Unreadable)]
        [TypeConverter(typeof(LengthConverter))]
        public double Height { get; set; }
        //
        // 摘要:
        //     Gets or sets a value that indicates whether this System.Windows.FrameworkElement
        //     should force the user interface (UI) to render the cursor as declared by the
        //     System.Windows.FrameworkElement.Cursor property.
        //
        // 返回结果:
        //     true if cursor presentation while over this element is forced to use current
        //     System.Windows.FrameworkElement.Cursor settings for the cursor (including on
        //     all child elements); otherwise false. The default value is false.
        public bool ForceCursor { get; set; }
        //
        // 摘要:
        //     Gets or sets a property that enables customization of appearance, effects, or
        //     other style characteristics that will apply to this element when it captures
        //     keyboard focus.
        //
        // 返回结果:
        //     The desired style to apply on focus. The default value as declared in the dependency
        //     property is an empty static System.Windows.Style. However, the effective value
        //     at run time is often (but not always) a style as supplied by theme support for
        //     controls.
        public Style FocusVisualStyle { get; set; }
        //
        // 摘要:
        //     Gets or sets the direction that text and other user interface (UI) elements flow
        //     within any parent element that controls their layout.
        //
        // 返回结果:
        //     The direction that text and other UI elements flow within their parent element,
        //     as a value of the enumeration. The default value is System.Windows.FlowDirection.LeftToRight.
        [Localizability(LocalizationCategory.None)]
        public FlowDirection FlowDirection { get; set; }
        //
        // 摘要:
        //     Gets or sets the data context for an element when it participates in data binding.
        //
        //
        // 返回结果:
        //     The object to use as data context.
        [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
        [Localizability(LocalizationCategory.NeverLocalize)]
        public object DataContext { get; set; }
        //
        // 摘要:
        //     Gets or sets the cursor that displays when the mouse pointer is over this element.
        //
        //
        // 返回结果:
        //     The cursor to display. The default value is defined as null per this dependency
        //     property. However, the practical default at run time will come from a variety
        //     of factors.
        public Cursor Cursor { get; set; }
        //
        // 摘要:
        //     Gets or sets the System.Windows.Data.BindingGroup that is used for the element.
        //
        //
        // 返回结果:
        //     The System.Windows.Data.BindingGroup that is used for the element.
        [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
        [Localizability(LocalizationCategory.NeverLocalize)]
        public BindingGroup BindingGroup { get; set; }
        //
        // 摘要:
        //     Gets or sets the identifying name of the element. The name provides a reference
        //     so that code-behind, such as event handler code, can refer to a markup element
        //     after it is constructed during processing by a XAML processor.
        //
        // 返回结果:
        //     The name of the element. The default is an empty string.
        [DesignerSerializationOptions(DesignerSerializationOptions.SerializeAsAttribute)]
        [Localizability(LocalizationCategory.NeverLocalize)]
        [MergableProperty(false)]
        public string Name { get; set; }
        //
        // 摘要:
        //     Gets or sets the context for input used by this System.Windows.FrameworkElement.
        //
        //
        // 返回结果:
        //     The input scope, which modifies how input from alternative input methods is interpreted.
        //     The default value is null (which results in a default handling of commands).
        public InputScope InputScope { get; set; }
        //
        // 摘要:
        //     Gets or sets a value that indicates whether this element incorporates style properties
        //     from theme styles.
        //
        // 返回结果:
        //     true if this element does not use theme style properties; all style-originating
        //     properties come from local application styles, and theme style properties do
        //     not apply. false if application styles apply first, and then theme styles apply
        //     for properties that were not specifically set in application styles. The default
        //     is false.
        public bool OverridesDefaultStyle { get; set; }
        //
        // 摘要:
        //     Gets the rendered height of this element.
        //
        // 返回结果:
        //     The element's height, as a value in device-independent units (1/96th inch per
        //     unit). The default value is 0 (zero).
        public double ActualHeight { get; }
        //
        // 摘要:
        //     Gets or sets the locally-defined resource dictionary.
        //
        // 返回结果:
        //     The current locally-defined dictionary of resources, where each resource can
        //     be accessed by key.
        [Ambient]
        public ResourceDictionary Resources { get; set; }
        //
        // 摘要:
        //     Gets or sets the style used by this element when it is rendered.
        //
        // 返回结果:
        //     The applied, nondefault style for the element, if present. Otherwise, null. The
        //     default for a default-constructed System.Windows.FrameworkElement is null.
        public Style Style { get; set; }
        //
        // 摘要:
        //     Gets or sets an arbitrary object value that can be used to store custom information
        //     about this element.
        //
        // 返回结果:
        //     The intended value. This property has no default value.
        [Localizability(LocalizationCategory.NeverLocalize)]
        public object Tag { get; set; }
        //
        // 摘要:
        //     Gets a reference to the template parent of this element. This property is not
        //     relevant if the element was not created through a template.
        //
        // 返回结果:
        //     The element whose System.Windows.FrameworkTemplateSystem.Windows.FrameworkTemplate.VisualTree
        //     caused this element to be created. This value is frequently null.
        public DependencyObject TemplatedParent { get; }
        //
        // 摘要:
        //     Gets or sets the tool-tip object that is displayed for this element in the user
        //     interface (UI).
        //
        // 返回结果:
        //     The tooltip object.
        [Bindable(true)]
        [Category("Appearance")]
        [Localizability(LocalizationCategory.ToolTip)]
        public object ToolTip { get; set; }
        //
        // 摘要:
        //     Gets the collection of triggers established directly on this element, or in child
        //     elements.
        //
        // 返回结果:
        //     A strongly typed collection of System.Windows.Trigger objects.
        [DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
        public TriggerCollection Triggers { get; }
        //
        // 摘要:
        //     Gets or sets a value that indicates whether layout rounding should be applied
        //     to this element's size and position during layout.
        //
        // 返回结果:
        //     true if layout rounding is applied; otherwise, false. The default is false.
        public bool UseLayoutRounding { get; set; }
        //
        // 摘要:
        //     Gets or sets the vertical alignment characteristics applied to this element when
        //     it is composed within a parent element such as a panel or items control.
        //
        // 返回结果:
        //     A vertical alignment setting. The default is System.Windows.VerticalAlignment.Stretch.
        public VerticalAlignment VerticalAlignment { get; set; }
        //
        // 摘要:
        //     Gets or sets the width of the element.
        //
        // 返回结果:
        //     The width of the element, in device-independent units (1/96th inch per unit).
        //     The default value is System.Double.NaN. This value must be equal to or greater
        //     than 0.0. See Remarks for upper bound information.
        [Localizability(LocalizationCategory.None, Readability = Readability.Unreadable)]
        [TypeConverter(typeof(LengthConverter))]
        public double Width { get; set; }
        //
        // 摘要:
        //     Gets the rendered width of this element.
        //
        // 返回结果:
        //     The element's width, as a value in device-independent units (1/96th inch per
        //     unit). The default value is 0 (zero).
        public double ActualWidth { get; }
        //
        // 摘要:
        //     Gets the logical parent element of this element.
        //
        // 返回结果:
        //     This element's logical parent.
        public DependencyObject Parent { get; }
        //
        // 摘要:
        //     Gets the number of visual child elements within this element.
        //
        // 返回结果:
        //     The number of visual child elements for this element.
        protected override int VisualChildrenCount { get; }
        //
        // 摘要:
        //     Gets or sets the key to use to reference the style for this control, when theme
        //     styles are used or defined.
        //
        // 返回结果:
        //     The style key. To work correctly as part of theme style lookup, this value is
        //     expected to be the System.Type of the control being styled.
        protected internal object DefaultStyleKey { get; set; }
        //
        // 摘要:
        //     Gets or sets the scope limits for property value inheritance, resource key lookup,
        //     and RelativeSource FindAncestor lookup.
        //
        // 返回结果:
        //     A value of the enumeration. The default is System.Windows.InheritanceBehavior.Default.
        protected internal InheritanceBehavior InheritanceBehavior { get; set; }
        //
        // 摘要:
        //     Gets an enumerator for logical child elements of this element.
        //
        // 返回结果:
        //     An enumerator for logical child elements of this element.
        protected internal virtual IEnumerator LogicalChildren { get; }

        //
        // 摘要:
        //     Occurs when the data context for this element changes.
        public event DependencyPropertyChangedEventHandler DataContextChanged;
        //
        // 摘要:
        //     Occurs when this System.Windows.FrameworkElement is initialized. This event coincides
        //     with cases where the value of the System.Windows.FrameworkElement.IsInitialized
        //     property changes from false (or undefined) to true.
        [EditorBrowsable(EditorBrowsableState.Advanced)]
        public event EventHandler Initialized;
        //
        // 摘要:
        //     Occurs when the element is laid out, rendered, and ready for interaction.
        public event RoutedEventHandler Loaded;
        //
        // 摘要:
        //     Occurs just before any context menu on the element is closed.
        public event ContextMenuEventHandler ContextMenuClosing;
        //
        // 摘要:
        //     Occurs when either the System.Windows.FrameworkElement.ActualHeight or the System.Windows.FrameworkElement.ActualWidth
        //     properties change value on this element.
        public event SizeChangedEventHandler SizeChanged;
        //
        // 摘要:
        //     Occurs when the source value changes for any existing property binding on this
        //     element.
        public event EventHandler<DataTransferEventArgs> SourceUpdated;
        //
        // 摘要:
        //     Occurs when the target value changes for any property binding on this element.
        public event EventHandler<DataTransferEventArgs> TargetUpdated;
        //
        // 摘要:
        //     Occurs just before any tooltip on the element is closed.
        public event ToolTipEventHandler ToolTipClosing;
        //
        // 摘要:
        //     Occurs when any context menu on the element is opened.
        public event ContextMenuEventHandler ContextMenuOpening;
        //
        // 摘要:
        //     Occurs when System.Windows.FrameworkElement.BringIntoView(System.Windows.Rect)
        //     is called on this element.
        public event RequestBringIntoViewEventHandler RequestBringIntoView;
        //
        // 摘要:
        //     Occurs when the element is removed from within an element tree of loaded elements.
        public event RoutedEventHandler Unloaded;
        //
        // 摘要:
        //     Occurs when any tooltip on the element is opened.
        public event ToolTipEventHandler ToolTipOpening;

        //
        // 摘要:
        //     Gets the value of the System.Windows.FrameworkElement.FlowDirection attached
        //     property for the specified System.Windows.DependencyObject.
        //
        // 参数:
        //   element:
        //     The element to return a System.Windows.FrameworkElement.FlowDirection for.
        //
        // 返回结果:
        //     The requested flow direction, as a value of the enumeration.
        public static FlowDirection GetFlowDirection(DependencyObject element);
        //
        // 摘要:
        //     Sets the value of the System.Windows.FrameworkElement.FlowDirection attached
        //     property for the provided element.
        //
        // 参数:
        //   element:
        //     The element that specifies a flow direction.
        //
        //   value:
        //     A value of the enumeration, specifying the direction.
        public static void SetFlowDirection(DependencyObject element, FlowDirection value);
        //
        // 摘要:
        //     Builds the current template's visual tree if necessary, and returns a value that
        //     indicates whether the visual tree was rebuilt by this call.
        //
        // 返回结果:
        //     true if visuals were added to the tree; returns false otherwise.
        public bool ApplyTemplate();
        //
        // 摘要:
        //     Starts the initialization process for this element.
        public virtual void BeginInit();
        //
        // 摘要:
        //     Begins the sequence of actions contained in the provided storyboard, with specified
        //     state for control of the animation after it is started.
        //
        // 参数:
        //   storyboard:
        //     The storyboard to begin.
        //
        //   handoffBehavior:
        //     A value of the enumeration that describes behavior to use if a property described
        //     in the storyboard is already animated.
        //
        //   isControllable:
        //     Declares whether the animation is controllable (can be paused) after it is started.
        public void BeginStoryboard(Storyboard storyboard, HandoffBehavior handoffBehavior, bool isControllable);
        //
        // 摘要:
        //     Begins the sequence of actions contained in the provided storyboard, with options
        //     specified for what should happen if the property is already animated.
        //
        // 参数:
        //   storyboard:
        //     The storyboard to begin.
        //
        //   handoffBehavior:
        //     A value of the enumeration that describes behavior to use if a property described
        //     in the storyboard is already animated.
        public void BeginStoryboard(Storyboard storyboard, HandoffBehavior handoffBehavior);
        //
        // 摘要:
        //     Begins the sequence of actions that are contained in the provided storyboard.
        //
        //
        // 参数:
        //   storyboard:
        //     The storyboard to begin.
        public void BeginStoryboard(Storyboard storyboard);
        //
        // 摘要:
        //     Attempts to bring the provided region size of this element into view, within
        //     any scrollable regions it is contained within.
        //
        // 参数:
        //   targetRectangle:
        //     Specified size of the element that should also be brought into view.
        public void BringIntoView(Rect targetRectangle);
        //
        // 摘要:
        //     Attempts to bring this element into view, within any scrollable regions it is
        //     contained within.
        public void BringIntoView();
        //
        // 摘要:
        //     Indicates that the initialization process for the element is complete.
        //
        // 异常:
        //   T:System.InvalidOperationException:
        //     System.Windows.FrameworkElement.EndInit was called without System.Windows.FrameworkElement.BeginInit
        //     having previously been called on the element.
        public virtual void EndInit();
        //
        // 摘要:
        //     Finds an element that has the provided identifier name.
        //
        // 参数:
        //   name:
        //     The name of the requested element.
        //
        // 返回结果:
        //     The requested element. This can be null if no matching element was found.
        public object FindName(string name);
        //
        // 摘要:
        //     Searches for a resource with the specified key, and throws an exception if the
        //     requested resource is not found.
        //
        // 参数:
        //   resourceKey:
        //     The key identifier for the requested resource.
        //
        // 返回结果:
        //     The requested resource. If no resource with the provided key was found, an exception
        //     is thrown. An System.Windows.DependencyProperty.UnsetValue value might also be
        //     returned in the exception case.
        //
        // 异常:
        //   T:System.Windows.ResourceReferenceKeyNotFoundException:
        //     resourceKey was not found and an event handler does not exist for the System.Windows.Threading.Dispatcher.UnhandledException
        //     event. -or- resourceKey was not found and the System.Windows.Threading.DispatcherUnhandledExceptionEventArgs.Handled
        //     property is false in the System.Windows.Threading.Dispatcher.UnhandledException
        //     event.
        //
        //   T:System.ArgumentNullException:
        //     resourceKey is null.
        public object FindResource(object resourceKey);
        //
        // 摘要:
        //     Returns the System.Windows.Data.BindingExpression that represents the binding
        //     on the specified property.
        //
        // 参数:
        //   dp:
        //     The target System.Windows.DependencyProperty to get the binding from.
        //
        // 返回结果:
        //     A System.Windows.Data.BindingExpression if the target property has an active
        //     binding; otherwise, returns null.
        public BindingExpression GetBindingExpression(DependencyProperty dp);
        //
        // 摘要:
        //     Moves the keyboard focus away from this element and to another element in a provided
        //     traversal direction.
        //
        // 参数:
        //   request:
        //     The direction that focus is to be moved, as a value of the enumeration.
        //
        // 返回结果:
        //     Returns true if focus is moved successfully; false if the target element in direction
        //     as specified does not exist or could not be keyboard focused.
        public sealed override bool MoveFocus(TraversalRequest request);
        //
        // 摘要:
        //     When overridden in a derived class, is invoked whenever application code or internal
        //     processes call System.Windows.FrameworkElement.ApplyTemplate.
        public virtual void OnApplyTemplate();
        //
        // 摘要:
        //     Determines the next element that would receive focus relative to this element
        //     for a provided focus movement direction, but does not actually move the focus.
        //
        //
        // 参数:
        //   direction:
        //     The direction for which a prospective focus change should be determined.
        //
        // 返回结果:
        //     The next element that focus would move to if focus were actually traversed. May
        //     return null if focus cannot be moved relative to this element for the provided
        //     direction.
        //
        // 异常:
        //   T:System.ComponentModel.InvalidEnumArgumentException:
        //     Specified one of the following directions in the System.Windows.Input.TraversalRequest:
        //     System.Windows.Input.FocusNavigationDirection.Next, System.Windows.Input.FocusNavigationDirection.Previous,
        //     System.Windows.Input.FocusNavigationDirection.First, System.Windows.Input.FocusNavigationDirection.Last.
        //     These directions are not legal for System.Windows.FrameworkElement.PredictFocus(System.Windows.Input.FocusNavigationDirection)
        //     (but they are legal for System.Windows.FrameworkElement.MoveFocus(System.Windows.Input.TraversalRequest)).
        public sealed override DependencyObject PredictFocus(FocusNavigationDirection direction);
        //
        // 摘要:
        //     Provides an accessor that simplifies access to the System.Windows.NameScope registration
        //     method.
        //
        // 参数:
        //   name:
        //     Name to use for the specified name-object mapping.
        //
        //   scopedElement:
        //     Object for the mapping.
        public void RegisterName(string name, object scopedElement);
        //
        // 摘要:
        //     Attaches a binding to this element, based on the provided source property name
        //     as a path qualification to the data source.
        //
        // 参数:
        //   dp:
        //     Identifies the destination property where the binding should be established.
        //
        //
        //   path:
        //     The source property name or the path to the property used for the binding.
        //
        // 返回结果:
        //     Records the conditions of the binding. This return value can be useful for error
        //     checking.
        public BindingExpression SetBinding(DependencyProperty dp, string path);
        //
        // 摘要:
        //     Attaches a binding to this element, based on the provided binding object.
        //
        // 参数:
        //   dp:
        //     Identifies the property where the binding should be established.
        //
        //   binding:
        //     Represents the specifics of the data binding.
        //
        // 返回结果:
        //     Records the conditions of the binding. This return value can be useful for error
        //     checking.
        public BindingExpressionBase SetBinding(DependencyProperty dp, BindingBase binding);
        //
        // 摘要:
        //     Searches for a resource with the specified name and sets up a resource reference
        //     to it for the specified property.
        //
        // 参数:
        //   dp:
        //     The property to which the resource is bound.
        //
        //   name:
        //     The name of the resource.
        public void SetResourceReference(DependencyProperty dp, object name);
        //
        // 摘要:
        //     Returns whether serialization processes should serialize the contents of the
        //     System.Windows.FrameworkElement.Resources property.
        //
        // 返回结果:
        //     true if the System.Windows.FrameworkElement.Resources property value should be
        //     serialized; otherwise, false.
        [EditorBrowsable(EditorBrowsableState.Never)]
        public bool ShouldSerializeResources();
        //
        // 摘要:
        //     Returns whether serialization processes should serialize the contents of the
        //     System.Windows.FrameworkElement.Style property.
        //
        // 返回结果:
        //     true if the System.Windows.FrameworkElement.Style property value should be serialized;
        //     otherwise, false.
        [EditorBrowsable(EditorBrowsableState.Never)]
        public bool ShouldSerializeStyle();
        //
        // 摘要:
        //     Returns whether serialization processes should serialize the contents of the
        //     System.Windows.FrameworkElement.Triggers property.
        //
        // 返回结果:
        //     true if the System.Windows.FrameworkElement.Triggers property value should be
        //     serialized; otherwise, false.
        [EditorBrowsable(EditorBrowsableState.Never)]
        public bool ShouldSerializeTriggers();
        //
        // 摘要:
        //     Searches for a resource with the specified key, and returns that resource if
        //     found.
        //
        // 参数:
        //   resourceKey:
        //     The key identifier of the resource to be found.
        //
        // 返回结果:
        //     The found resource, or null if no resource with the provided resourceKey is found.
        public object TryFindResource(object resourceKey);
        //
        // 摘要:
        //     Simplifies access to the System.Windows.NameScope de-registration method.
        //
        // 参数:
        //   name:
        //     Name of the name-object pair to remove from the current scope.
        public void UnregisterName(string name);
        //
        // 摘要:
        //     Reapplies the default style to the current System.Windows.FrameworkElement.
        public void UpdateDefaultStyle();
        //
        // 摘要:
        //     Implements System.Windows.UIElement.ArrangeCore(System.Windows.Rect) (defined
        //     as virtual in System.Windows.UIElement) and seals the implementation.
        //
        // 参数:
        //   finalRect:
        //     The final area within the parent that this element should use to arrange itself
        //     and its children.
        protected sealed override void ArrangeCore(Rect finalRect);
        //
        // 摘要:
        //     When overridden in a derived class, positions child elements and determines a
        //     size for a System.Windows.FrameworkElement derived class.
        //
        // 参数:
        //   finalSize:
        //     The final area within the parent that this element should use to arrange itself
        //     and its children.
        //
        // 返回结果:
        //     The actual size used.
        protected virtual Size ArrangeOverride(Size finalSize);
        //
        // 摘要:
        //     Returns a geometry for a clipping mask. The mask applies if the layout system
        //     attempts to arrange an element that is larger than the available display space.
        //
        //
        // 参数:
        //   layoutSlotSize:
        //     The size of the part of the element that does visual presentation.
        //
        // 返回结果:
        //     The clipping geometry.
        protected override Geometry GetLayoutClip(Size layoutSlotSize);
        //
        // 摘要:
        //     Overrides System.Windows.Media.Visual.GetVisualChild(System.Int32), and returns
        //     a child at the specified index from a collection of child elements.
        //
        // 参数:
        //   index:
        //     The zero-based index of the requested child element in the collection.
        //
        // 返回结果:
        //     The requested child element. This should not return null; if the provided index
        //     is out of range, an exception is thrown.
        protected override Visual GetVisualChild(int index);
        //
        // 摘要:
        //     Implements basic measure-pass layout system behavior for System.Windows.FrameworkElement.
        //
        //
        // 参数:
        //   availableSize:
        //     The available size that the parent element can give to the child elements.
        //
        // 返回结果:
        //     The desired size of this element in layout.
        protected sealed override Size MeasureCore(Size availableSize);
        //
        // 摘要:
        //     When overridden in a derived class, measures the size in layout required for
        //     child elements and determines a size for the System.Windows.FrameworkElement-derived
        //     class.
        //
        // 参数:
        //   availableSize:
        //     The available size that this element can give to child elements. Infinity can
        //     be specified as a value to indicate that the element will size to whatever content
        //     is available.
        //
        // 返回结果:
        //     The size that this element determines it needs during layout, based on its calculations
        //     of child element sizes.
        protected virtual Size MeasureOverride(Size availableSize);
        //
        // 摘要:
        //     Invoked whenever an unhandled System.Windows.FrameworkElement.ContextMenuClosing
        //     routed event reaches this class in its route. Implement this method to add class
        //     handling for this event.
        //
        // 参数:
        //   e:
        //     Provides data about the event.
        protected virtual void OnContextMenuClosing(ContextMenuEventArgs e);
        //
        // 摘要:
        //     Invoked whenever an unhandled System.Windows.FrameworkElement.ContextMenuOpening
        //     routed event reaches this class in its route. Implement this method to add class
        //     handling for this event.
        //
        // 参数:
        //   e:
        //     The System.Windows.RoutedEventArgs that contains the event data.
        protected virtual void OnContextMenuOpening(ContextMenuEventArgs e);
        //
        // 摘要:
        //     Invoked whenever an unhandled System.Windows.UIElement.GotFocus event reaches
        //     this element in its route.
        //
        // 参数:
        //   e:
        //     The System.Windows.RoutedEventArgs that contains the event data.
        protected override void OnGotFocus(RoutedEventArgs e);
        //
        // 摘要:
        //     Raises the System.Windows.FrameworkElement.Initialized event. This method is
        //     invoked whenever System.Windows.FrameworkElement.IsInitialized is set to true
        //     internally.
        //
        // 参数:
        //   e:
        //     The System.Windows.RoutedEventArgs that contains the event data.
        protected virtual void OnInitialized(EventArgs e);
        //
        // 摘要:
        //     Invoked whenever the effective value of any dependency property on this System.Windows.FrameworkElement
        //     has been updated. The specific dependency property that changed is reported in
        //     the arguments parameter. Overrides System.Windows.DependencyObject.OnPropertyChanged(System.Windows.DependencyPropertyChangedEventArgs).
        //
        //
        // 参数:
        //   e:
        //     The event data that describes the property that changed, as well as old and new
        //     values.
        protected override void OnPropertyChanged(DependencyPropertyChangedEventArgs e);
        //
        // 摘要:
        //     Invoked whenever an unhandled System.Windows.FrameworkElement.ToolTipClosing
        //     routed event reaches this class in its route. Implement this method to add class
        //     handling for this event.
        //
        // 参数:
        //   e:
        //     Provides data about the event.
        protected virtual void OnToolTipClosing(ToolTipEventArgs e);
        //
        // 摘要:
        //     Invoked whenever the System.Windows.FrameworkElement.ToolTipOpening routed event
        //     reaches this class in its route. Implement this method to add class handling
        //     for this event.
        //
        // 参数:
        //   e:
        //     Provides data about the event.
        protected virtual void OnToolTipOpening(ToolTipEventArgs e);
        //
        // 摘要:
        //     Adds the provided object to the logical tree of this element.
        //
        // 参数:
        //   child:
        //     Child element to be added.
        protected internal void AddLogicalChild(object child);
        //
        // 摘要:
        //     Returns the named element in the visual tree of an instantiated System.Windows.Controls.ControlTemplate.
        //
        //
        // 参数:
        //   childName:
        //     Name of the child to find.
        //
        // 返回结果:
        //     The requested element. May be null if no element of the requested name exists.
        protected internal DependencyObject GetTemplateChild(string childName);
        //
        // 摘要:
        //     Returns an alternative logical parent for this element if there is no visual
        //     parent.
        //
        // 返回结果:
        //     Returns something other than null whenever a WPF framework-level implementation
        //     of this method has a non-visual parent connection.
        protected internal override DependencyObject GetUIParentCore();
        //
        // 摘要:
        //     Raises the System.Windows.FrameworkElement.SizeChanged event, using the specified
        //     information as part of the eventual event data.
        //
        // 参数:
        //   sizeInfo:
        //     Details of the old and new size involved in the change.
        protected internal override void OnRenderSizeChanged(SizeChangedInfo sizeInfo);
        //
        // 摘要:
        //     Invoked when the style in use on this element changes, which will invalidate
        //     the layout.
        //
        // 参数:
        //   oldStyle:
        //     The old style.
        //
        //   newStyle:
        //     The new style.
        protected internal virtual void OnStyleChanged(Style oldStyle, Style newStyle);
        //
        // 摘要:
        //     Invoked when the parent of this element in the visual tree is changed. Overrides
        //     System.Windows.UIElement.OnVisualParentChanged(System.Windows.DependencyObject).
        //
        //
        // 参数:
        //   oldParent:
        //     The old parent element. May be null to indicate that the element did not have
        //     a visual parent previously.
        protected internal override void OnVisualParentChanged(DependencyObject oldParent);
        //
        // 摘要:
        //     Supports incremental layout implementations in specialized subclasses of System.Windows.FrameworkElement.
        //     System.Windows.FrameworkElement.ParentLayoutInvalidated(System.Windows.UIElement)
        //     is invoked when a child element has invalidated a property that is marked in
        //     metadata as affecting the parent's measure or arrange passes during layout.
        //
        // 参数:
        //   child:
        //     The child element reporting the change.
        protected internal virtual void ParentLayoutInvalidated(UIElement child);
        //
        // 摘要:
        //     Removes the provided object from this element's logical tree. System.Windows.FrameworkElement
        //     updates the affected logical tree parent pointers to keep in sync with this deletion.
        //
        //
        // 参数:
        //   child:
        //     The element to remove.
        protected internal void RemoveLogicalChild(object child);
    }
}

image

image

image

image

 

posted @ 2026-06-15 12:20  Tony.Jia  阅读(8)  评论(0)    收藏  举报