MakeUniqueChoice Method

Generates a unique Text value for a choice.

Syntax

MakeUniqueChoice(ByVal Type as String, ByVal Prefix as String, [Options as String]) as String

Parameters

Type

The types of choices to compare Text against

Prefix

The text to prepend to the returned choice text

Options

An enumerated value. One of dtcUniqueOverAvailableChoices or dtcUniqueOverAllChoices.

• Use dtcUniqueOverAvailableChoices if the returned text needs to be locally unique. Normal filtering is used when generating a list of possible conflicts.
  
  
• Use dtcUniqueOverAllChoices if the returned text must be globally unique (the default). Filters are ignored.

Remarks

This method returns a string which is unique over the Text values of available Choice objects by appending a numeral to the given string prefix.

Typically, this method is called when initializing a new control during the first OnRebind method. The unique text is usually given to a Choice object that has its TextMustBeUnique property set to True. This method is not available to design-time control Set objects.

Applies to   IDesignTimeControlSite interface