ITabCellStyle.CustomFormat

Синтаксис Fore

CustomFormat: String;

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

CustomFormat: string;

Описание

Свойство CustomFormat определяет формат отображения данных в ячейке таблицы.

Свойство не зависит от региональных настроек интерфейса операционной системы, то есть при установке значения свойства, в качестве разделителей для данных в ячейке будут использоваться запятые и пробелы.

Формат отображения данных формируется с использованием зарезервированных кодов форматов. Описание кодов представлено в разделе «Формат числа». Задавайте формат отображения данных в русскоязычном варианте кода формата для корректного отображения при изменении языковых настроек интерфейса продукта «Форсайт. Аналитическая платформа». Например, формат отображения даты ДД.ММ.ГГГГ будет корректно отображаться при любом выбранном языке интерфейса. В то же время DD.MM.YYYY будет работать только в англоязычном варианте.

На значение данного свойства оказывает влияние свойство LocalCustomFormat: когда пользователь определяет для свойства LocalCustomFormat значение, то оно преобразуется к общей форме (без учета настроек региональных параметров) и устанавливается в свойство CustomFormat. Также при получении значения свойства LocalCustomFormat, оно возвращает значение свойства CustomFormat, преобразованное в локализованный формат в соответствии с региональными настройками.

Пример Fore

Для выполнения примера предполагается наличие формы, расположенной на ней кнопки с наименованием «Button1», компонента UiTabSheet с наименованием «UiTabSheet1» и компонента TabSheetBox. В настройках региональных параметров в качестве разделителя целой и дробной части числа указана точка.

Sub Button1OnClick(Sender: Object; Args: IMouseEventArgs);
Var Style: ITabCellStyle;
    Custom, Local: String;
Begin
    Style := UiTabSheet1.TabSheet.Cell(0, 0).Style;
    Style.CustomFormat := "0,00";
    Custom := Style.CustomFormat;
    Local := Style.LocalCustomFormat;
End Sub Button1OnClick;

После выполнения примера для ячейки «A0» будет установлен следующий формат: число с двумя десятичными знаками. Переменная «Custom» будет содержать общий шаблон для числа без учета региональных параметров: «0,00». Переменная «Local» будет содержать локализованный (в соответствии с региональными параметрами) шаблон для числа: «0.00».

Пример Fore.NET

Для выполнения примера предполагается наличие формы, расположенной на ней кнопки с наименованием «Button1», компонента UiTabSheetNet с наименованием «UiTabSheetNet1» и компонента TabSheetBoxNet. В настройках региональных параметров в качестве разделителя целой и дробной части числа указана точка.

Imports System;
Imports Prognoz.Platform.Forms.Net;
Imports Prognoz.Platform.Interop.Metabase;
Imports Prognoz.Platform.Interop.Tab;

Public Partial Class OBJ271Form: Prognoz.Platform.Forms.Net.ForeNetForm
    Public Constructor OBJ271Form();
    Begin
        InitializeComponent();
    End Constructor;

    Private Sub button1_Click(sender: System.Object; e: System.EventArgs);
    Var Style: ITabCellStyle;
        Custom, Local: String;
    Begin
        Style := UiTabSheetNet1.TabSheetUi.TabSheet.Cell[0, 0].Style;
        Style.CustomFormat := "0,00";
        Custom := Style.CustomFormat;
        Local := Style.LocalCustomFormat;
    End Sub;
End Class;

См. также: