IPrxControl.Value

Синтаксис Fore

Value: Variant;

Синтаксис Fore.NET

Value: Object;

Описание

Свойство Value определяет значение, установленное в элементе управления.

для элемента управления BooleanCombo: логическое значение True или False;
для элемента управления CheckBox: логическое значение True или False;
для элемента управления ComboBox: наименование элемента, присутствующего в списке элемента управления;
для элемента управления DatePicker: значение типа DateTime, содержащее требуемое значение компоненты даты;
для элемента управления DateTimePicker: значение типа DateTime, содержащее требуемые значения компонент даты и времени;
для элемента управления DecimalEdit: значение типа Decimal;
для элемента управления DimCombo: допустимы различные значения, более подробно смотрите комментарии ниже;
для элемента управления EditBox: любое строковое значение;
для элемента управления FloatEdit: любое вещественное значение;
для элемента управления IdentEdit: любое строковое значение, удовлетворяющее требованиям к идентификаторам;
для элемента управления IntegerEdit: любое целочисленное значение;
для элемента управления MaskEdit: значение в соответствии с установленным шаблоном ввода;
для элемента управления TimePicker: значение типа DateTime, содержащее требуемое значение компоненты времени;
для элемента управления TreeCombo: наименование элемента, присутствующего в списке элемента управления.

DimCombo

При использовании элемента управления DimCombo, в зависимости от наличия привязки для управления измерением, доступны различные значения свойства Value:

Если элемент управления не связан с измерением или связан с измерением аналитической области данных, описываемой интерфейсом IEaxDataArea, то в качестве значения свойства Value задается:

значение атрибута при единичной отметке;
массив типа Variant со значениями атрибута при множественной отметке.

Атрибут задаётся в параметре ATTRIBUTEVALUE в строке связи. Если параметр ATTRIBUTEVALUE отсутствует, то используется атрибут с назначением «Идентификатор». При формировании строки связи определить значение параметра ATTRIBUTEVALUE можно с помощью свойства ValueAttribute.

Если элемент управления связан с измерением области данных, описываемой интерфейсом IPrxDataIsland, то в качестве значения свойства Value указывается отметка справочника, описываемая интерфейсом IDimSelection. Отметка должна соответствовать тому справочнику, который используется в качестве элемента управления.

Для сброса значения элемента управления задайте свойству Value значение Null.

Пример Fore

Sub GetControlValue(Control: IPrxControl);
Var
    Arr: Array;
    i: Integer;
    BM: IBindingManager;
    Binding: IBindingValue;
Begin
    //Если в элементе управления задано значение, то получим и выведем его в консоль
    If Control.Value.VarType <> ForeVariantType.NullValue Then
        Debug.Write("Значение(я) элемента управления: ");
        //Если массив, то просматриваем значения всех элементов массива
        If Control.Value.VarType = ForeVariantType.Matrix Then
            Arr := Control.Value As Array;
            For i := 0 To Arr.Length - 1 Do
                Debug.Write(Arr[i] + " ");
            End For;
            Debug.WriteLine("");
        //Если объект, то приводим к IDimSelection и получаем количество отмеченных
        Elseif Control.Value.VarType = ForeVariantType.Object Then
            Debug.WriteLine("Отметка IDimSelection. Выделено: " + (Control.Value As IDimSelection).SelectedCount.ToString);
        //Если не массив и не объект, то просто выводим значение
        Else
            Debug.WriteLine(Control.Value);
        End If;
        //Атрибут, управляющий значением
        BM := New BindingManager.Create;
        Binding := BM.CreateByValue(Control.Binding);
        Debug.WriteLine("Атрибут, управляющий значением: "
            + (Binding As IBindingDimCombo).ValueAttribute);
    End If;
End Sub GetControlValue;

Указанная функция может использоваться для получения значения элемента управления, в основе которого лежит редактор DimCombo. Полученные значения выводятся в консоль среды разработки, а также в консоль выводится идентификатор атрибута справочника, значения которого формируют значение элемента управления.

Пример Fore.NET

Необходимые требования и результат выполнения примера Fore.NET совпадают с примером Fore.

Imports Prognoz.Platform.Interop.Dimensions;
Imports Prognoz.Platform.Interop.ForeSystem;
Imports Prognoz.Platform.Interop.Report;

Sub GetControlValue(Control: IPrxControl);
Var
    Arr: Array;
    i: Integer;
    BM: IBindingManager = New BindingManagerClass();
    Binding: IBindingValue;
Begin
    //Если в элементе управления задано значение, то получим и выведем его в консоль
    If Control.Value <> Null Then
        System.Diagnostics.Debug.Write("Значение(я) элемента управления: ");
        //Если массив, то просматриваем значения всех элементов массива
        If Control.Value Is Array Then
            Arr := Control.Value As Array;
            For i := 0 To Arr.Length - 1 Do
                System.Diagnostics.Debug.Write(Arr[i] + " ");
            End For;
            System.Diagnostics.Debug.WriteLine("");
        //Если объект, то приводим к IDimSelection и получаем количество отмеченных
        Elseif Control.Value Is IDimSelection Then
            System.Diagnostics.Debug.WriteLine("Отметка IDimSelection. Выделено: " + (Control.Value As IDimSelection).SelectedCount.ToString());
        //Если не массив и не объект, то просто выводим значение
        Else
            System.Diagnostics.Debug.WriteLine(Control.Value);
        End If;
        //Атрибут, управляющий значением
        Binding := BM.CreateByValue(Control.Binding);
        System.Diagnostics.Debug.WriteLine("Атрибут, управляющий значением: "
            + (Binding As IBindingDimCombo).ValueAttribute);
    End If;
End Sub;

См. также:

IPrxControl