【PB案例学习笔记】-01创建应用、窗口与控件

写在前面

这是PB案例学习笔记系列文章的第一篇，也是最基础的一篇。后续文章中【创建程序基本框架】部分操作都跟这篇文章一样，

将不再重复。该系列文章是针对具有一定PB基础的读者，通过一个个由浅入深的编程实战案例学习，提高编程技巧，以保证

小伙伴们能应付公司的各种开发需求。

文章中设计到的源码，小凡都上传到了gitee代码仓库https://gitee.com/xiezhr/pb-project-example.git

需要源代码的小伙伴们可以自行下载查看，后续文章涉及到的案例代码也都会提交到这个仓库【pb-project-example】

如果对小伙伴有所帮助，希望能给一个小星星支持一下小凡。

一、小目标

掌握pb应用程序的创建、运行、中止等最基本操作。学会使用Static Text控件、CommandButton控件和MessageBox函数

上面说的控件和函数都是实际开发中最常用的

二、控件及函数简介

2.1 Static Text 控件

用于显示静态文本内容（通常用于显示标题、标签、说明文字等静态信息）
用户无法对其进行编辑或交互操作
在界面设计中起到了信息展示和界面美化的作用

① 常用属性

属性	描述
`Name`	控件唯一标识，用于获取控件
`Text`	控件显示的文本内容。可以通过该属性设置控件上显示的文字
`Tag`	可以将控件的Tag属性设置为一个唯一的标识符，以便在程序中识别和操作特定的控件
`Visible`	控制按钮是否可见,勾选可见，值为true ,不勾选不可见，值为false
`Enabled`	控制按钮是否可用,勾选可见，值为true ,不勾选不可见，值为false
`Border`	是否有边框
`BorderStyle`	边框样式
`Alignment`	文本对齐方式
`BorderColor`	边框颜色
`FillPattern`	填充样式
`FaceName`	字体样式设置
`TextSize`	字体大小设置
`Bold`	是否加粗
`Italic`	是否斜体
`Underline`	是否下划线
`TextColor`	文本颜色设置
`BackColor`	控件背景色设置
`X和Y`	控件x,y坐标
`Width`	控件宽度
`Height`	控件高度

2.2 CommandButton控件

用于触发特定操作或事件的按钮
用于添加交互性，提供用户操作界面的按钮

① 常用属性

按钮有 24 个属性

属性	描述
`name` 例如：cb_1	按钮唯一标识
`Text`	按钮上显示的文本内容。可以通过该属性设置按钮上显示的文字
`Tag`	可以将控件的Tag属性设置为一个唯一的标识符，以便在程序中识别和操作特定的控件
`Visible`	控制按钮是否可见,勾选可见，值为true ,不勾选不可见，值为false
`Enabled`	控制按钮是否可用,勾选可见，值为true ,不勾选不可见，值为false
`Default`	表示按钮是默认按钮，当用户没有选择控件，按Enter键时，触发该按钮得Cliced事件
`Cancel`	Cancel 取值为 True 时，表示当用户单击 Esc 键时，可以触发按钮的 Clicked 事件
`FaceName`	设置按钮上显示文本字体
`TextSize`	设置按钮上显示文本字体大小
`Bold`	设置按钮上显示文本是否加粗
`Italic`	设置按钮上显示文本是否斜体
`Underline`	设置按钮上显示文本是否下划线
`X`	按钮横坐标
`Y`	按钮纵坐标
`Width`	按钮宽度
`Height`	按钮高度

② 事件和脚本

事件	触发时机
`Clicked`	控件单击时
`Constructor`	在窗口的打开事件之前立即触发
`Destructor`	在窗口的打开事件之后立即触发
`DragDrop`	当被拖放对象释放时触发
`DragEnter`	被拖放对象的中心通过边缘进入时触发
`DragLeave`	被拖放对象的中心离开时触发
`DragWithin`	被拖放对象的中心位于其内时触发
`GetFocus`	在接受焦点之前（在选中并激活之前）触发
`LoseFocus`	当失去焦点时触发
`Other`	当非 PowerBuilder 事件消息发生时触发
`RButtonDown`	鼠标右键按下时触发

2.3 MessageBox

函数可以打开一个小信息窗口 ,不仅可以以多种方式给用户显示提示信息，还可以将用户的选择信息返回

①语法

小信息窗口有标题、提示信息、图标、按钮等 4 个元素

MessageBox ( title, text {, icon {, button {, default } } } )

title : 必选参数，提示框标题
text: 必选参数，提示框内容
icon: 可选参数，提示框图标
button: 提示框按钮

② icon 参数的可用值和对应的图标样式

③button 的可用取值和返回值的意义

参数取值	显示样式	返回值意义
`OK!`	显示【确定】按钮，该取值为默认值	总返回 1
`OKCancel!`	显示【确定】和【取消】按钮	1-【确定】， 2-【取消】
`YesNo!`	显示【是】和【否】按钮	1-【是】， 2-【否】
`YesNoCancel!`	显示【是】、【否】和【取消】三个按钮	1-【是】， 2-【否】， 3-【取消】
`RetryCancel!`	显示【重试】和【取消】按钮	1-【重试】， 2-【取消】
`AbortRetryIgnore!`	显示【放弃】、【重试】和【忽略】三个按钮	1-【放弃】， 2-【重试】， 3-【忽略】

三、创建程序基本框架

① 建立工作区

单击工具栏上的File→New命令，在弹出的New对话框中选择Workspace选项框中的Workspace图标，如下图所示，单击OK按钮，

在弹出的New Workspace对话框中输入“examplework”，点击保存按钮，建立一个新的工作区

②建立应用

单击菜单栏上的File→New命令，在弹出的对话框中选择Target选项卡，在选项卡中选择Application图标，并单击OK按钮，

在弹出的Specitfy New Application and Library 对话框的Application Name 文本框中输入“ExampleApp”,单击Finish按钮，

建立一个新的应用

③ 建立窗口

单击菜单栏上的File→New命令，在弹出的对话框中选择PBObject选项卡，在选项卡中选择Window图标，并单击OK按钮，

建立一个新的窗口

④ 建立控件

单击菜单栏上的Insert→Control命令，选择StaticText控件，单击加到窗口中，同样的方法，建立2个CommandButton

控件，并调整位置

各个控件名称依次为st_1,cb_1,cb_2

⑤保存窗口

单击工具栏中的File→Save 命令或者快捷键【Ctrl+S】,将建立的窗口保存为w_main

四、设置各个控件的外观属性

①StaticText 控件外观属性设置

在w_main 窗口中st_1控件上单击
General选项卡，将st_1的Text属性改为：“学生管理系统”
Font 选项卡，在FaceName中选择宋体，TextSize复选框中选择18，勾选Bold复选框设置字体

②CommandButton控件属性设置

在w_main 窗口中cb_1控件上单击
General选项卡，将cb_1的Text属性改为“学生档案管理”
同上，将cb_2的Text属性改为“学生选课管理”

五、编写按钮点击事件代码

①双击cb_1 控件，进入cb_1 按钮的Clicked 事件，添加如下代码

messagebox('欢迎使用',"学生档案管理")

②双击cb_1 控件，进入cb_2 按钮的Clicked` 事件，添加如下代码

messagebox('欢迎使用',"学生选课管理")

③双击应用对象，在exampleapp的open中添加如下代码

open(w_main)

六、运行程序

单击菜单栏上运行按钮或者按快捷键【Ctrl+R】运行程序

本期内容到此就结束了，希望对您有所帮助。我们下期再见，ヾ(•ω•`)o (●'◡'●)