Jo Shields a575963da9 Imported Upstream version 3.6.0
Former-commit-id: da6be194a6b1221998fc28233f2503bd61dd9d14
2014-08-13 10:39:27 +01:00

100 lines
6.2 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<Type Name="FlatStyle" FullName="System.Windows.Forms.FlatStyle">
<TypeSignature Language="C#" Value="public enum FlatStyle" />
<AssemblyInfo>
<AssemblyName>System.Windows.Forms</AssemblyName>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Enum</BaseTypeName>
</Base>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This enumeration is used by members such as <see cref="P:System.Windows.Forms.ButtonBase.FlatStyle" />, <see cref="P:System.Windows.Forms.GroupBox.FlatStyle" />, and <see cref="P:System.Windows.Forms.Label.FlatStyle" />.</para>
<para>In the case of the <see cref="F:System.Windows.Forms.FlatStyle.Popup" /> style button, this enumeration controls some behavior as well as appearance. The <see cref="F:System.Windows.Forms.FlatStyle.Popup" /> style control initially appears <see cref="F:System.Windows.Forms.FlatStyle.Flat" /> until the mouse pointer moves over it. When the mouse pointer moves over the <see cref="F:System.Windows.Forms.FlatStyle.Popup" /> control, it appears as a <see cref="F:System.Windows.Forms.FlatStyle.Standard" /> style control until the mouse pointer is moved off of it again.</para>
<para>If the <see cref="F:System.Windows.Forms.FlatStyle.System" /> style is used, the appearance of the control is determined by the user's operating system and the following property values will be ignored: <see cref="P:System.Windows.Forms.Control.BackgroundImage" />, ImageAlign, Image, ImageIndex, ImageList, and TextAlign. In addition, the <see cref="P:System.Windows.Forms.Control.BackColor" /> property will be ignored for button controls. If supported, users can change the appearance of controls by adjusting the appearance settings of their operating system.</para>
<block subset="none" type="note">
<para>When the <see cref="P:System.Windows.Forms.ButtonBase.FlatStyle" /> property of the <see cref="T:System.Windows.Forms.RadioButton" /> and <see cref="T:System.Windows.Forms.CheckBox" /> classes is set to <see cref="F:System.Windows.Forms.FlatStyle.System" />, the control is drawn by the user's operating system and the check alignment is based upon the CheckAlign and <see cref="P:System.Windows.Forms.ButtonBase.TextAlign" /> property values. The CheckAlign property value is not changed, but the appearance of the control can be affected. The check box is horizontally aligned with either the left or right edge of the control (a left or center alignment appears left aligned, right remains unchanged), and vertically aligned the same as the descriptive text. For example, if you have a <see cref="T:System.Windows.Forms.CheckBox" /> control with a CheckAlign property value of <see cref="F:System.Drawing.ContentAlignment.MiddleCenter" /> and a <see cref="P:System.Windows.Forms.ButtonBase.TextAlign" /> property value of <see cref="F:System.Drawing.ContentAlignment.TopRight" />, and the <see cref="P:System.Windows.Forms.ButtonBase.FlatStyle" /> property value is set to <see cref="F:System.Windows.Forms.FlatStyle.System" />, the check box alignment will appear to be <see cref="F:System.Drawing.ContentAlignment.TopLeft" /> while the text alignment remains unchanged.</para>
</block>
<block subset="none" type="note">
<para>Setting the FlatStyle property to <see cref="F:System.Windows.Forms.FlatStyle.System" /> is not advisable if you need to display an image on a control, display an image as a control's background, or perform precise text alignment.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies the appearance of a control.</para>
</summary>
</Docs>
<Members>
<Member MemberName="Flat">
<MemberSignature Language="C#" Value="Flat" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Windows.Forms.FlatStyle</ReturnType>
</ReturnValue>
<Docs>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The control appears flat.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Popup">
<MemberSignature Language="C#" Value="Popup" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Windows.Forms.FlatStyle</ReturnType>
</ReturnValue>
<Docs>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A control appears flat until the mouse pointer moves over it, at which point it appears three-dimensional.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Standard">
<MemberSignature Language="C#" Value="Standard" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Windows.Forms.FlatStyle</ReturnType>
</ReturnValue>
<Docs>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The control appears three-dimensional.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="System">
<MemberSignature Language="C#" Value="System" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Windows.Forms.FlatStyle</ReturnType>
</ReturnValue>
<Docs>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The appearance of the control is determined by the user's operating system.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>