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); } }




海阔凭鱼跃,天高任鸟飞,成功没有捷径,唯有努力前行!

浙公网安备 33010602011771号