Version

ValueList Class Members

The following tables list the members exposed by ValueList.

Protected Fields
 NameDescription
Protected FieldtagValue (Inherited from Infragistics.Shared.SubObjectBase)
Public Properties
 NameDescription
Public PropertyAppearanceReturns or sets the Appearance object that controls the object's formatting.  
Public PropertyAppearancesAppearance's collection  
Public PropertyAutoSuggestHighlightAppearanceReturns or sets the Appearance object that controls the appearance of the highlighted text when using AutoSuggestFilterMode Contains.  
Public PropertyAutoSuggestHighlightSelectedAppearanceReturns or sets the Appearance object that controls the appearance of the highlighted text when using AutoSuggestFilterMode Contains and the item is selected or hot tracked.  
Public PropertyCheckBoxAlignmentReturns or sets the alignment of the checkbox with respect to the remaining item content, i.e., the text and/or the image.  
Public PropertyCheckBoxStyleReturns whether checkboxes appear next to each item in the dropdown list, and whether they support the 'Indeterminate' setting.  
Public PropertyCheckedItemsReturns a collection which contains the ValueListItem instances whose CheckState property returns 'Checked'.  
Public PropertyDisplayStyleDetermines what information will be displayed in the drop down and edit area of a cell in a drop down style column, and how the information will be formatted.  
Public PropertyDisposed (Inherited from Infragistics.Shared.DisposableObject)
Public PropertyDrawModeGets/sets DrawMode used by the dropdown list  
Public PropertyDropDownListAlignmentGets/sets the alignment of the dropdown list. Available only at runtime.  
Public PropertyDropDownListMinWidthGets/sets the minimum width of the dropdown list.  
Public PropertyDropDownListWidthGets/sets the width of the dropdownlist  
Public PropertyDropDownResizeHandleAppearanceDropdown resize handle appearance.  
Public PropertyDropDownResizeHandleStyleGets/Sets Drop Down Resize Handle Style  
Public PropertyDropDownResizeHandleStyleResolvedGets/Sets Drop Down Resize Handle Style  
Public PropertyFormatFilteredItemsReturns or sets whether the text for the items that appear in the dropdown are formatted to highlight the characters that were typed by the user during an auto-suggest session.  
Public PropertyFormatProviderGets/sets the formatting information that is used when converting a ValueListItem's DataValue into a string when no value is specified for the DisplayText property.  
Public PropertyFormatStringGets/sets the format string that is used when converting a ValueListItem's DataValue into a string when no value is specified for the DisplayText property.  
Public PropertyHasAppearanceTrue if an appearance object has been allocated  
Public PropertyHasAutoSuggestHighlightAppearanceTrue if an appearance object has been allocated  
Public PropertyHasAutoSuggestHighlightSelectedAppearanceTrue if an appearance object has been allocated  
Public PropertyHasDropdownResizeHandleAppearanceTrue if an appearance object has been allocated  
Public PropertyIsBoundThe base implementation always returns false. The BindableValueList override may return true.  
Public PropertyItemHeightGets/sets ItemHeight used by the dropdown list  
Public PropertyItemMatchingModeReturns or sets a value indicating the method used to evaluate ValueListItems during searches.  
Public Propertystatic (Shared in Visual Basic)ItemMatchingModeOverrideOverrides the ItemMatchingMode on all ValueLists in the application.  
Public PropertyKey (Inherited from Infragistics.Shared.KeyedSubObjectBase)
Public PropertyMaxDropDownItemsGets/sets the maximum number of items that will be displayed in the dropdown.  
Public PropertyMRUListProviderThe Value List's MRUList provider  
Public PropertyOwnerThe Value List's owner  
Public PropertyPreferredDropDownSizeThe preferred size of the dropdown.  
Public PropertyScaleItemImageSpecifies how ValueListItem images will be scaled. The important thing that this property can be used to control is how the height of a value list item is calculated. When this property is set to its default value of OnlyWhenNeeded it always uses the font height and scales down (never up) the image on the value list item. When set to Never it uses the max of the font and the image for the height of the item. When set to always it uses the font height (like OnlyWhenNeeded) except that it scales up as well.  
Public PropertySelectedIndexGets/sets the index of the currently selected item. Available only at runtime.  
Public PropertySelectedItemGets/sets the currently selected item. Available only at runtime.  
Public PropertySortStyleReturns or sets a value that determines how valuelistitems will be sorted in a valuelist.  
Public PropertyTag (Inherited from Infragistics.Shared.SubObjectBase)
Public PropertyValueListItemsReturns a reference to a ValueListItems collection, containing the valustlistitems of a ValueList object. This property is read-only at run-time.  
Protected Properties
 NameDescription
