搬运工
搬运工

Fv

 约 7892 字   预计阅读 16 分钟 

Fv是FormView的缩写，数据表单编辑控件，因使用频率高采用缩写作为控件名称，该控件也可当做布局控件使用。

布局

为统一两模式下的布局方式，采用自定义布局面板FormPanel，单元格的宽度根据实际区域自动调整，在296-456px之间，高度按行数计算，每行高度41px，内容高度实际40px。

通过指定RowSpan来设置行数，当RowSpan为-1时，根据内容高度自动计算所占行数。

通过ColSpan设置单元格占用列的比例，取值范围 0~1，0表示水平填充，1表示占满整列，默认1。

布局算法为：

  • 根据表单实际区域大小和单元格数量决定每个单元格的位置，优先按列排；
  • 当单元格的数量按照一列摆放，未排满高度的80%时，或表单总宽度无法容纳两列时(<296 X 2)时，只摆放一列，phone模式基本一列；
  • 能够摆放两列，按照一列摆放超过80%或无法容纳三列时，摆放两列；
  • 能够摆放三列，按照两列摆放超过80%或无法容纳四列时，摆放三列；
  • 暂时最多支持摆放四列。
  • 当表单区域无法摆放所有单元格时，显示垂直滚动栏，始终无水平滚动。

Fv可以作为普通的布局控件使用，为获得单元格样式的控制，通常将普通控件放在CFree内，达到和普通单元格相同的控制，可以设置标题、标题宽度、是否显示标题、是否显示红星、所占行数等，但内嵌的普通控件不参与数据的绑定、编辑等功能，当内嵌控件实现IFreeCell接口后，成为自定义格，作为布局控件使用时如：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

<a:Fv x:Name="_fv">
    <a:CFree Title="文本框">
        <TextBox />
    </a:CFree>
    <TextBox Text="文本框" />
    <a:CFree Title="自动行高" RowSpan="-1">
        <TextBox AcceptsReturn="True" MinHeight="130" />
    </a:CFree>
    <Button Content="&#xE06E;" Style="{StaticResource 字符按钮}" HorizontalAlignment="Center" />
    <CheckBox Content="选择框" />
    <a:CFree Title="选择框">
        <CheckBox />
    </a:CFree>
    <a:CBar Title="水平填充自动行高" />
</a:Fv>

数据源

数据源可以为Row或普通对象，Row时将Cell值绑定到单元格，普通对象时将属性绑定到单元格，支持多级属性，根据属性是否可写控制单元格是否可编辑，因此Fv还可作为属性编辑器独立使用。针对不同的数据类型内部提供多种通用格，实现数据编辑。

通过Fv.Data设置数据源，根据单元格ID将对应的数据项绑定到单元格，编辑后新值再同步到数据源，完成数据修改功能。

Fv支持根据数据源自动生成单元格的功能，通过Fv.AutoCreateCell控制，内部根据数据项的数据类型生成对应格，外部无法动态指定，使用场景较少。

在切换数据源时，Fv只处理含ID的单元格，其它单元格怕有影响未设置DataContext！

上级元素或当前元素设置DataContext时，所有绑定中未指明数据源的都使用继承的DataContext，当绑定模式为TwoWay或OneWay时，DataContext必须实现INotifyPropertyChanged接口才能将修改值传递到绑定的UI，DataContext继承DependencyObject的依赖属性也无效，但直接在绑定中指定数据源时依赖属性有效！

数据源为null时，隐藏所有含ID的单元格编辑器，避免误操作。

数据源为普通对象时，已实现和Row相同的功能，包括Fv.Changed事件、FvCell.Changed事件、淡黄色修改状态样式、支持撤销等功能，对普通对象没有特殊要求，内部采用包装方式进行功能扩展(ObjectView PropertyView)。

列值变化事件Fv.Changed，使用场景较少，Row的所有列值变化都触发，不只是FvCell绑定的列，普通对象只有UI对应的属性变化时触发。

数据源列值的初始值，主要有以下几种情况：

  • 普通默认值
  • 获取服务端的序列值
  • CList格自动取第一行
  • 内置表达式
  • 单元格cookie值等

格

