1 #region 程序集 System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089  2 // C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.0\Profile\Client\System.Windows.Forms.dll  3 #endregion  4   5 using System.ComponentModel;  6 using System.Drawing;  7 using System.Runtime.InteropServices;  8   9 namespace System.Windows.Forms 10 { 11     // 12     // 摘要: 13     //     表示一个由可移动条组成的控件，该可移动条将容器的显示区域分成两个大小可调的面板。 14     [ClassInterface(ClassInterfaceType.AutoDispatch)] 15     [ComVisible(true)] 16     [DefaultEvent("SplitterMoved")] 17     [Designer("System.Windows.Forms.Design.SplitContainerDesigner, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")] 18     [Docking(DockingBehavior.AutoDock)] 19     [SRDescriptionAttribute("DescriptionSplitContainer")] 20     public class SplitContainer : ContainerControl, ISupportInitialize 21     { 22         // 23         // 摘要: 24         //     初始化 System.Windows.Forms.SplitContainer 类的新实例。 25         public SplitContainer(); 26  27         // 28         // 摘要: 29         //     当在派生类中重写时，获取或设置一个值，该值指示当控件放置在 System.Windows.Forms.SplitContainer 工作区之外时，是否自动显示滚动条。此属性与此类无关。 30         // 31         // 返回结果: 32         //     如果控件放置在 System.Windows.Forms.SplitContainer 工作区之外时自动显示滚动条，则为 true；否则为 false。默认值为 33         //     false。 34         [Browsable(false)] 35         [DefaultValue(false)] 36         [EditorBrowsable(EditorBrowsableState.Never)] 37         [Localizable(true)] 38         [SRCategoryAttribute("CatLayout")] 39         [SRDescriptionAttribute("FormAutoScrollDescr")] 40         public override bool AutoScroll { get; set; } 41         // 42         // 摘要: 43         //     获取或设置自动滚动边距的大小。此属性与此类无关。此属性与此类无关。 44         // 45         // 返回结果: 46         //     一个 System.Drawing.Size 值，它表示自动滚动边距的高度和宽度（以像素为单位）。 47         [Browsable(false)] 48         [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)] 49         [EditorBrowsable(EditorBrowsableState.Never)] 50         public Size AutoScrollMargin { get; set; } 51         // 52         // 摘要: 53         //     获取或设置滚动条的最小尺寸。此属性与此类无关。 54         // 55         // 返回结果: 56         //     System.Drawing.Size，它表示滚动条的最小高度和宽度（以像素为单位）。 57         [Browsable(false)] 58         [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)] 59         [EditorBrowsable(EditorBrowsableState.Never)] 60         public Size AutoScrollMinSize { get; set; } 61         // 62         // 摘要: 63         //     此属性与此类无关。 64         // 65         // 返回结果: 66         //     System.Drawing.Point 值。 67         [Browsable(false)] 68         [DefaultValue(typeof(Point), "0, 0")] 69         [EditorBrowsable(EditorBrowsableState.Never)] 70         public override Point AutoScrollOffset { get; set; } 71         // 72         // 摘要: 73         //     此属性与此类无关。 74         // 75         // 返回结果: 76         //     System.Drawing.Point 值。 77         [Browsable(false)] 78         [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)] 79         [EditorBrowsable(EditorBrowsableState.Never)] 80         [SRCategoryAttribute("CatLayout")] 81         [SRDescriptionAttribute("FormAutoScrollPositionDescr")] 82         public Point AutoScrollPosition { get; set; } 83         // 84         // 摘要: 85         //     获取或设置一个值，该值指示是否自动调整 System.Windows.Forms.SplitContainer 的大小以完整显示其内容。此属性与此类无关。 86         // 87         // 返回结果: 88         //     如果自动调整 System.Windows.Forms.SplitContainer 的大小，则为 true；否则为 false。 89         [Browsable(false)] 90         [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)] 91         [EditorBrowsable(EditorBrowsableState.Never)] 92         public override bool AutoSize { get; set; } 93         // 94         // 摘要: 95         //     获取或设置在控件中显示的背景图像。 96         // 97         // 返回结果: 98         //     一个 System.Drawing.Image，它表示在控件的背景中显示的图像。 99         [Browsable(true)]100         [EditorBrowsable(EditorBrowsableState.Always)]101         public override Image BackgroundImage { get; set; }102         //103         // 摘要:104         //     此属性与此类无关。105         //106         // 返回结果:107         //     一个 System.Windows.Forms.ImageLayout 值。108         [Browsable(false)]109         [EditorBrowsable(EditorBrowsableState.Never)]110         public override ImageLayout BackgroundImageLayout { get; set; }111         //112         // 摘要:113         //     获取或设置 System.Windows.Forms.SplitContainer 的 System.Windows.Forms.BindingContext。114         //115         // 返回结果:116         //     控件的 System.Windows.Forms.BindingContext。117         [Browsable(false)]118         [SRDescriptionAttribute("ContainerControlBindingContextDescr")]119         public override BindingContext BindingContext { get; set; }120         //121         // 摘要:122         //     获取或设置 System.Windows.Forms.SplitContainer 的边框样式。123         //124         // 返回结果:125         //     System.Windows.Forms.BorderStyle 值之一。默认值为 System.Windows.Forms.BorderStyle.Fixed3D。126         //127         // 异常:128         //   T:System.ComponentModel.InvalidEnumArgumentException:129         //     该属性的值并非 System.Windows.Forms.BorderStyle 值之一。130         [DefaultValue(BorderStyle.None)]131         [DispId(-504)]132         [SRCategoryAttribute("CatAppearance")]133         [SRDescriptionAttribute("SplitterBorderStyleDescr")]134         public BorderStyle BorderStyle { get; set; }135         //136         // 摘要:137         //     获取子控件的集合。此属性与此类无关。138         //139         // 返回结果:140         //     包含子控件的 System.Windows.Forms.Control.ControlCollection 类型的对象。141         [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]142         [EditorBrowsable(EditorBrowsableState.Never)]143         public ControlCollection Controls { get; }144         //145         // 摘要:146         //     获取或设置附加到容器边缘的 System.Windows.Forms.SplitContainer 边框。147         //148         // 返回结果:149         //     System.Windows.Forms.DockStyle 值之一。默认值为 None。150         public DockStyle Dock { get; set; }151         //152         // 摘要:153         //     获取或设置在调整容器大小时将大小保持不变的 System.Windows.Forms.SplitContainer 面板。154         //155         // 返回结果:156         //     System.Windows.Forms.FixedPanel 值之一。默认值为 None。157         //158         // 异常:159         //   T:System.ComponentModel.InvalidEnumArgumentException:160         //     分配的值不是 System.Windows.Forms.FixedPanel 值之一。161         [DefaultValue(FixedPanel.None)]162         [SRCategoryAttribute("CatLayout")]163         [SRDescriptionAttribute("SplitContainerFixedPanelDescr")]164         public FixedPanel FixedPanel { get; set; }165         //166         // 摘要:167         //     获取或设置一个值，用以指示拆分器是固定的还是可移动的。168         //169         // 返回结果:170         //     如果拆分器是固定的，则为 true；否则为 false。默认值为 false。171         [DefaultValue(false)]172         [Localizable(true)]173         [SRCategoryAttribute("CatLayout")]174         [SRDescriptionAttribute("SplitContainerIsSplitterFixedDescr")]175         public bool IsSplitterFixed { get; set; }176         //177         // 摘要:178         //     获取或设置一个值，该值指示 System.Windows.Forms.SplitContainer 面板处于水平方向还是垂直方向。179         //180         // 返回结果:181         //     System.Windows.Forms.Orientation 值之一。默认值为 Vertical。182         //183         // 异常:184         //   T:System.ComponentModel.InvalidEnumArgumentException:185         //     分配的值不是 System.Windows.Forms.Orientation 值之一。186         [DefaultValue(Orientation.Vertical)]187         [Localizable(true)]188         [SRCategoryAttribute("CatBehavior")]189         [SRDescriptionAttribute("SplitContainerOrientationDescr")]190         public Orientation Orientation { get; set; }191         //192         // 摘要:193         //     获取或设置 System.Windows.Forms.SplitterPanel 的边缘与其内容之间的内部间距（以像素为单位）。此属性与此类无关。194         //195         // 返回结果:196         //     System.Windows.Forms.Padding 类型的一个对象，它表示内部间距。197         [Browsable(false)]198         [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]199         [EditorBrowsable(EditorBrowsableState.Never)]200         public Padding Padding { get; set; }201         //202         // 摘要:203         //     获取 System.Windows.Forms.SplitContainer 的左侧面板或上部面板（根据 System.Windows.Forms.SplitContainer.Orientation204         //     而定）。205         //206         // 返回结果:207         //     如果 System.Windows.Forms.SplitContainer.Orientation 为 Vertical，则获取 System.Windows.Forms.SplitContainer208         //     的左侧面板。如果 System.Windows.Forms.SplitContainer.Orientation 为 Horizontal，则获取 System.Windows.Forms.SplitContainer209         //     的上部面板。210         [DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]211         [Localizable(false)]212         [SRCategoryAttribute("CatAppearance")]213         [SRDescriptionAttribute("SplitContainerPanel1Descr")]214         public SplitterPanel Panel1 { get; }215         //216         // 摘要:217         //     获取或设置一个值，该值确定 System.Windows.Forms.SplitContainer.Panel1 是折叠的还是展开的。218         //219         // 返回结果:220         //     如果折叠了 System.Windows.Forms.SplitContainer.Panel1，则为 true；否则为 false。默认值为 false。221         [DefaultValue(false)]222         [SRCategoryAttribute("CatLayout")]223         [SRDescriptionAttribute("SplitContainerPanel1CollapsedDescr")]224         public bool Panel1Collapsed { get; set; }225         //226         // 摘要:227         //     获取或设置拆分器与 System.Windows.Forms.SplitContainer.Panel1 的左边缘或上边缘的最小距离（以像素为单位）。228         //229         // 返回结果:230         //     System.Int32，它表示拆分器离 System.Windows.Forms.SplitContainer.Panel1 的左边缘或上边缘的最小距离（以像素为单位）。不管231         //     System.Windows.Forms.SplitContainer.Orientation 为何值，默认值均为 25 像素。232         //233         // 异常:234         //   T:System.ArgumentOutOfRangeException:235         //     指定的值与方向不一致。236         [DefaultValue(25)]237         [Localizable(true)]238         [RefreshProperties(RefreshProperties.All)]239         [SRCategoryAttribute("CatLayout")]240         [SRDescriptionAttribute("SplitContainerPanel1MinSizeDescr")]241         public int Panel1MinSize { get; set; }242         //243         // 摘要:244         //     获取 System.Windows.Forms.SplitContainer 的右侧面板或下部面板（根据 System.Windows.Forms.SplitContainer.Orientation245         //     而定）。246         //247         // 返回结果:248         //     如果 System.Windows.Forms.SplitContainer.Orientation 为 Vertical，则获取 System.Windows.Forms.SplitContainer249         //     的右侧面板。如果 System.Windows.Forms.SplitContainer.Orientation 为 Horizontal，则获取 System.Windows.Forms.SplitContainer250         //     的下部面板。251         [DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]252         [Localizable(false)]253         [SRCategoryAttribute("CatAppearance")]254         [SRDescriptionAttribute("SplitContainerPanel2Descr")]255         public SplitterPanel Panel2 { get; }256         //257         // 摘要:258         //     获取或设置一个值，该值确定 System.Windows.Forms.SplitContainer.Panel2 是折叠的还是展开的。259         //260         // 返回结果:261         //     如果折叠了 System.Windows.Forms.SplitContainer.Panel2，则为 true；否则为 false。默认值为 false。262         [DefaultValue(false)]263         [SRCategoryAttribute("CatLayout")]264         [SRDescriptionAttribute("SplitContainerPanel2CollapsedDescr")]265         public bool Panel2Collapsed { get; set; }266         //267         // 摘要:268         //     获取或设置拆分器离 System.Windows.Forms.SplitContainer.Panel2 的右边缘或下边缘的最小距离（以像素为单位）。269         //270         // 返回结果:271         //     System.Int32，它表示拆分器离 System.Windows.Forms.SplitContainer.Panel2 的右边缘或下边缘的最小距离（以像素为单位）。不管272         //     System.Windows.Forms.SplitContainer.Orientation 为何值，默认值均为 25 像素。273         //274         // 异常:275         //   T:System.ArgumentOutOfRangeException:276         //     指定的值与方向不一致。277         [DefaultValue(25)]278         [Localizable(true)]279         [RefreshProperties(RefreshProperties.All)]280         [SRCategoryAttribute("CatLayout")]281         [SRDescriptionAttribute("SplitContainerPanel2MinSizeDescr")]282         public int Panel2MinSize { get; set; }283         //284         // 摘要:285         //     获取或设置拆分器离 System.Windows.Forms.SplitContainer 的左边缘或上边缘的位置（以像素为单位）。286         //287         // 返回结果:288         //     System.Int32，它表示拆分器离 System.Windows.Forms.SplitContainer 的左边缘或上边缘的位置（以像素为单位）。默认值为289         //     50 像素。290         //291         // 异常:292         //   T:System.ArgumentOutOfRangeException:293         //     值小于零。294         //295         //   T:System.InvalidOperationException:296         //     该值与方向不一致。297         [DefaultValue(50)]298         [Localizable(true)]299         [SettingsBindable(true)]300         [SRCategoryAttribute("CatLayout")]301         [SRDescriptionAttribute("SplitContainerSplitterDistanceDescr")]302         public int SplitterDistance { get; set; }303         //304         // 摘要:305         //     获取或设置一个值，该值表示拆分器移动的增量（以像素为单位）。306         //307         // 返回结果:308         //     System.Int32，它表示拆分器移动的增量（以像素为单位）。默认值是一个像素。309         //310         // 异常:311         //   T:System.ArgumentOutOfRangeException:312         //     值小于 1。313         [DefaultValue(1)]314         [Localizable(true)]315         [SRCategoryAttribute("CatLayout")]316         [SRDescriptionAttribute("SplitContainerSplitterIncrementDescr")]317         public int SplitterIncrement { get; set; }318         //319         // 摘要:320         //     获取拆分器相对于 System.Windows.Forms.SplitContainer 的大小和位置。321         //322         // 返回结果:323         //     System.Drawing.Rectangle，它指定拆分器相对于 System.Windows.Forms.SplitContainer 的大小和位置。324         [Browsable(false)]325         [SRCategoryAttribute("CatLayout")]326         [SRDescriptionAttribute("SplitContainerSplitterRectangleDescr")]327         public Rectangle SplitterRectangle { get; }328         //329         // 摘要:330         //     获取或设置拆分器的宽度（以像素为单位）。331         //332         // 返回结果:333         //     System.Int32，它表示拆分器的宽度（以像素为单位）。默认值为四个像素。334         //335         // 异常:336         //   T:System.ArgumentOutOfRangeException:337         //     该值小于 1 或与方向不一致。338         [DefaultValue(4)]339         [Localizable(true)]340         [SRCategoryAttribute("CatLayout")]341         [SRDescriptionAttribute("SplitContainerSplitterWidthDescr")]342         public int SplitterWidth { get; set; }343         //344         // 摘要:345         //     获取或设置一个值，该值指示用户能否使用 Tab 键将焦点置于该拆分器上。346         //347         // 返回结果:348         //     如果用户可以用 Tab 键将焦点置于该拆分器上，则为 true；否则为 false。默认值为 true。349         [DefaultValue(true)]350         [DispId(-516)]351         [SRCategoryAttribute("CatBehavior")]352         [SRDescriptionAttribute("ControlTabStopDescr")]353         public bool TabStop { get; set; }354         //355         // 摘要:356         //     此属性与此类无关。357         //358         // 返回结果:359         //     一个字符串。360         [Bindable(false)]361         [Browsable(false)]362         [EditorBrowsable(EditorBrowsableState.Never)]363         public override string Text { get; set; }364         //365         // 摘要:366         //     获取 System.Windows.Forms.SplitContainer 的默认大小。367         //368         // 返回结果:369         //     System.Drawing.Size，它表示 System.Windows.Forms.SplitContainer 的大小。370         protected override Size DefaultSize { get; }371 372         //373         // 摘要:374         //     当 System.Windows.Forms.SplitContainer.AutoSize 属性的值更改时发生。此属性与此类无关。375         [Browsable(false)]376         [EditorBrowsable(EditorBrowsableState.Never)]377         public event EventHandler AutoSizeChanged;378         //379         // 摘要:380         //     当 System.Windows.Forms.SplitContainer.BackgroundImage 属性更改时发生。381         [Browsable(true)]382         [EditorBrowsable(EditorBrowsableState.Always)]383         public event EventHandler BackgroundImageChanged;384         //385         // 摘要:386         //     当 System.Windows.Forms.SplitContainer.BackgroundImageLayout 属性更改时发生。此事件与该类无关。387         [Browsable(false)]388         [EditorBrowsable(EditorBrowsableState.Never)]389         public event EventHandler BackgroundImageLayoutChanged;390         //391         // 摘要:392         //     此事件与此类无关。393         [Browsable(false)]394         [EditorBrowsable(EditorBrowsableState.Never)]395         public event ControlEventHandler ControlAdded;396         //397         // 摘要:398         //     此事件与此类无关。399         [Browsable(false)]400         [EditorBrowsable(EditorBrowsableState.Never)]401         public event ControlEventHandler ControlRemoved;402         //403         // 摘要:404         //     此事件与此类无关。405         [Browsable(false)]406         [EditorBrowsable(EditorBrowsableState.Never)]407         public event EventHandler PaddingChanged;408         //409         // 摘要:410         //     当移动拆分器控件时发生。411         [SRCategoryAttribute("CatBehavior")]412         [SRDescriptionAttribute("SplitterSplitterMovedDescr")]413         public event SplitterEventHandler SplitterMoved;414         //415         // 摘要:416         //     当拆分器控件正处在移动过程中发生。417         [SRCategoryAttribute("CatBehavior")]418         [SRDescriptionAttribute("SplitterSplitterMovingDescr")]419         public event SplitterCancelEventHandler SplitterMoving;420         //421         // 摘要:422         //     此事件与此类无关。423         [Browsable(false)]424         [EditorBrowsable(EditorBrowsableState.Never)]425         public event EventHandler TextChanged;426 427         public void BeginInit();428         public void EndInit();429         //430         // 摘要:431         //     引发 System.Windows.Forms.SplitContainer.SplitterMoved 事件。432         //433         // 参数:434         //   e:435         //     包含事件数据的 System.Windows.Forms.SplitterEventArgs。436         public void OnSplitterMoved(SplitterEventArgs e);437         //438         // 摘要:439         //     引发 System.Windows.Forms.SplitContainer.SplitterMoving 事件。440         //441         // 参数:442         //   e:443         //     包含事件数据的 System.Windows.Forms.SplitterEventArgs。444         public void OnSplitterMoving(SplitterCancelEventArgs e);445         //446         // 摘要:447         //     为控件创建控件集合的新实例。448         //449         // 返回结果:450         //     分配给控件的 System.Windows.Forms.Control.ControlCollection 的新实例。451         [EditorBrowsable(EditorBrowsableState.Advanced)]452         protected override ControlCollection CreateControlsInstance();453         //454         // 摘要:455         //     引发 System.Windows.Forms.Control.GotFocus 事件。456         //457         // 参数:458         //   e:459         //     包含事件数据的 System.EventArgs。460         protected override void OnGotFocus(EventArgs e);461         //462         // 摘要:463         //     引发 System.Windows.Forms.Control.KeyDown 事件。464         //465         // 参数:466         //   e:467         //     包含事件数据的 System.Windows.Forms.KeyEventArgs。468         protected override void OnKeyDown(KeyEventArgs e);469         //470         // 摘要:471         //     引发 System.Windows.Forms.Control.KeyUp 事件。472         //473         // 参数:474         //   e:475         //     包含事件数据的 System.Windows.Forms.KeyEventArgs。476         protected override void OnKeyUp(KeyEventArgs e);477         //478         // 摘要:479         //     引发 System.Windows.Forms.Control.Layout 事件。480         //481         // 参数:482         //   e:483         //     包含事件数据的 System.Windows.Forms.LayoutEventArgs。484         protected override void OnLayout(LayoutEventArgs e);485         //486         // 摘要:487         //     引发 System.Windows.Forms.Control.LostFocus 事件。488         //489         // 参数:490         //   e:491         //     包含事件数据的 System.EventArgs。492         protected override void OnLostFocus(EventArgs e);493         //494         // 参数:495         //   e:496         //     包含事件数据的 System.EventArgs。497         protected override void onm ouseCaptureChanged(EventArgs e);498         //499         // 摘要:500         //     引发 System.Windows.Forms.Control.MouseDown 事件。501         //502         // 参数:503         //   e:504         //     包含事件数据的 System.Windows.Forms.MouseEventArgs。505         protected override void onm ouseDown(MouseEventArgs e);506         //507         // 摘要:508         //     引发 System.Windows.Forms.Control.MouseLeave 事件。509         //510         // 参数:511         //   e:512         //     包含事件数据的 System.EventArgs。513         protected override void onm ouseLeave(EventArgs e);514         //515         // 摘要:516         //     引发 System.Windows.Forms.Control.MouseMove 事件。517         //518         // 参数:519         //   e:520         //     包含事件数据的 System.Windows.Forms.MouseEventArgs。521         [EditorBrowsable(EditorBrowsableState.Advanced)]522         protected override void onm ouseMove(MouseEventArgs e);523         //524         // 摘要:525         //     引发 System.Windows.Forms.Control.MouseUp 事件。526         //527         // 参数:528         //   e:529         //     包含事件数据的 System.Windows.Forms.MouseEventArgs。530         protected override void onm ouseUp(MouseEventArgs e);531         //532         // 摘要:533         //     引发 System.Windows.Forms.Control.Move 事件。534         //535         // 参数:536         //   e:537         //     事件的相关数据。538         protected override void OnMove(EventArgs e);539         //540         // 摘要:541         //     引发 System.Windows.Forms.Control.Paint 事件。542         //543         // 参数:544         //   e:545         //     包含事件数据的 System.Windows.Forms.PaintEventArgs。546         protected override void OnPaint(PaintEventArgs e);547         [EditorBrowsable(EditorBrowsableState.Advanced)]548         protected override void OnRightToLeftChanged(EventArgs e);549         //550         // 摘要:551         //     处理对话框键。552         //553         // 参数:554         //   keyData:555         //     System.Windows.Forms.Keys 值之一，它表示要处理的键。556         //557         // 返回结果:558         //     如果键已由控件处理，则为 true；否则为 false。559         protected override bool ProcessDialogKey(Keys keyData);560         //561         // 摘要:562         //     选择下一个可用控件并使其成为活动控件。563         //564         // 参数:565         //   forward:566         //     如果在 System.Windows.Forms.ContainerControl 内的控件中向前循环，则为 true；否则为 false。567         //568         // 返回结果:569         //     如果选定了一个控件，则为 true；否则为 false。570         protected override bool ProcessTabKey(bool forward);571         [EditorBrowsable(EditorBrowsableState.Advanced)]572         protected override void ScaleControl(SizeF factor, BoundsSpecified specified);573         protected override void Select(bool directed, bool forward);574         //575         // 参数:576         //   x:577         //     控件的新 System.Windows.Forms.Control.Left 属性值。578         //579         //   y:580         //     控件的新 System.Windows.Forms.Control.Top 属性值。581         //582         //   width:583         //     控件的新 System.Windows.Forms.Control.Width 属性值。584         //585         //   height:586         //     控件的新 System.Windows.Forms.Control.Height 属性值。587         //588         //   specified:589         //     System.Windows.Forms.BoundsSpecified 值的按位组合。590         protected override void SetBoundsCore(int x, int y, int width, int height, BoundsSpecified specified);591         //592         // 摘要:593         //     处理 Windows 消息。594         //595         // 参数:596         //   msg:597         //     要处理的 WindowsSystem.Windows.Forms.Message。598         protected override void WndProc(ref Message msg);599     }600 }