Protected PropertyAlwaysResolveControlImageOverride this and return true if the ValueList wants to honor Control level images for the ValueList items irrespective of the Appstyling  
Protected PropertyKeyLowercaseInterned (Inherited from Infragistics.Shared.KeyedSubObjectBase)
Protected PropertyPrimaryCollection (Inherited from Infragistics.Shared.KeyedSubObjectBase)
Protected PropertySubObjectPropChangeHandler (Inherited from Infragistics.Shared.SubObjectBase)
Public Methods
 NameDescription
Public MethodBumpContentsVersionBump's the contents version number  
Public MethodCloneClones the value list.  
Public MethodCreateObjRefCreates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from System.MarshalByRefObject)
Public MethodDispose (Inherited from Infragistics.Shared.DisposableObject)
Public MethodFindByDataValueReturns the the ValueListItem whose ValueListItem.DataValue property is equal to the specified dataValue, or null (Nothing in VB) if no item was found.  
Public MethodFindStringOverloaded. FindString method:Finds the first item which starts with the given string. The search is not case-sensitive. Returns -1 if no match found.  
Public MethodFindStringExactOverloaded. FindStringExact method: Finds the first item that contains the exact match for the specified string. The search is not case-sensitive.Returns -1 if no match is found.  
Public MethodGetItemHeightReturns the height of the item at the specified index  
Public MethodGetItemTextReturns the text of the item at the specified index  
Public MethodGetLifetimeServiceRetrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from System.MarshalByRefObject)
Public MethodInitAppearancesWhen using the Serialization constructor, appearances is set to null, so set it here  
Public MethodInitializeLifetimeServiceObtains a lifetime service object to control the lifetime policy for this instance. (Inherited from System.MarshalByRefObject)
Public MethodNotifyPropChangeOverloaded.  (Inherited from Infragistics.Shared.SubObjectBase)
Public MethodResetResets all properties  
Public MethodResetAppearanceResets the property to its default value  
Public MethodResetAutoSuggestHighlightAppearanceResets the property to its default value  
Public MethodResetAutoSuggestHighlightSelectedAppearanceResets the property to its default value  
Public MethodResetCheckBoxAlignmentResets the property to its default value.  
Public MethodResetCheckBoxStyleResets the property to its default value.  
Public MethodResetDisplayStyleResets DisplayStyle to its default value.  
Public MethodResetDrawModeSets the DrawMode property to its default value  
Public MethodResetDropDownListAlignmentSets the DropDownListAlignment property to its default value  
Public MethodResetDropDownListMinWidthSets the DropDownListMinWidth property to its default value  
Public MethodResetDropDownListWidthSets the DropDownListWidth property to its default value  
Public MethodResetDropDownResizeHandleAppearanceResets the DropDownResizeHandleAppearance property to its default value.  
Public MethodResetDropDownResizeHandleStyleResets the DropDownResizeHandleStyle property to its default value.  
Public MethodResetFormatFilteredItemsResets the FormatFilteredItems to its default value.  
Public MethodResetFormatProviderResets the FormatProvider property to its default value.  
Public MethodResetFormatStringResets the FormatString property to its default value.  
Public MethodResetItemHeightSets the ItemHeight property to its default value  
Public MethodResetItemMatchingModeRestores the value of the ItemMatchingMode property to its default.  
Public MethodResetKey (Inherited from Infragistics.Shared.KeyedSubObjectBase)
Public MethodResetMaxDropDownItemsSets the MaxDropDownItems property to its default value  
Public MethodResetPreferredDropDownSizeResets the PreferredDropDownSize properties to their default values.  
Public MethodResetScaleItemImageResets ScaleItemImage to its default value (OnlyWhenNeeded).  
Public MethodResetSortStyleResets SortStyle to its default value (none).  
Public MethodResetValueListItemsClears the list of ValueListItems  
Public MethodReSyncContentsRe-synchronizes the contents of the internal valuelist with the internal combo  
Public MethodSetCheckStateOverloaded. Sets the value of the CheckState property for each ValueListItem in this collection.  
Public MethodShouldSerializeKey (Inherited from Infragistics.Shared.KeyedSubObjectBase)
Public MethodShouldSerializeTag (Inherited from Infragistics.Shared.SubObjectBase)
Public MethodToStringOverridden to return the valuelist's key  
Public MethodVerifyNotDisposed (Inherited from Infragistics.Shared.DisposableObject)
Protected Methods
 NameDescription