格是表单编辑的最小单位，负责数据的显示、交互编辑、新值同步到数据源等功能，格之间可能存在联动关系，内部提供多种格：普通文本格、数值格、掩码格、布尔格、列表格、时间格、图标选择格、颜色选择格、文件格、图像格、自定义格等，还包括分割栏、链接格等无编辑功能的格，每种类型的格有自己的行为控制，实现常见的编辑功能。

格的基类为FvCell，实现公共样式和功能，常用属性如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

public partial class FvCell : DtControl, IFvCell
{
    /// <summary>
    /// 获取设置列名(字段名或属性名)
    /// </summary>
    public string ID

    /// <summary>
    /// 获取设置列标题
    /// </summary>
    public string Title

    /// <summary>
    /// 获取设置列名的宽度
    /// </summary>
    public double TitleWidth

    /// <summary>
    /// 获取设置是否显示标题列
    /// </summary>
    public bool ShowTitle

    /// <summary>
    /// 获取设置自定义取值赋值过程的类名
    /// </summary>
    public string Call

    /// <summary>
    /// 获取设置是否垂直显示标题
    /// </summary>
    public bool IsVerticalTitle

    /// <summary>
    /// 获取设置占用的行数，默认1行，-1时自动行高
    /// </summary>
    public int RowSpan

    /// <summary>
    /// 获取设置单元格占用列的比例，取值范围 0~1，0表示水平填充，1表示占满整列，默认1
    /// </summary>
    public double ColSpan

    /// <summary>
    /// 获取设置列是否只读，最终是否只读由ReadOnlyBinding确定！
    /// </summary>
    public bool IsReadOnly

    /// <summary>
    /// 获取设置是否自动保存单元格最后一次编辑值，默认False
    /// </summary>
    public bool AutoCookie

    /// <summary>
    /// 获取设置占位符文本
    /// </summary>
    public string Placeholder

    /// <summary>
    /// 获取设置查询时对条件比较符控制：无比较符、可修改比较符、比较符只读
    /// </summary>
    public QueryType Query

    /// <summary>
    /// 获取设置查询时的条件比较符
    /// </summary>
    public CompFlag QueryFlag
}

其中Call属性是自定义取值赋值过程的类名，相当于数据源和格之间绑定的转换器，这部分转换也可以放在数据源中统一处理，该类的定义过程如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

[FvCall]
public class TenTimesMid : IFvCall
{
    public object Get(Mid m)
    {
        return m.Int / 100;
    }

    public object Set(Mid m)
    {
        return m.Int * 100;
    }
}

CBar

CBar是单元格分隔行，主要为单元格分组，使界面功能更清晰，无编辑功能，提供默认样式： /dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/1.png

xaml定义如：

1
2
3
4
5
6
7
8

<a:CBar Title="基本格" />

<a:CBar>
    <StackPanel Orientation="Horizontal">
        <Button Content="切换第一格内容" />
        <Button Content="切换CBar内容" />
    </StackPanel>
</a:CBar>

链接格，功能和按钮相同，触发Click事件，无编辑功能，内容样式采用手机App常用样式，继承自CBar，使用方法和CBar相同。默认样式：

/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/2.png

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

<a:CLink Title="默认链接格" />

<a:CLink Title="切换内容" ColSpan="1" Click="OnToggleLink" />

<a:CLink Click="OnEditInfo" RowSpan="2">
    <Grid>
        <Grid.ColumnDefinitions>
            <ColumnDefinition Width="Auto" />
            <ColumnDefinition Width="*" />
            <ColumnDefinition Width="Auto" />
        </Grid.ColumnDefinitions>
        <Image x:Name="_img" Width="50" Height="50" Margin="0,0,20,0" />
        <StackPanel VerticalAlignment="Center" Grid.Column="1">
            <TextBlock x:Name="_tbName" FontSize="{StaticResource 标题字}" />
            <TextBlock x:Name="_tbPhone" Foreground="{StaticResource 深灰2}" />
        </StackPanel>
        <TextBlock Text="编辑" Foreground="{StaticResource 深灰2}" VerticalAlignment="Center" Grid.Column="2" />
    </Grid>
</a:CLink>
<a:CBar />
<a:CLink Title="我的二维码" />

CFree

自定义格，可以自定义编辑器，当向Fv.Items添加普通UI时，这些UI会用CFree包裹，如：

1
2
3
4
5
6
7

<a:CFree Title="文本框">
    <TextBox />
</a:CFree>
<TextBox Text="文本框" />
<a:CFree Title="自动行高" RowSpan="-1">
    <TextBox AcceptsReturn="True" MinHeight="130" />
</a:CFree>

CText

普通文本格，文本框功能，使用频率最高，属性：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

/// <summary>
/// 获取设置是否允许多行显示，默认false
/// </summary>
public bool AcceptsReturn

/// <summary>
/// 获取设置可在文本框中键入或粘贴的最大字符数，默认0无限制
/// </summary>
public int MaxLength

/// <summary>
/// 获取设置是否实时更新值，默认true实时更新
/// </summary>
public bool UpdateTimely

/// <summary>
/// 获取设置输入法，输入法始终不可为null，不然uno中文本框右侧的清空按钮失效！！！
/// </summary>
public InputScope InputScope

/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/3.png

CNum

数值格，可在样例中动态调整各属性测试功能，属性：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

/// <summary>
/// 获取设置当前值
/// </summary>
public double Value

/// <summary>
/// 获取设置是否为整型数值
/// </summary>
public bool IsInteger

/// <summary>
/// 获取设置小数位数
/// </summary>
public int Decimals

/// <summary>
/// 获取设置最大值
/// </summary>
public double Maximum

/// <summary>
/// 获取设置最小值
/// </summary>
public double Minimum

/// <summary>
/// 获取设置格式化显示
/// </summary>
public ValueFormat ValueFormat

/// <summary>
/// 获取设置是否实时更新Cell值
/// </summary>
public bool UpdateTimely

/// <summary>
/// 获取设置自定义单位，显示在数字后面
/// </summary>
public string CustomUnit

/// <summary>
/// 获取设置为空时显示的字符串
/// </summary>
public string NullValue

/// <summary>
/// 获取设置最大变化量
/// </summary>
public double LargeChange

/// <summary>
/// 获取设置最小变化量
/// </summary>
public double SmallChange

/// <summary>
/// 获取设置是否可自动循环调值
/// </summary>
public bool AutoReverse

/// <summary>
/// 获取设置区域格式
/// </summary>
public NumberFormatInfo NumberFormatInfo

CMask

掩码格，支持原有PC版的所有掩码功能，可在样例中动态调整各属性测试功能，属性：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

/// <summary>
/// 掩码类型
/// </summary>
public MaskType MaskType

/// <summary>
/// 掩码表达式
/// </summary>
public string Mask

/// <summary>
/// 是否显示掩码占位符，RegEx有效
/// </summary>
public bool ShowPlaceHolder

/// <summary>
/// 掩码占位符，RegEx有效
/// </summary>
public char PlaceHolder

/// <summary>
/// 是否保存为转换后的结果，Simple、Regular有效
/// </summary>
public bool SaveLiteral

/// <summary>
/// 自动完成方式，RegEx有效
/// </summary>
public AutoCompleteType AutoComplete

/// <summary>
/// 是否按掩码格式化显示
/// </summary>
public bool UseAsDisplayFormat

/// <summary>
/// 输入是否可为空
/// </summary>
public bool AllowNullInput

/// <summary>
/// 忽略空格
/// </summary>
public bool IgnoreBlank

CDate

日期时间格，提供两种模式的选择器，触摸模式选择器支持点击日期时选择日期和点击时间时选择时间，属性：

1
2
3
4
5
6
7
8
9

/// <summary>
/// 获取设置格式串，默认 yyyy-MM-dd，完整如：yyyy-MM-dd HH:mm:ss
/// </summary>
public string Format

/// <summary>
/// 获取设置是否始终为触摸模式选择器，默认 false
/// </summary>
public bool AlwaysTouchPicker

/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/4.png /dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/5.png

CBool

布尔格，提供选择框和开关两种显示控件，属性：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

/// <summary>
/// 获取设置是否显示为开关，默认false为选择框
/// </summary>
public bool IsSwitch

/// <summary>
/// 获取设置True时的值
/// </summary>
public object TrueVal

/// <summary>
/// 获取设置False时的值
/// </summary>
public object FalseVal

/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/6.png

CList

列表选择格，该格使用场景较多，列表数据源复杂，支持单选、多选，支持选择后同步填充多列值功能，总体数据绑定关系为：

/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/7.png

