Value: Variant;
Свойство Value определяет значение, установленное в элементе управления.
Значение, определяемое в свойстве Value, зависит от типа используемого элемента управления:
для элемента управления BooleanCombo: логическое значение True или False;
для элемента управления CheckBox: логическое значение True или False;
для элемента управления ComboBox: наименование элемента, присутствующего в списке элемента управления;
для элемента управления DatePicker: значение типа DateTime, содержащее требуемое значение компоненты даты;
для элемента управления DateTimePicker: значение типа DateTime, содержащее требуемые значения компонент даты и времени;
для элемента управления DecimalEdit: значение типа Decimal;
для элемента управления DimCombo: допустимы различные значения, более подробно смотрите комментарии ниже;
для элемента управления EditBox: любое строковое значение;
для элемента управления FloatEdit: любое вещественное значение;
для элемента управления IdentEdit: любое строковое значение, удовлетворяющее требованиям к идентификаторам;
для элемента управления IntegerEdit: любое целочисленное значение;
для элемента управления MaskEdit: значение в соответствии с установленным шаблоном ввода;
для элемента управления TimePicker: значение типа DateTime, содержащее требуемое значение компоненты времени;
для элемента управления TreeCombo: наименование элемента, присутствующего в списке элемента управления.
При использовании элемента управления DimCombo, в зависимости от наличия привязки для управления измерением, доступны различные значения свойства Value:
Если элемент управления не связан с измерением или связан с измерением аналитической области данных, описываемой интерфейсом IEaxDataArea, то в качестве значения свойства Value задается:
значение атрибута при единичной отметке;
массив типа Variant со значениями атрибута при множественной отметке.
Атрибут задаётся в параметре ATTRIBUTEVALUE в строке связи. Если параметр ATTRIBUTEVALUE отсутствует, то используется атрибут с назначением «Идентификатор». При формировании строки связи определить значение параметра ATTRIBUTEVALUE можно с помощью свойства ValueAttribute.
Если элемент управления связан с измерением области данных, описываемой интерфейсом IPrxDataIsland, то в качестве значения свойства Value указывается отметка справочника, описываемая интерфейсом IDimSelection. Отметка должна соответствовать тому справочнику, который используется в качестве элемента управления.
Для сброса значения элемента управления задайте свойству Value значение Null.
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. Полученные значения выводятся в консоль среды разработки, а также в консоль выводится идентификатор атрибута справочника, значения которого формируют значение элемента управления.
См. также: