IBindingDimCombo.DisplayUserTextAttr

Syntax

DisplayUserTextAttr: String;

Description

The DisplayUserTextAttr determines value of the DISPLAYUSERTEXTATTR parameter in the binding string.

Comments

The DISPLAYUSERTEXTATTR parameter determines custom names of elements of displayed dictionary attribute.

The parameter value is set in the binding string using the DisplayUserTextAttr property or manually as follows:

DISPLAYUSERTEXTATTR="VALUE"

Where:

VALUE. Parameter value. As a parameter value, one can use templates of available dictionary attributes. For example:

%NAME%. Element name.
%ID%. Element identifier.

In the Value Editor Parameters dialog box specify the value of this parameter using the Displayed Attribute parameter.

Example

Executing the example requires that the repository contains a regular report with the REGULAR_REPORT identifier and a dictionary with the DIMENSIONS identifier.

Add links to the Metabase, Report and Tab system assemblies.

Sub UserProc;
Var
    MB: IMetabase;
    Report: IPrxReport;
    BM: IBindingManager;
    DimComboBinding: IBindingDimCombo;
    Tab: ITabSheet;
    Style: ITabCellStyle;
    Binding: IBindingValue;
Begin
    // Get the current repository
    MB := MetabaseClass.Active;
    // Get regular report
    Report := MB.ItemById("REGULAR_REPORT").Edit As IPrxReport;
    // Get cell style in upper left corner of active report sheet
    Tab := (Report.ActiveSheet As IPrxTable).TabSheet;
    Style := Tab.Cell(0, 1).Style;
    // Create and set up value editor as a drop-down list
    BM := New BindingManager.Create;
    Binding := BM.CreateByUi("DimCombo");
    DimComboBinding := Binding As IBindingDimCombo;
    DimComboBinding.Object := "DIMENSIONS";
    DimComboBinding.DisplayUserTextAttr := "%KEY%";
    Style.Binding := DimComboBinding.AsString;
    // Save changes
    (Report As IMetabaseObject).Save;
End Sub UserProc;

After executing the example the value editor is set for the B0 cell in the regular report as a dictionary drop-down list with custom names of elements of the %KEY% displayed attribute.