选择列表由ListDlg显示，该对话框主要包含Lv控件，Lv数据源来自于CList属性设置，数据源种类有多种，具有不同优先级：

  1. 直接设置Data属性
  2. 通过LoadData事件加载数据
    1
2
3
4
5
6

    <a:CList ID="listobj" Title="对象列表" LoadData="OnLoadPersons">

void OnLoadPersons(object sender, AsyncEventArgs e)
{
    ((CList)sender).Data = SampleData.CreatePersonsList(20);
}
  3. 设置Ex属性，该属性是类名#参数的字符串，类需要继承自CListEx，重写方法可控制下拉对话框和数据源。以下是Ex属性、CListEx定义、EnumData和Option扩展的例子：
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

    /// <summary>
/// 获取设置扩展CList功能的类名和参数，用于控制下拉对话框和数据源，类名和参数之间用#隔开，如：
/// <para>EnumData#Dt.Base.DlgPlacement,Dt.Base</para>
/// <para>Option#民族</para>
/// </summary>
public string Ex

/// <summary>
/// CList功能扩展基类
/// </summary>
public abstract class CListEx
{
    protected CList _owner;
    protected ListDlg _dlg;
    protected string _params;

    public void Init(CList p_owner, ListDlg p_dlg, string p_params)
    {
        _owner = p_owner;
        _dlg = p_dlg;
        _params = p_params;
        OnInit();
    }

    protected virtual void OnInit()
    {
    }

    public abstract Task<INotifyList> GetData();
}

/// <summary>
/// 枚举类型作为下拉框数据源
/// </summary>
[CListEx]
public class EnumData : CListEx
{
    /// <summary>
    /// 格式：枚举名(包含命名空间),程序集；如：
    /// <para>Dt.Base.CtType,Dt.Base</para>
    /// </summary>
    /// <returns></returns>
    /// <exception cref="Exception"></exception>
    public override Task<INotifyList> GetData()
    {
        // 枚举数据
        Type type = Type.GetType(_params, true, true);
        var data = (INotifyList)_dlg.CreateEnumData(type);
        return Task.FromResult(data);
    }
}

/// <summary>
/// 模型库的OmOption作为下拉框数据源
/// </summary>
[CListEx]
public class Option : CListEx
{
    /// <summary>
    /// 格式：枚举名(包含命名空间),程序集；如：
    /// <para>Dt.Base.CtType,Dt.Base</para>
    /// </summary>
    /// <returns></returns>
    /// <exception cref="Exception"></exception>
    public override async Task<INotifyList> GetData()
    {
        return await AtModel.Query($"select name from OmOption where Category=\"{_params}\"");
    }
}
  4. 格的数据源类型为枚举时，自动生成Enum数据
  5. 外部(xaml中)定义的对象列表
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

    <a:CList ID="liststr" Title="字符串列表">
    <a:CList.Items>
        <x:String>选项一</x:String>
        <x:String>选项二</x:String>
        <x:String>选项三</x:String>
        <x:String>选项四</x:String>
        <x:String>选项五</x:String>
        <x:String>选项六</x:String>
    </a:CList.Items>
</a:CList>
<a:CList ID="listint" Title="整数列表">
    <a:CList.Items>
        <x:Int32>1</x:Int32>
        <x:Int32>2</x:Int32>
        <x:Int32>3</x:Int32>
    </a:CList.Items>
</a:CList>
<a:CList ID="idstrdsp" Title="IDStr" SrcID="id" TgtID="idstr">
    <a:CList.Items>
        <a:IDStr ID="0" Str="选项一" />
        <a:IDStr ID="1" Str="选项二" />
        <a:IDStr ID="2" Str="选项三" />
    </a:CList.Items>
</a:CList>
注意

数据源为Table时，确保存在name列；

为普通对象时，直接将对象赋值！

选择后需要同步填充多列时需要设置以下两属性，确保源和目标的属性个数相同：

1
2
3
4
5
6
7
8
9

/// <summary>
/// 获取设置源属性列表，用'#'隔开
/// </summary>
public string SrcID

/// <summary>
/// 获取设置目标属性列表，用'#'隔开
/// </summary>
public string TgtID

该功能可实现IDString效果，当在xaml中直接设置数据源时可以使用IDStr，如：

1
2
3
4
5
6
7

