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
|
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DesignerActionItem" FullName="System.ComponentModel.Design.DesignerActionItem">
<TypeSignature Language="C#" Value="public abstract class DesignerActionItem" />
<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.ComponentModel.Design.DesignerActionItem" /> class serves as an abstract base for classes that represent individual panel items in a smart tag panel, which represents a menu-like user interface (UI) for smart tags. The dnprdnshort supplies derived classes that represent the different common entries in a smart tag panel, including plain text, header text, properties and methods of the associated <see cref="T:System.ComponentModel.Design.DesignerActionList" /> class, and designer verbs. </para>
<para>Typically, your DesignerAction feature is defined in a programmer-supplied class derived from <see cref="T:System.ComponentModel.Design.DesignerActionList" />, which contains a <see cref="M:System.ComponentModel.Design.DesignerActionList.GetSortedActionItems" /> method that groups individual panel items together to form the smart tag panel. The <see cref="T:System.ComponentModel.Design.DesignerActionPropertyItem" /> and <see cref="T:System.ComponentModel.Design.DesignerActionMethodItem" /> types are associated with members of the class derived from <see cref="T:System.ComponentModel.Design.DesignerActionList" />, and <see cref="T:System.ComponentModel.Design.DesignerActionMethodItem" /> objects are activated when their associated panel entry is selected by the user.</para>
<block subset="none" type="note">
<para>Forms and dialog boxes can be displayed by members of the class derived from <see cref="T:System.ComponentModel.Design.DesignerActionList" />. By default, the parent of these windows will be the container window for the smart tag panel. Explicitly parenting these child windows to another service or window may cause items to display improperly.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides the base class for types that represent a panel item on a smart tag panel.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DesignerActionItem (string displayName, string category, string description);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="displayName" Type="System.String" />
<Parameter Name="category" Type="System.String" />
<Parameter Name="description" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Because <see cref="T:System.ComponentModel.Design.DesignerActionItem" /> is an abstract class, the <see cref="M:System.ComponentModel.Design.DesignerActionItem.#ctor(System.String,System.String,System.String)" /> constructor is intended to be called from derived classes only.</para>
<para>For more information about how the <paramref name="category" /> parameter is used to group items on a panel, see the <see cref="M:System.ComponentModel.Design.DesignerActionList.GetSortedActionItems" /> method.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.ComponentModel.Design.DesignerActionItem" /> class.</para>
</summary>
<param name="displayName">
<attribution license="cc4" from="Microsoft" modified="false" />The panel text for this item.</param>
<param name="category">
<attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive <see cref="T:System.String" /> that defines the groupings of panel entries.</param>
<param name="description">
<attribution license="cc4" from="Microsoft" modified="false" />Supplemental text for this item, potentially used in ToolTips or the status bar.</param>
</Docs>
</Member>
<Member MemberName="AllowAssociate">
<MemberSignature Language="C#" Value="public bool AllowAssociate { set; get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Because multiple <see cref="T:System.ComponentModel.Design.DesignerActionList" /> objects may be combined to form a single smart tag panel, the <see cref="P:System.ComponentModel.Design.DesignerActionItem.AllowAssociate" /> property indicates whether the current item can be rearranged by category.</para>
<para>The <see cref="P:System.ComponentModel.Design.DesignerActionItem.AllowAssociate" /> property is used in conjunction with the <see cref="P:System.ComponentModel.Design.DesignerActionMethodItem.RelatedComponent" /> property on the <see cref="T:System.ComponentModel.Design.DesignerActionMethodItem" /> and <see cref="T:System.ComponentModel.Design.DesignerActionPropertyItem" /> types.</para>
<para>For example, ASP.NET uses a data-bound control like <see cref="T:System.Web.UI.WebControls.GridView" /> to connect to a data source control like <see cref="T:System.Web.UI.WebControls.SqlDataSource" />. Both have a <see cref="T:System.ComponentModel.Design.DesignerActionList" /> with its own set of <see cref="T:System.ComponentModel.Design.DesignerActionItem" /> objects. The <see cref="T:System.Web.UI.WebControls.GridView" /> control has items like <see cref="P:System.Web.UI.WebControls.BaseDataBoundControl.DataSourceID" />, Edit Fields, and AutoFormat. The <see cref="T:System.Web.UI.WebControls.SqlDataSource" /> class has Configure and Refresh Items, which have <see cref="P:System.ComponentModel.Design.DesignerActionItem.AllowAssociate" /> set to true.</para>
<para>The <see cref="T:System.Web.UI.WebControls.GridView" /> control's <see cref="P:System.Web.UI.WebControls.BaseDataBoundControl.DataSourceID" /> item has a related component, which is the <see cref="T:System.Web.UI.WebControls.SqlDataSource" /> object. All the <see cref="T:System.Web.UI.WebControls.SqlDataSource" /> object's items that have <see cref="P:System.ComponentModel.Design.DesignerActionItem.AllowAssociate" /> set to true are automatically included in the <see cref="T:System.Web.UI.WebControls.GridView" /> control's action list. The following table shows how the two lists are merged in the <see cref="T:System.Web.UI.WebControls.GridView" /> control's designer action list.</para>
<list type="table">
<listheader>
<item>
<term>
<para>GridView items</para>
</term>
<description>
<para>SqlDataSource items</para>
</description>
</item>
</listheader>
<item>
<term>
<list type="bullet">
<item>
<para>DataSourceID (related component = SqlDataSource)</para>
</item>
<item>
<para>Edit Fields</para>
</item>
<item>
<para>AutoFormat</para>
</item>
</list>
</term>
<description>
<list type="bullet">
<item>
<para>Configure (AllowAssociate = true)</para>
</item>
<item>
<para>Refresh (AllowAssociate = true)</para>
</item>
</list>
</description>
</item>
</list>
<list type="table">
<listheader>
<item>
<term>
<para>Merged GridView control's smart tasks panel</para>
</term>
</item>
</listheader>
<item>
<term>
<list type="bullet">
<item>
<para>DataSourceID </para>
</item>
<item>
<para>Configure </para>
</item>
<item>
<para>Refresh </para>
</item>
<item>
<para>Edit Fields</para>
</item>
<item>
<para>AutoFormat</para>
</item>
</list>
</term>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value indicating whether to allow this item to be placed into a group of items that have the same <see cref="P:System.ComponentModel.Design.DesignerActionItem.Category" /> property value.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Category">
<MemberSignature Language="C#" Value="public virtual string Category { 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>Item categories are defined by their names, which are case-sensitive.</para>
<para>For more information about how items are grouped by category, see the <see cref="M:System.ComponentModel.Design.DesignerActionList.GetSortedActionItems" /> method.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the group name for an item.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Description">
<MemberSignature Language="C#" Value="public virtual string Description { 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.ComponentModel.Design.DesignerActionItem.Description" /> property is used whenever a plain text description of the item is required (for example, in ToolTips and the status bar).</para>
<para>The value of this property is set in the constructor for this class. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the supplemental text for the item.</para>
</summary>
</Docs>
</Member>
<Member MemberName="DisplayName">
<MemberSignature Language="C#" Value="public virtual string DisplayName { 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 value of the <see cref="P:System.ComponentModel.Design.DesignerActionItem.DisplayName" /> property is set in the constructor for this class.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the text for this item.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Properties">
<MemberSignature Language="C#" Value="public System.Collections.IDictionary Properties { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.IDictionary</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.ComponentModel.Design.DesignerActionItem.Properties" /> property allows the programmer to store arbitrary data within an item. The standard properties for this class, such as <see cref="P:System.ComponentModel.Design.DesignerActionItem.Category" /> and <see cref="P:System.ComponentModel.Design.DesignerActionItem.DisplayName" />, are not stored in this collection.</para>
<para>The type of this property is actually <see cref="T:System.Collections.Specialized.HybridDictionary" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a reference to a collection that can be used to store programmer-defined key/value pairs.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>
|