1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284
|
<?xml version="1.0" encoding="utf-8"?>
<Type Name="MaskDescriptor" FullName="System.Windows.Forms.Design.MaskDescriptor">
<TypeSignature Language="C#" Value="public abstract class MaskDescriptor" />
<AssemblyInfo>
<AssemblyName>System.Design</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Windows.Forms.Design.MaskDescriptor" /> abstract class defines the common set of properties that all mask descriptors must implement. You can use mask descriptors to create predefined mask options for use in the UI type editor for the <see cref="T:System.Windows.Forms.MaskedTextBox" />. For example, vsprvs provides predefined masks for data such as the Postal Code, time, different date formats, and telephone number. All predefined masks will be associated with the <see cref="T:System.ComponentModel.MaskedTextProvider" /> parsing engine.</para>
<para>You can discover <see cref="T:System.Windows.Forms.Design.MaskDescriptor" /> types at design time by querying the <see cref="T:System.ComponentModel.Design.ITypeDiscoveryService" /> service provider. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Defines a set of members for derived classes to provide options for the masked text box UI type editor.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected MaskDescriptor ();" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>
<see cref="M:System.Windows.Forms.Design.MaskDescriptor.#ctor" /> is a compiler-supplied default constructor. A default constructor is required by the <see cref="T:System.ComponentModel.Design.ITypeDiscoveryService" /> service provider.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Windows.Forms.Design.MaskDescriptor" /> class.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Culture">
<MemberSignature Language="C#" Value="public virtual System.Globalization.CultureInfo Culture { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Globalization.CultureInfo</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the <see cref="T:System.Globalization.CultureInfo" /> representing the locale the mask is authored for.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Equals">
<MemberSignature Language="C#" Value="public override bool Equals (object maskDescriptor);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="maskDescriptor" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Windows.Forms.Design.MaskDescriptor.Equals(System.Object)" /> method determines whether <paramref name="maskDescriptor" /> and the current mask descriptor describe the same mask.</para>
<para>This method returns true if the following conditions are met in both mask descriptors.</para>
<para>1. The <see cref="P:System.Windows.Forms.Design.MaskDescriptor.Mask" /> property is the same for both mask descriptors.</para>
<para>2. The validating type is the same for both mask descriptors.</para>
<block subset="none" type="note">
<para>The <see cref="P:System.Windows.Forms.Design.MaskDescriptor.Name" /> property is not considered, because the <see cref="T:System.ComponentModel.MaskedTextProvider" /> and <see cref="T:System.Windows.Forms.MaskedTextBox" /> classes do not use it.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Determines whether the specified <see cref="T:System.Windows.Forms.Design.MaskDescriptor" /> is equal to the current <see cref="T:System.Windows.Forms.Design.MaskDescriptor" />.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if the specified <see cref="T:System.Windows.Forms.Design.MaskDescriptor" /> is equal to the current <see cref="T:System.Windows.Forms.Design.MaskDescriptor" />; otherwise, false. </para>
</returns>
<param name="maskDescriptor">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Design.MaskDescriptor" /> to compare with the current <see cref="T:System.Windows.Forms.Design.MaskDescriptor" />.</param>
</Docs>
</Member>
<Member MemberName="GetHashCode">
<MemberSignature Language="C#" Value="public override int GetHashCode ();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="IsValidMaskDescriptor">
<MemberSignature Language="C#" Value="public static bool IsValidMaskDescriptor (System.Windows.Forms.Design.MaskDescriptor maskDescriptor);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="maskDescriptor" Type="System.Windows.Forms.Design.MaskDescriptor" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Windows.Forms.Design.MaskDescriptor.IsValidMaskDescriptor(System.Windows.Forms.Design.MaskDescriptor)" /> method determines whether <paramref name="maskDescriptor" /> is valid and can be added to the masks list.</para>
<para>A valid <see cref="T:System.Windows.Forms.Design.MaskDescriptor" /> must meet the following conditions.</para>
<list type="bullet">
<item>
<para>Not null.</para>
</item>
<item>
<para>Not null or an empty mask.</para>
</item>
<item>
<para>Not null or an empty name.</para>
</item>
<item>
<para>Not null or an empty sample.</para>
</item>
<item>
<para>The sample is correct based on the mask and all required edit characters have been provided. This means the mask is completed but not necessarily full.</para>
</item>
<item>
<para>The sample is valid based on the <see cref="P:System.Windows.Forms.Design.MaskDescriptor.ValidatingType" /> object, if any. </para>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns a value indicating whether the specified mask descriptor is valid and can be added to the masks list.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if <paramref name="maskDescriptor" /> is valid; otherwise, false. </para>
</returns>
<param name="maskDescriptor">
<attribution license="cc4" from="Microsoft" modified="false" />The mask descriptor to test for validity.</param>
</Docs>
</Member>
<Member MemberName="IsValidMaskDescriptor">
<MemberSignature Language="C#" Value="public static bool IsValidMaskDescriptor (System.Windows.Forms.Design.MaskDescriptor maskDescriptor, out string validationErrorDescription);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="maskDescriptor" Type="System.Windows.Forms.Design.MaskDescriptor" />
<Parameter Name="validationErrorDescription" Type="System.String&" RefType="out" />
</Parameters>
<Docs>
<param name="maskDescriptor">To be added.</param>
<param name="validationErrorDescription">To be added.</param>
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="Mask">
<MemberSignature Language="C#" Value="public abstract string Mask { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The mask must contain only valid characters, as defined by the <see cref="M:System.ComponentModel.MaskedTextProvider.IsValidMaskChar(System.Char)" /> method of the <see cref="T:System.ComponentModel.MaskedTextProvider" /> class. When a predefined mask is selected in vsprvs, itsĀ <see cref="P:System.Windows.Forms.Design.MaskDescriptor.Mask" /> property is displayed.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the mask being defined.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Name">
<MemberSignature Language="C#" Value="public abstract string Name { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Windows.Forms.Design.MaskDescriptor.Name" /> property is displayed in the <ui>Mask Description</ui> column in the visual editor for the <see cref="T:System.Windows.Forms.MaskedTextBox" /> control.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the user-friendly name of the mask.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Sample">
<MemberSignature Language="C#" Value="public abstract string Sample { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Windows.Forms.Design.MaskDescriptor.Sample" /> property is displayed in the <ui>Data Format</ui> column in the visual editor for the <see cref="T:System.Windows.Forms.MaskedTextBox" /> control.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a sample of a formatted string for the mask.</para>
</summary>
</Docs>
</Member>
<Member MemberName="ToString">
<MemberSignature Language="C#" Value="public override string ToString ();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="ValidatingType">
<MemberSignature Language="C#" Value="public abstract Type ValidatingType { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Type</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Windows.Forms.Design.MaskDescriptor.ValidatingType" /> property is used to validate the input string after the mask has been applied to it. It directly corresponds to the <see cref="P:System.Windows.Forms.MaskedTextBox.ValidatingType" /> property of the <see cref="T:System.Windows.Forms.MaskedTextBox" /> class.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the type providing validation associated with the mask.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>
|