<a:CList ID="idstrdsp" Title="IDStr" SrcID="id" TgtID="idstr">
    <a:CList.Items>
        <a:IDStr ID="0" Str="选项一" />
        <a:IDStr ID="1" Str="选项二" />
        <a:IDStr ID="2" Str="选项三" />
    </a:CList.Items>
</a:CList>

每次选择显示ListDlg时都刷新选择列表时可以设置属性：

1
2
3
4
5

/// <summary>
/// 获取设置是否动态加载数据源，默认false
/// true表示每次显示对话框时都加载数据源，false表示只第一次加载
/// </summary>
public bool RefreshData

格的数据源类型为枚举时，系统自动生成Enum数据，推荐方案如：

在表结构中定义enum类型字段：

/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/8.png

注意

mysql中tinyint(1)对应C#的bool，无符号的tinyint(4)对应byte，有符号tinyint(4)对应SByte(使用场景少)。

为了编码、查询、显示方便，特殊处理了enum类型的情况，将无符号tinyint(4)设计为enum类型，最多能存储256个成员在程序中已够用，生成实体类时支持自动将#EnumName#开始的注释当作枚举类型，增加方便性和代码的可读性。

在程序中定义enum类型：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

public enum WfdAtvTransKind
{
    /// <summary>
    /// 自由选择后续迁移
    /// </summary>
    自由选择,

    /// <summary>
    /// 活动的所有后续迁移都执行
    /// </summary>
    全部,

    /// <summary>
    /// 只允许选择一条后续迁移
    /// </summary>
    独占式选择
}

xaml中CList不需要任何设置，因单元格数据源类型是enum，自动生成下拉列表内容：

1

<a:CList ID="transkind" Title="后续迁移方式" />

运行时：

/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/9.png

CFile

文件格的控件模板未使用公共的CellPanel，采用完全自定义方式：

/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/10.png

文件格默认为自动行高(RowSpan = -1)，避免出现局部区域的滚动栏，所占区域会根据文件列表个数自动调整，为使Fv整体布局统一，普通文件和图片文件默认高度82，占两行，视频文件占5行。

模板第一行为标题栏，左侧标题，右侧工具栏，第二行为FileList。

FileList.Data与格的Value绑定，FileList的上传下载删除等操作会触发CFile.Changed事件，因此可以通过Changed事件在操作后自动保存。

文件格提供默认的工具栏内容（只有一个添加按钮），当需要上传拍照或录视频等其他功能时可自定义工具栏，工具栏的DataContext为当前的FileList，因此按钮可将Command绑定到FileList命令上。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

<a:CFile ID="file2" Title="多文件" Changed="OnChanged">
    <a:CFile.Toolbar>
        <StackPanel Orientation="Horizontal">
            <Button Content="图片" Command="{Binding CmdAddImage}" />
            <Button Content="视频" Command="{Binding CmdAddVideo}" />
            <Button Content="音频" Command="{Binding CmdAddAudio}" />
            <Button Content="录音" Command="{Binding CmdCaptureVoice}" />
            <Button Content="拍照" Command="{Binding CmdTakePhoto}" />
            <Button Content="录像" Command="{Binding CmdRecordVideo}" />
        </StackPanel>
    </a:CFile.Toolbar>
    <a:Ex.Menu>
        <a:Menu>
            <a:Mi ID="下载" Icon="向下" Cmd="{Binding CmdDownload}" />
            <a:Mi ID="打开" Icon="打开" Cmd="{Binding CmdOpen}" />
        </a:Menu>
    </a:Ex.Menu>
</a:CFile>
/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/11.png

文件格提供默认上下文菜单，也可以自定义菜单，如上图采用扩展依赖项属性Ex.Menu，菜单的DataContext为当前所属的FileItem，因此也可将Mi的Cmd绑定到FileItem命令上。默认菜单如下：

/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/12.png

文件格中用于控制FileList的属性采用包裹方式直接设置到FileList，如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

/// <summary>
/// 获取设置列数，默认1列
/// </summary>
public int ColCount

/// <summary>
/// 获取设置文件项之间的间隔距离，默认0
/// </summary>
public double Spacing

/// <summary>
/// 获取设置图像的显示高度，默认82，0表示和宽度相同
/// </summary>
public double ImageHeight

/// <summary>
///  获取设置图像填充模式，默认Uniform
/// </summary>
public Stretch ImageStretch