Protected MethodDeserializeTagOverloaded.  (Inherited from Infragistics.Shared.SubObjectBase)
Protected MethodGetObjectDataInvoked during the serialization of the object.  
Protected MethodInitializeTag (Inherited from Infragistics.Shared.SubObjectBase)
Protected MethodMemberwiseCloneOverloaded. Creates a shallow copy of the current System.MarshalByRefObject object. (Inherited from System.MarshalByRefObject)
Protected MethodOnAddedToCollection (Inherited from Infragistics.Shared.KeyedSubObjectBase)
Protected MethodOnAfterDropDownResizeFires after the resize of dropdown has completed.  
Protected MethodOnBeforeDropDownResizeStartFires Before the DropDown Resize has started  
Protected MethodOnDeserializationInvoked after the entire object graph has been deserialized.  
Protected MethodOnDisposeOverridden. Called when the object is disposed of  
Protected MethodOnObjectPropChanged (Inherited from Infragistics.Shared.SubObjectBase)
Protected MethodOnRemovedFromCollection (Inherited from Infragistics.Shared.KeyedSubObjectBase)
Protected MethodOnSubObjectPropChangedOverridden. handles certain property change events  
Protected MethodResetInternedKey (Inherited from Infragistics.Shared.KeyedSubObjectBase)
Protected MethodResetTag (Inherited from Infragistics.Shared.SubObjectBase)
Protected MethodSerializeTagOverloaded.  (Inherited from Infragistics.Shared.SubObjectBase)
Protected MethodShouldSerializeAppearanceReturns true if the value is not the default  
Protected MethodShouldSerializeAutoSuggestHighlightAppearanceReturns true if the value is not the default  
Protected MethodShouldSerializeAutoSuggestHighlightSelectedAppearanceReturns true if the value is not the default  
Protected MethodShouldSerializeCheckBoxAlignmentReturns whether the CheckBoxAlignment property requires serialization  
Protected MethodShouldSerializeCheckBoxStyleReturns whether the CheckStyle property requires serialization  
Protected MethodShouldSerializeDisplayStyleReturns true if this property is not set to its default value  
Protected MethodShouldSerializeDropDownListAlignmentReturns true if the DropDownListAlignment property has been changed from its default value  
Protected MethodShouldSerializeDropDownListMinWidthReturns true if the DropDownListMinWidth property has been changed from its default value  
Protected MethodShouldSerializeDropDownListWidthReturns true if the DropDownListWidth property has been changed from its default value  
Protected MethodShouldSerializeDropDownResizeHandleAppearance

Returns a Boolean value that determines whether the DropDownResizeHandleAppearance property is set to its default value.

 
Protected MethodShouldSerializeDropDownResizeHandleStyle

Returns a Boolean value that determines whether the DropDownResizeHandleStyle property is set to its default value.

 
Protected MethodShouldSerializeFormatFilteredItemsReturns a boolean value indicating whether the FormatFilteredItems property requires serialization.  
Protected MethodShouldSerializeItemMatchingModeReturns a boolean value indicating whether the ItemMatchingMode property requires serialization.  
Protected MethodShouldSerializeMaxDropDownItemsReturns true if the MaxDropDownItems property has been changed from its default value  
Protected MethodShouldSerializePreferredDropDownSizeReturns true if this property is not set to its default value  
Protected MethodShouldSerializeScaleItemImageReturns true if the ScaleItemImage property is not set to its default value  
Protected MethodShouldSerializeSortStyleReturns true if this property is not set to its default value  
Protected MethodShouldSerializeValueListItemsReturns true if there are any items in the list  
Protected MethodVerifyItemsDerived classes can override this method to ensure that the valuelist items in the list are up-to-date.  
Public Events
 NameDescription
Public EventAfterDropDownResizeFired after dropdown has been resized.  
Public EventBeforeDropDownResizeStartFired before resize starts.  
Public EventDrawValueListItemFired when a ValueListItem is drawn  
Public EventListChangedFired when a ValueListItem is changed  
Public EventMeasureValueListItemFired when a ValueListItem is measured  
Public EventSubObjectDisposed (Inherited from Infragistics.Shared.SubObjectBase)
Public EventSubObjectPropChanged (Inherited from Infragistics.Shared.SubObjectBase)
See Also