ApeForms | C# - WinForm临时对话框（消息框、提示框、输入框、密码框、单选框、多选框等）

ApeForms | Dialog组件

前言

ApeForms一款基于WinForm实现的开源免费商用的UI库，其中提供了一套便于用户交互的临时对话框组件（Dialog），可用于快速创建开发中常见的交互对话框，例如：消息框、提示框、输入框、单选框、多选框等。

ApeFree.ApeDialogs并不是一个包含Dialog实现的UI库，而是一套Dialog标准（提供了一套临时弹出对话框的实现标准）。 Dialog是界面开发过程中必不可少的组件，无论是桌面开发、Web前端开发、移动端开发，甚至命令行应用程序中的一次“Yes or No”的输入都可以看做是一次Dialog弹框。

示例

准备步骤

如下所示，创建Dialog提供器：

ApeFormsDialogProvider provider = DialogFactory.Factory.GetApeFormsDialogProvider();

消息对话框 MessageDialog

            var dialog = provider.CreateMessageDialog(s =>
            {
                // 是否可取消
                s.Cancelable = true;
                // 修改确认键文本
                s.ConfirmOption.Text = "知道了";
                // 修改Dialog窗体尺寸
                s.DialogSize = new Size(400, 250);
                // 修改标题名
                s.Title = tbTitle.Text;
                // 修改文本内容
                s.Content = tbContent.Text;
            });
            dialog.Show();

输入对话框 InputDialog

            var dialog = provider.CreateInputDialog(s =>
            {
                // 标题文本
                s.Title = tbTitle.Text;
                // 消息文本
                s.Content = tbContent.Text;
                // 输入框默认文本
                s.DefaultText = "You can set the default text in the input box by using the 'DefaultText' property.";
                // 是否可取消
                s.Cancelable = true;
                // 是否允许输入为空
                s.AllowEmpty = false;
                // 输入文本最大长度
                s.MaximumLength = 200;
                // 输入文本最小长度
                s.MinimumLength = 6;
                // 是否多行
                s.IsMultiline = false;
                // 确认按钮文本
                s.ConfirmOption.Text = "Confirm(确定)";
                // 取消按钮文本
                s.CancelOption.Text = "Cancel(取消)";
                // 清空按钮文本
                s.ClearOption.Text = "Clear(清空)";
            });

            dialog.Show();

            if (dialog.Result.IsCancel)
            {
                Toast.Show("取消输入");
            }
            else
            {
                Toast.Show($"输入内容为：{dialog.Result.Data}");
            }

多行输入对话框 MultiLineDialog

            var dialog = provider.CreateInputDialog(s =>
            {
                // 标题文本
                s.Title = tbTitle.Text;
                // 消息文本
                s.Content = tbContent.Text;
                // 输入框默认文本
                s.DefaultText = "You can set the default text in the input box by using the 'DefaultText' property.";
                // 是否可取消
                s.Cancelable = true;
                // 是否允许输入为空
                s.AllowEmpty = false;
                // 输入文本最大长度
                s.MaximumLength = 200;
                // 输入文本最小长度
                s.MinimumLength = 6;
                // 是否多行
                s.IsMultiline = true;
                // 确认按钮文本
                s.ConfirmOption.Text = "Confirm(确定)";
                // 取消按钮文本
                s.CancelOption.Text = "Cancel(取消)";
                // 清空按钮文本
                s.ClearOption.Text = "Clear(清空)";
            });

            dialog.Show();

            if (dialog.Result.IsCancel)
            {
                Toast.Show("取消输入");
            }
            else
            {
                Toast.Show($"输入内容为：{dialog.Result.Data}");
            }

密码输入对话框PasswordDialog

            var dialog = provider.CreatePasswordDialog(s =>
            {
                s.Title = tbTitle.Text;
                s.Content = tbContent.Text + $"\r\n提示：密码至少要[6]位";
                s.PasswordChar = '●';
                s.PrecheckResult = password => password != null && password.Length >= 6;
            });

            dialog.Show();
            if (dialog.Result.IsCancel)
            {
                Toast.Show("取消输入");
            }
            else
            {
                Toast.Show($"输入密码为：{dialog.Result.Data}");
            }

提示对话框 PromptDialog

            var dialog = provider.CreatePromptDialog(s =>
            {
                // 标题文本
                s.Title = tbTitle.Text;
                // 消息文本
                s.Content = tbContent.Text;
                // 积极选项文本
                s.PositiveOption.Text = "Yes";
                // 消极选项文本
                s.NegativeOption.Text = "No";
            }, null);

            dialog.Show();

            if (dialog.Result.Data)
            {
                Toast.Show("结果：积极选项");
            }
            else
            {
                Toast.Show("结果：消极选项");
            }

单选对话框 SelectionDialog

            var dialog = provider.CreateSelectionDialog(students, null, s =>
            {
                // 标题文本
                s.Title = tbTitle.Text;
                // 消息文本
                s.Content = tbContent.Text;
                // 设置预检查回调
                s.PrecheckResult = item =>
                    {
                        var b = item != null;
                        if (!b)
                        {
                            Toast.Show("至少要选一项哦！", 2000, null, ToastMode.Reuse);
                        }
                        return b;
                    };
                s.ItemDisplayTextConvertCallback = stu => $"{stu.Name} ({stu.Description})";
            });

            dialog.Show();
            if (dialog.Result.IsCancel)
            {
                Toast.Show("取消选择");
            }
            else
            {
                Toast.Show($"结果：{dialog.Result.Data.Name} , {dialog.Result.Data.Description}");
            }

示例类型及数据：

        class Student
        {
            public Student(string name, string description)
            {
                Name = name;
                Description = description;
            }
            public string Name { get; set; }
            public string Description { get; set; }
        }

            Student[] students = new Student[] {
                new Student("张三","一年级"),
                new Student("李四","三年级"),
                new Student("王二","五年级"),
                new Student("马六","五年级"),
            };

多选对话框 MultipleSelectionDialog

            var dialog = provider.CreateMultipleSelectionDialog(students, null, s =>
            {
                // 标题文本
                s.Title = tbTitle.Text;
                // 消息文本
                s.Content = tbContent.Text;
                // 设置预检查回调
                s.PrecheckResult = item =>
                {
                    var b = item.Any();
                    if (!b)
                    {
                        Toast.Show("至少要选一项哦！", 2000, null, ToastMode.Reuse);
                    }
                    return b;
                };
                s.ItemDisplayTextConvertCallback = stu => $"{stu.Name} ({stu.Description})";
            });


            dialog.Show();
            if (dialog.Result.IsCancel)
            {
                Toast.Show("取消选择");
            }
            else
            {
                Toast.Show($"结果：{string.Join("|", dialog.Result.Data.Select(s => $"{s.Name}({s.Description})"))}");
            }

示例数据与单选对话框 SelectionDialog示例数据一致。

---

UI库安装与使用

请参考文章：《ApeForms | WinForm窗体UI美化库（Metro扁平风格）演示与安装》

---

获取示例源码

ApeForms UI库源码地址：https://github.com/ApeFree/ApeFree.ApeForms
ApeForms Demo源码地址：https://github.com/ApeFree/ApeFree.ApeForms.Demo
下载体验Demo.exe网盘链接：https://landriesnidis.lanzouy.com/b011mr7rg 密码:26fx
加入ApeForms QQ群答疑解惑：929371169