/// <summary>
/// 获取设置文件项是否可点击，默认true
/// </summary>
public bool EnableClick

/// <summary>
/// 获取设置文件数量上限，默认int.MaxValue
/// </summary>
public int MaxFileCount

/// <summary>
/// 获取设置要上传的固定卷名，默认null表示上传到普通卷
/// </summary>
public string FixedVolume

工具栏菜单相关的属性：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

/// <summary>
/// 获取设置工具栏内容
/// </summary>
public FrameworkElement Toolbar

/// <summary>
/// 获取设置是否显示默认工具栏，默认true
/// </summary>
public bool ShowDefaultToolbar

/// <summary>
/// 获取设置是否显示默认菜单，默认true
/// </summary>
public bool ShowDefaultMenu

CImage

图像格是只有一个图像的文件格，内部也使用FileList、自动行高、提供默认上下文菜单，不同的是它采用CellPanel布局、无工具栏。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

<a:CImage ID="img1" Title="图像" />
<a:CImage ID="img2" Title="无图像" />
<a:CImage ID="img3" Title="自定义菜单">
    <a:Ex.Menu>
        <a:Menu>
            <a:Mi ID="下载" Icon="向下" Cmd="{Binding CmdDownload}" />
            <a:Mi ID="打开" Icon="打开" Cmd="{Binding CmdOpen}" />
        </a:Menu>
    </a:Ex.Menu>
</a:CImage>

/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/13.png

Phone模式：

/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/14.png

CIcon

图标选择格，内部未使用绑定，采用直接取值/赋值的方式，图标列表使用Icons枚举，对应内部自定义的矢量字体库。

1
2
3

<a:CIcon ID="icon" Title="枚举图标"/>
<a:CIcon ID="iconint" Title="整数图标"/>
<a:CIcon ID="iconstr" Title="名称图标"/>
/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/15.png

CColor

颜色选择格，内部未使用绑定，采用直接取值/赋值的方式，选择列表使用Colors枚举，暂未提供自定义功能。

1
2
3

<a:CColor ID="color" Title="颜色"/>
<a:CColor ID="colorstr" Title="颜色字符串"/>
<a:CColor ID="colorbrush" Title="颜色画刷"/>
/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/16.png

CTree

树形选择格，使用上和CList相似，有两种方式设置Tv数据源：

  • 一种直接设置Data属性
  • 另一种通过LoadData事件动态加载

支持单选、多选，支持选择后同步填充多列值功能，支持动态加载树数据源。

1
2
3

<a:CTree ID="tree" Title="普通树" LoadData="OnLoadTreeData" />
<a:CTree ID="treedata" Title="动态树" RefreshData="true" LoadData="OnLoadTreeData" />
<a:CTree ID="treefill" Title="填充其它列值" SrcID="id" TgtID="treefillid" LoadData="OnLoadTreeData" />
/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/17.png

CPassword

密码格，属性：

1
2
3
4
5
6
7
8
9

/// <summary>
/// 获取设置占位符
/// </summary>
public string Holder

/// <summary>
/// 获取设置最大字符数
/// </summary>
public int MaxLength
/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/18.png

CHtml

基于html的富文本格，内嵌WebView对html内容进行编辑和浏览，html编辑器使用Froala Editor(V3.1.1)，功能强大界面美观，支持手机操作，但uno中WebView暂不支持InvokeScriptAsync方法，还无法设置或获取编辑器中的html。

编辑框的保存按钮只是将编辑后的html赋值到数据源，若需要同时保存到数据库或其他操作请处理Saved事件。

CTip

只读信息格，和其他编辑格相同，也是通过ID绑定到数据源来显示只读信息，但只适用于需要始终只读的格，以上编辑格如CText提供只读/编辑两种模式，可以根据需求在两模式之间动态切换，但CTip始终只读。用法简单，支持指定通用格式化串：

1
2
3
4

<a:CTip ID="tip" Title="普通只读信息" />
<a:CTip ID="tipdate" Title="日期信息" />
<a:CTip ID="tipnum" Title="数字信息" Format="N2" />
<a:CTip ID="tipclick" Title="点击事件" Click="OnTipClick" />
/dt-docs/3%E5%AE%A2%E6%88%B7%E7%AB%AF/3fv/19.png