· 4 getlatestversion 方法获得源代码管理器中项目的一个文件的最新版本...

1

返回总目录G e t L a t e s t V e r s i o n 方法

G E T N E X T M O D I F I E D 函数

G E T O B J E C T 函数

G E T P A D 函数

G E T P E M 函数

G E T P I C T 函数

G E T P R I N T E R 函数

G O 或 G O T O 命令

G o B a c k 方法

G o F o r w a r d 方法

G O M O N T H 函数

G o t F o c u s 事件

G r i d 控件

G r i d H i t T e s t 方法

G r i d L i n e C o l o r 属性

G r i d L i n e s 属性

G r i d L i n e W i d t h 属性

H a l f H e i g h t C a p t i o n 属性

2

H e a d e r 对象

H E A D E R 函数

H e a d e r H e i g h t 属性

H e i g h t 属性

H E L P 命令

H e l p 方法

H e l p C o n t e x t I D 属性

H I D E M E N U 命令

H i d e 方法

H I D E P O P U P 命令

H I D E W I N D O W 命令

H i d e D o c 事件

H i d e S e l e c t i o n 属性

H i g h l i g h t 属性

H i g h l i g h t R o w 属性

H O M E 函数

H o m e D i r 属性

H o s t N a m e 属性

H O U R 函数

H o u r s 属性

H S c r o l l S m a l l C h a n g e 属性

H y p e r l i n k 对象

3

I c o n 属性

I D X C O L L A T E 函数

I F . . . E N D I F 命令

I I F 函数

Im a g e 控件

I M E M o d e 属性

I M E S T A T U S 函数

I M P O R T 命令

_ I N C L U D E 系统变量

I n c r e m e n t 属性

I n c r e m e n t a l S e a r c h 属性

I N D B C 函数

_ I N D E N T 系统变量

I N D E X 命令

4

G e t L a t e s t V e r s i o n 方法

获得源代码管理器中项目的一个文件的最新版本并将一个只读版本复制到您本地的

驱动器上

语法

O b j e c t.G e t L a t e s t V e r s i o n说明

G e t L a t e s t V e r s i o n 方法不签出该文件

如果源代码管理器成功地获得了该文件则返回真 ( .T . ) 如果源代码管理器不能

获得该文件或者该项目不在源代码管理器中则返回假 ( .F .)

应用于

文件对象

请参阅

A d d T o S C C 方法 , C h e c k I n 方法 , C h e c k O u t 方法 , R e m o v e F r o m S C C 方法 ,U n d o C h e c k O u t 方法

5

G E T N E X T M O D I F I E D 函数

返回一个记录号对应缓冲表或临时表中下一个被修改的记录

语法

G E T N E X T M O D I F I E D (n R e c o r d N u m b e r [ , c T a b l e A l i a s | n W o r k A r e a ] )返值类型

数值型

参数描述

n R e c o r d N u m b e r指定的记录编号 G E T N E X T M O D I F I E D 函数在此记录后搜索下一个被修

改的记录 n R e c o r d N u m b e r 可以指定为 0 从而确定表或临时表中第一个被修

改的记录

c T a b l e A l i a s指定表或临时表的别名 G E T N E X T M O D I F I E D 函数返回该表中下一个

被修改记录的记录号

n W o r k A r e a指定表或临时表所在的工作区 G E T N E X T M O D I F I E D 函数返回该工作

区中下一个被修改记录的记录号

6

如果没有指定别名或工作区 G E T N E X T M O D I F I E D 函数将返回当前选定表或临时

表中下一个被修改记录的记录号

说明

如果在所指定的记录后没有被修改的记录 G E T N E X T M O D I F I E D 函数返回 0 只

要更改了记录中任一字段的内容即使还原为字段的原始内容或记录的删除状态

就认为该记录已被修改

G E T N E X T M O D I F I E D 函数只能对启用表缓冲的表和临时表进行操作可以利用

C U R S O R S E T P R O P 函数启用表缓冲

示例

下面的示例演示了如何利用 G E T N E X T M O D I F I E D 函数判定表中哪一个记录已作

了更改为满足表缓冲的要求将 M U L T I L O C K S 设置为 O N 打开 t e s tda te 数据库中

的 c u s t o m e r 表并调用 C U R S O R S E T P R O P 函数将缓冲方式设置为开放式表缓

冲 ( 5 )

发出 S K I P 命令把记录指针移动到第二个记录上并用 R E P L A C E 命令修改 cu s t_ id

字段从表的起始处开始使用 G E T N E X T M O D I F I E D ( 0 ) 显示从表中下一个被修改记

录的记录号 2 第二个记录然后调用 T A B L E R E V E R T 函数使表返回到原始

状态并且再次使用 G E T N E X T M O D I F I E D ( 0 ) 被显示下一个修改的记录号 0 表示

没有修改过记录C L O S E D A T A B A S E SC L E A R

O P E N D A T A B A S E S Y S ( H O M E ( 2 ) + ' d a t a \ t e s t d a t a ' )S E T M U L T I L O C K S O N & & 必须为 ON 以请求表缓冲U S E C u s t o m e r & & 打开 customer 表

7

= C U R S O R S E T P R O P ( " B u f f e r i n g " , 5 , " c u s t o m e r " ) & & 启用表缓冲

S K I P & & 把记录指针移到第二个记录上

* 更改字段内容R E P L A C E c u s t _ i d W I T H " * * * "

* C a l l M E S S A G E B O X f u n c t i o n w i t h r e s u l t s o f G E T N E X T M O D I F I E D= M E S S A G E B O X ( " R e c o r d " + A L L T R I M ( S T R ( (0) ) ) + ;

" h a s c h a n g e d . " , 0 , " R e s u l t s " )

* R e v e r t t a b l e a n d d i s p l a y r e s u l t s w i t h M E S S A G E B O X= T A B L E R E V E R T ( . T . ) & & 放弃对表的所有修改n C h a n g e = ( 0 )I F n C h a n g e = 0

= M E S S A G E B O X ( " R e c o r d ( s ) h a v e b e e n r e v e r t e d . " , 0 , " R e s u l t s " )E L S E

= M E S S A G E B O X ( " R e c o r d " + A L L T R I M ( S T R ( (0) ) ) + ;" h a s c h a n g e d . " , 0 , " R e s u l t s " )

E N D I F请参阅

C U R S O R S E T P R O P , C U R V A L , G E T F L D S T A T E , O L D V A L

8

G E T O B J E C T 函数

激活 O L E 自动化对象并创建此对象的引用

语法

G E T O B J E C T (F i l e N a m e [ , C l a s s N a m e ] )返值类型

O b j e c t

参数描述

F i l e N a m e指明所要激活文件的完整路径与文件名并不需要指定应用程序因为 O L E动态链接库将根据提供的文件名确定要启动的应用程序

例如下面的代码将启动 M ic roso f t Exce l 打开名为 B U D G E T . X L S 的文件并通过名

为 M B U D V A R 的对象变量创建引用

M B U D V A R = G E T O B J E C T ( ' C : \ E X C E L \ W O R K \ B U D G E T . X L S ' )

C l a s s N a m e指定所要检索对象的类名有的应用程序可以在同一文件中存储一个以上的

对象类型并允许使用类名指定要激活的对象例如如果某个文字处理应

用程序在同一文件中存储了文档宏定义与工具栏对象则可用下列命令创

9

建对文档文件的引用

M D O C F I L E = G E T O B J E C T ( ' C : \ W R D P R O C \ M Y D O C . D O C ' , ' W r d P r o c . D o c u m e n t ' )

' W r d P r o c . D o c u m e n t ' )

对于某些服务程序每次调用 G E T O B J E C T 函数都将启动该应用程序的一个额

外实例并占用额外内存如果该应用程序已经运行可以仿照下面的示例忽略

F i l e N a m e 而包含 C l a s s N a m e 从而避免启动该应用程序的额外实例

o l e A p p = G E T O B J E C T ( , " E x c e l . A p p l i c a t i o n " )

说明

用 G E T O B J E C T 函数从文件中激活某个 O L E 自动化对象并通过变量或数组元

素指定对该对象的引用

如果指定了一个无效的文件或类名称会显示 O L E 错误并且 G E T O B J E C T 函

数返回一个空字符串

请参阅

C O M C L A S S I N F O , C R E A T E O B J E C T , D E F I N E C L A S S , S E TO L E O B J E C T

1 0

G E T P A D 函数

返回菜单栏上给定位置的菜单标题

语法

G E T P A D (c M e n u B a r N a m e , n M e n u B a r P o s i t i o n )返值类型

C h a r a c t e r

参数描述

c M e n u B a r N a m e指定菜单栏名称

n M e n u B a r P o s i t i o n指定菜单栏上的某一位置 n M e n u P o s i t i o n 的取值范围从 1 开始对应菜单栏

上最左面的菜单标题直到菜单中菜单标题的总数

说明

可以添加删除或重新调整标题栏上的菜单名使用 D E F I N E P A D 命令可以向标题栏

中添加主菜单名使用 R E L E A S E P A D 命令可以删除菜单标题

示例

下面的示例用 G E T P A D 来测试编辑菜单名称是否在 Visual F o x P r o 系统菜单

栏上如果在 G E T P A D 返回菜单名称为了将编辑菜单栏还原到默认状

1 1

态用 SET SYSMENU TO D E F A U L T 命令F O R g n C o u n t = 1 T O C N T P A D ( ' _ m s y s m e n u ' ) & & p a d 的数量

I F P R M P A D ( ' _ m s y s m e n u ' , ' _ m s y s m e n u ' , g n C o u n t ) = 'Ed i t 'R E L E A S E P A D ( ' _ m s y s m e n u ' , g n C o u n t ) O F _ m s y s m e n uEXIT

E N D I FE N D F O R

请参阅

D E F I N E M E N U , D E F I N E P A D , R E L E A S E P A D

G E T P E M 函数

返回事件或方法的属性值或程序代码

语法

G E T P E M (o O b j e c t N a m e | c C l a s s N a m e , c P r o p e r t y | c E v e n t | c M e t h o d )返值类型

字符型货币型日期型日期时间型数值型或逻辑型

参数描述

1 2

o O b j e c t N a m e指定对象函数将返回它的属性值或其事件方法的程序代码

o O b j e c t N a m e 可以是求值结果为对象的任意表达式例如对象引用对象变

量或对象数组元素

c C l a s s N a m e指定类函数将返回其属性值或其事件方法的程序代码

c P r o p e r t y指定要返回其值的属性

c E v e n t指定要返回其值的属性

c M e t h o d指定要返回其值的属性

说明

只有交互式的 Visual F o x P r o s e s s i o n 才支持 G E T P E M 函数

请参阅

C R E A T E F O R M , P E M S T A T U S , S Y S ( 1 2 6 9 ) , S Y S ( 1 2 7 0 ) , S Y S ( 1 2 7 1 ) ,

S Y S ( 1 2 7 2 )

1 3

G E T P I C T 函数

显示打开对话框并返回选定图片文件的名称

语法

G E T P I C T ( [ c F i l e E x t e n s i o n s ] [ , c F i l e N a m e C a p t i o n ] [ , c O p e n B u t t o n C a p t i o n ] )返值类型

数值型

参数描述

c F i l e E x t e n s i o n s没有选择所有文件菜单项时在可滚动列表中指定显示图片文件的文件

扩展名

c F i l e E x t e n s i o n s 可以为下列形式

• 如果 c F i l e E x t e n s i o n s 只包含单一扩展名例如 .B M P 则只显示有这个

扩展名的文件

• c F i l e E x t e n s i o n s 也可以包含通配符 * 和 ? 此时将显示扩展名与通配符

条件相匹配的所有文件例如如果 c F i l e E x t e n s i o n 为 ? X ? 则显示扩展

名为 . F X P .E X E 和 . T X T 的所有文件

1 4

• 如果 c F i l e E x t e n s i o n s 中包含空字符串 ( ' ') 则显示扩展名为 . B M P 和 . D I B的文件

c F i l e N a m e C a p t i o n指定在文件名文本框上方显示的标题 c F i l e N a m e C a p t i o n 将替换文件

名省略 c F i l e N a m e C a p t i o n 时将显示文件名

c O p e n B u t t o n C a p t i o n为确定按钮指定标题

说明

如果按 E S C 键选择取消按钮或单击关闭按钮而退出打开对话框

G E T P I C T 函数将返回空字符串

请参阅

G E T F I L E , G E T E X P R , L O C F I L E , P U T F I L E

G E T P R I N T E R 函数

显示 W i n d o w s 的打印设置对话框并返回所选择的打印机名称

语法

G E T P R I N T E R返值类型

1 5

字符型

说明

如果按 E S C 键选择取消按钮或从控制菜单上选择关闭而退出打印设

置对话框 G E T P R I N T E R 函数将返回空字符串

示例

C L E A RcPr in te r = & & 显示 Windows 的打印设置对话框* * * 显示所选定的打印机的名字 * * *W A I T W I N D O W I I F ( E M P T Y ( c P r i n t e r ) , '打印机未选择 ' , cP r in te r )

请参阅

A P R I N T E R S , S E T P R I N T E R

G O 或 G O T O 命令

将记录指针移动到指定位置

语法

G O [ R E C O R D ] n R e c o r d N u m b e r [ I N n W o r k A r e a | I N c T a b l e A l i a s ]–或者 –

1 6

G O T O P | B O T T O M [ I N n W o r k A r e a | I N c T a b l e A l i a s ]–或者 –

G O T O [ R E C O R D ] n R e c o r d N u m b e r [ I N n W o r k A r e a | I N c T a b l e A l i a s ]–或者 –

G O T O T O P | B O T T O M [ I N n W o r k A r e a | I N c T a b l e A l i a s ]参数描述

R E C O R D n R e c o r d N u m b e r指定一个物理记录号记录指针将移至该记录您可以省略 G O 或 G O T O 命令而只指定记录号但如果仅指定记录号则只能在当前工作区中移动记录

指针

I N n W o r k A r e a指定表所在的工作区记录指针在此表中移动

I N c T a b l e A l i a s指定表的别名记录指针在此表中移动

T O P将记录指针定位在表的第一个记录上如果此表使用升序索引则第一个记

录是关键字值最小的记录如果使用降序索引则第一个记录是关键字值最

大的记录

B O T T O M将记录指针定位在表的最后一个记录上如果此表使用升序索引则最后一

个记录是关键字值最大的记录如果使用降序索引则最后一个记录是关键

字值最小的记录

1 7

说明

可以互换使用 G O 和 G O T O 命令除非在 I N 子句中指定了另一个工作区否则这两

个命令都对当前工作区中的表进行操作

示例

C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' d a t a \ t e s t d a t a ' )U S E p r o d u c t s & & 打开 P r o d u c t s 表U S E c u s t o m e r I N 0 & &打开 C u s t o m e r 表

p roduc t sC L E A R? R E C N O ( ' p r o d u c t s ' )

? R E C N O & & 显示数值 1 5

? R E C N O & & 显示数值 5

请参阅

R E C N O , S E L E C T , S K I P

1 8

G o B a c k 方法

在一个 A c t i v e D o c u m e n t 容器的历史列表中向后定位

语法

H y p e r L i n k .G o B a c k说明

只在包含在容器中的 A c t i v e D o c u m e n t 中支持 G o B a c k 方法

当 A c t i v e D o c u m e n t 在容器之外运行时会忽略 G o B a c k 方法例如当 A c t i v e

D o c u m e n t 在 Visual F o x P r o 运行期间或交互式的 Visual F o x P r o 工作期中运行时会被

忽略

应用于

超链接对象

请参阅

G o F o r w a r d 方法 , N a v i g a t e T o 方法

1 9

G o F o r w a r d 方法

在一个 A c t i v e D o c u m e n t 容器的历史列表中向前定位

语法

H y p e r L i n k .G o F o r w a r d说明

只在包含在容器中的 A c t i v e D o c u m e n t 中支持 G o F o r w a r d 方法

当 A c t i v e D o c u m e n t 在容器之外运行时会忽略 G o F o r w a r d 方法例如当 A c t i v e

D o c u m e n t 在运行时刻 Visual F o x P r o 中或一个交互的 Visual F o x P r o 工作期中运行时

就会忽略 G o F o r w a r d 方法

应用于

超链接对象

请参阅

G o B a c k 方法 , N a v i g a t e T o 方法

2 0

G O M O N T H 函数

对于给定的日期表达式返回指定数目的月份以前或以后的日期

语法

G O M O N T H ( d E x p r e s s i o n | t E x p r e s s i o n , n N u m b e r O f M o n t h s )返值类型

日期型

参数描述

d E x p r e s s i o n指定的日期表达式相对于此日期 G O M O N T H 函数返回日期

t E x p r e s s i o n指定的日期时间表达式相对于此日期时间 G O M O N T H 函数返回日

期

n N u m b e r O f M o n t h s指定从给定日期或日期时间开始的月数如果 n N u m b e r O f M o n t h s 为正

G O M O N T H 函数返回给定日期或日期时间 n N u m b e r O f M o n t h s 个月以后

的日期如果 n N u m b e r O f M o n t h s 为负 G O M O N T H 函数返回给定日期

或日期时间 n N u m b e r O f M o n t h s 个月以前的日期

示例

2 1

S E T C E N T U R Y O NS T O R E G O M O N T H ( { ^ 1 9 9 8 - 0 2 - 1 6 } , 5 ) T O g d D e a d L i n e

C L E A R? g d D e a d L i n e & & 显示数值 0 7 / 1 6 / 1 9 9 8? { ^ 1 9 9 8 - 1 2 - 3 1 } , 2 & & 显示数值 0 2 / 2 8 / 1 9 9 9? { ^1998 -12 -31 } , - 2 & & 显示数值 1 0 / 3 1 / 1 9 9 8

请参阅

C M O N T H

G o t F o c u s 事件

当通过用户操作或执行程序代码使对象接收到焦点时此事件发生

语法

P R O C E D U R E O b jec t .G o t F o c u s[ L P A R A M E T E R S n I n d e x ]参数描述

n I n d e x用以唯一标识控件数组中的某个控件

2 2

说明

对象接收到焦点时 G o t F o c u s 事件用来指定要发生的动作例如通过为表单中的每

个控件附加 G o t F o c u s 事件可以显示简单说明或状态栏信息以指导用户也可以通过

激活废止或显示依赖于拥有焦点控制的其他控件提供可视化的提示可根据用户

的操作例如单击鼠标或在程序代码中调用 S e t F o c u s 方法使控件接收焦点当表单

没有控件或者它的所有控件已废止或不可见时此表单才能接收焦点

注意只有当对象的 E n a b l e d 属性和 V i s ib l e 属性均设置为真 .T . 时

此对象才能接收焦点要为焦点的移动定制键盘操作方式可以为表

单上的控件设置 T A B 键次序或指定快捷键在控件所在的容器

A c t i v a t e 事件后发生 G o t F o c u s 事件

应用于

复选框组合框命令按钮容器对象控件对象编辑框表单列表框 O L E 绑定

型控件 O L E 容器控件选项按钮微调文本框

请参阅

A c t i v a t e 事件 , A c t i v e C o n t r o l 属性 , C l i c k 事件 , D e a c t i v a t e 事件 , E n a b l e d 属性 ,

L o s t F o c u s 事件 , S e t F o c u s 方法 , T a b I n d e x 属性 , T a b S t o p 属性 , V is ib l e 属性

2 3

G r i d 控件

创建表格

语法

G r i d说明

表格是按行和列显示数据的容器对象其外观与浏览窗口相似表格是包含列对象的

容器对象列可以包含标头对象及控件由于表格及其列标头和控件都有各自的属

性集您可以完全控制表格中的每一个元素可以使用表格生成器交互地创建表格

有关创建表格的详细内容请参阅 M i c r o s o f t V i s u a l F o x P r o 6 . 0 中文版程序员指南

的第十章使用控件

属性

A c t i v e C o l u m n A c t i v e R o w A l l o w A d d N e wA l l o w H e a d e r S i z i n g A l l o w R o w S i z i n g A p p l i c a t i o nB a c k C o l o r B a s e C l a s s C h i l d O r d e r

2 4

C l a s s C l a s s L i b r a r y C o l u m n C o u n tC o l u m n s C o m m e n t D e l e t e M a r kD r a g I c o n D r a g M o d e E n a b l e dF o n t B o l d F o n t C o n d e n s e F o n t E x t e n dF o n t I t a l i c F o n t N a m e F o n t O u t l i n eF o n t S h a d o w F o n t S i z e F o n t S t r i k e T h r uF o n t U n d e r l i n e F o r e C o l o r G r i d L i n e C o l o rG r i d L i n e s G r i d L i n e W i d t h H e a d e r H e i g h tH e i g h t H e l p C o n t e x t I D H i g h L i g h tH i g h L i g h t R o w L e f t L e f t C o l u m nL i n k M a s t e r M o u s e I c o n M o u s e P o i n t e rN a m e O L E D r a g M o d e O L E D r a g P i c t u r e

O L E D r o p E f f e c t s O L E D r o p H a s D a t aP r o p e r t y

O L E D r o p M o d e

P a n e l P a n e l L i n k P a r e n tP a r e n t C l a s s P a r t i t i o n R e a d O n l yR e c o r d M a r k R e c o r d S o u r c e R e c o r d S o u r c e T y p eR e l a t i o n a l E x p r R e l a t i v e C o l u m n R e l a t i v e R o wR i g h t T o L e f t R o w H e i g h t S c r o l l B a r sS p l i t B a r S t a t u s B a r T e x t T a b I n d e xT a b S t o p T a g T o o l T i p T e x tT o p V a l u e V iew

2 5

V is ib le W h a t s T h i s H e l p I D W idth

事件

A f t e r R o w C o l C h a ng e

B e f o r e R o w C o l C h a n g e C l i c k

D b l C l i c k D e l e t e d D e s t r o yD r a g D r o p D r a g O v e r E r r o rIn i t M i d d l e C l i c k E v e n t M o u s e D o w nM o u s e M o v e M o u s e U p M o u s e W h e e lO L E C o m p l e t e D r a g O L E D r a g D r o p O L E D r a g O v e rO L E G i v e F e e d B a c k O L E S e t D a t a O L E S t a r t D r a gR e s i z e R i g h t C l i c k M o v e dS c r o l l e d U I E n a b l e V a l i dW h e n

方法

A c t i v a t e C e l l A d d C o l u m n A d d O b j e c tA d d P r o p e r t y C l o n e O b j e c t D e l e t e C o l u m nD o S c r o l l D r a g G r i d H i t T e s tM o v e O L E D r a g R e a d E x p r e s s i o nR e a d M e t h o d R e f r e s h R e m o v e O b j e c tR e s e t T o D e f a u l t S a v e A s C l a s s S e t A l l

2 6

S e t F o c u s W r i t e E x p r e s s i o n W r i t e M e t h o dZ O r d e r

示例

下列示例将一个表格控件放在表单上打开表并在表格中显示表中的

内容使用了 C a p t i o n 属性为 C U S T _ I D 字段指定不同的标头标题 ( C u s t o m e r I D ) 将一

个命令按钮放在表单上以关闭该表单

使用了 S e t A l l 方法以及 D y n a m i c B a c k C o l o r 属性以指定记录的背景颜色在表格

中如果一个记录的编号是偶数则该记录的 D y n a m i c B a c k C o l o r 属性为白色否则

D y n a m i c B a c k C o l o r 为绿色C L O S E A L L & & 关闭表和数据库O P E N D A T A B A S E ( H O M E ( 2 ) + ' d a t a \ t e s t d a t a ' )

U S E c u s t o m e r I N 0 & &打开 C u s t o m e r 表

f r m M y F o r m = C R E A T E O B J E C T ( ' F o r m ' ) & & 创建一个表单f r m M y F o r m . C l o s a b l e = . F . & & 禁止窗口弹出菜单

f r m M y F o r m . A d d O b j e c t ( ' c m d C o m m a n d 1 ' , ' c m d M y C m d B t n ' ) & &增加命令按钮f r m M y F o r m . A d d O b j e c t ( ' g r d G r i d 1 ' , ' ' ) & & 增加表格控件

f r m M y F o r m . g r d G r i d 1 . L e f t = 2 5 & & 调整表格位置

f r m M y F o r m . g r d G r i d 1 . S e t A l l ( " D y n a m i c B a c k C o l o r " , ;" I I F ( M O D ( R E C N O , 2 ) = 0 , R G B ( 2 5 5 , 2 5 5 , 2 5 5 ) ;, R G B ( 0 , 2 5 5 , 0 ) ) " , " C o l u m n " ) & & 将白与绿记录交换

f r m M y F o r m . g r d G r i d 1 . V i s i b l e = . T . & & 显示表格控件f r m M y F o r m . c m d C o m m a n d 1 . V i s i b l e = . T . & &显示 "Qu i t " 命令按钮f r m M y F o r m . g r d G r i d 1 . C o l u m n 1 . H e a d e r 1 . C a p t i o n = ' C u s t o m e r I D '

2 7

f r m M y F o r m . S H O W & & D i s p l a y t h e f o r mR E A D E V E N T & & S t a r t e v e n t p r o c e s s i n g

D E F I N E C L A S S c m d M y C m d B t n A S C o m m a n d B u t t o n & &创建命令按钮C a p t i o n = ' \ < Q u i t ' & & 给命令按钮加标题C a n c e l = . T . & &默认取消命令按钮 ( E s c 键 )L e f t = 1 2 5 & & 命令按钮列T o p = 2 1 0 & & 命令按钮行H e i g h t = 2 5 & & 命令按钮高

P R O C E D U R E C l i c kC L E A R E V E N T & &终止事件程序关闭表单C L O S E A L L & & 关闭表和数据库

E N D D E F I N E

请参阅

C o l u m n 对象 , C R E A T E C L A S S , C R E A T E F O R M , D E F I N E C L A S S , H e a d e r 对象

G r i d H i t T e s t 方法

作为输出参数返回一个表格控件在指定水平 ( X ) 和垂直 ( Y ) 坐标的组成部分

2 8

语法

G r i d .G r i d H i t T e s t ( n X C o o r d _ I n , n Y C o o r d _ I n[ , n W h e r e _ O u t [ , n R e l R o w _ O u t [ , n R e l C o l _ O u t [ , n V i e w _ O u t ] ] ] ] )

参数描述

n X C o o r d _ In指定包含表格的表单中的水平 ( X ) 位置

n Y C o o r d _ In指定包含表格的表单中的垂直 (Y ) 位置

n W h e r e _ O u t一个输出参数包含一个值该值对应于 n X C o o r d _ In 和 n Y C o o r d _ I n 位置

的表格成分下表列出了 @ n W h e r e _ O u t 的值以及相应的表格成分

@ n W h e r e _O u t

表格成分

0 一个不能确定的表格成分

1 列标头

2 列标头之间

3 单元格

4 保留

5 分隔栏

6 记录删除标记

7 保留

8 保留

2 9

9 保留

1 0 保留

1 1 左上角的框

1 2 记录标记

1 3 列标头大小调整区

1 4 行大小调整区

1 5 保留

1 6 水平滚动栏

1 7 垂直滚动栏

n R e l R o w _ O u t一个输出参数包含指定点的相关表格行

n R e l C o l_ O u t一个输出参数包含指定点的相关表格列

n V i e w _ O u t一个输出参数包含一个值该值对应于包含指定点的表格窗格如果该表

格被分成两个窗格如果指定点位于左窗格则该值为 0 如果指定点位于

右窗格则该值为 1 如果该表格没有被分成独立的窗格则该参数为 1说明

如果指定点位于表格中则 G r i d H i t T e s t 方法返回真 ( .T . ) 否则返回假

( .F.)

3 0

可以在鼠标事件或 O L E 放落目标事件中使用 G r i d H i t T e s t 方法来判断鼠标指针

位于表格的什么位置 n R e l R o w _ O u t 和 n R e l C o l _ O u t 参数可以传递给

A c t i v a t e C e l l 方法以激活表格中指定的单元格

应用于

表格控件

请参阅

A c t i v a t e C e l l 方法 , A c t i v e C o l u m n 属性 , A c t i v e R o w 属性 , M C O L , M R O W

G r i d L i n e C o l o r 属性

指定在表格控件中分隔单元格的线的颜色设计时可用运行时可读写

语法

G r i d .G r i d L i n e C o l o r [ = n C o l o r ]G r i d .G r i d L i n e C o l o r = R G B (n R e d V a l u e , n G r e e n V a l u e , n B l u e V a l u e )参数描述

n C o l o r指定单个值该值代表颜色在默认情况下 G r i d L i n e C o l o r 设置为 0

黑

3 1

n R e d V a l u e , n G r e e n V a l u e , n B l u e V a l u e指定组成表格线颜色的三个独立的色度必须与 R G B 函数一起使用

将三个颜色成分合成一个值既 G r i d L i n e C o l o r 属性

注意

注意在属性窗口中您可以单击任何颜色属性以显示颜色对话

框您可以在这个对话框中选择或定义颜色当您关闭颜色对话框

之后对应于所选颜色的红绿和蓝色度就成为这些属性的设置

应用于

表格

请参阅

G r i d L i n e s 属性 , G r i d L i n e W i d t h 属性

G r i d L i n e s 属性

确定在表格控件中是否显示水平和垂直线设计时可用运行时可读写

语法

3 2

G r i d .G r i d L i n e s [ = n 设置 ]

参数描述

n 设置

G r i d L i n e s 属性的设置有

设置说明

0 无没有表格线 .

1 水平只显示水平表格线

2 垂直只显示垂直表格线

3 默认值都显示显示水平和垂直表格线

应用于

表格

请参阅

G r i d L i n e C o l o r 属性 , G r i d L i n e W i d t h 属性

G r i d L i n e W i d t h 属性

指定表格控件中分隔单元格的线的宽度以像素为单位设计时可用运行时可读

写

3 3

语法

G r i d .G r i d L i n e W i d t h [ = n W idth ]参数描述

n W idth指定表格控件中分隔单元格的线的宽度

应用于

表格

请参阅

G r i d L i n e C o l o r 属性 , G r i d L i n e s 属性

H a l f H e i g h t C a p t i o n 属性

指定表单标题高度是否为正常高度的一半设计和运行时可用

语法

O b jec t .H a l f H e i g h t C a p t i o n [ = l E x p r]参数描述

3 4

l E x p r下表列出了 H a l f H e i g h t C a p t i o n 属性的设置

设置说明

真 ( .T . ) 表单标题高度为正常高度的一半

假 ( .F.) 默认值表单标题高度为正常高度

应用于

表单 _ S C R E E N

请参阅

C a p t i o n 属性

H e a d e r 对象

为表格控件的列创建标头

语法

H e a d e r说明

表格中的列包含有标头标头在列的最上面显示列标题并且可以响应事件

有关创建表格的标头的详细内容请参阅 M i c r o s o f t V i s u a l F o x P r o 6 . 0 中文版程序员

3 5

指南的第十章使用控件

属性

A l i g n m e n t A p p l i c a t i o n B a c k C o l o rB a s e C l a s s C a p t i o n C l a s sC l a s s L i b r a r y C o m m e n t F o n t B o l dF o n t C o n d e n s e F o n t E x t e n d F o n t I t a l i cF o n t N a m e F o n t O u t l i n e F o n t S h a d o wF o n t S i z e F o n t S t r i k e T h r u F o n t U n d e r l i n eF o r e C o l o r N a m e P a r e n tP a r e n t C l a s s T a g

事件

C l i c k D b l C l i c k M i d d l e C l i c k E v e n tM o u s e D o w n M o u s e M o v e M o u s e U pM o u s e W h e e l R i g h t C l i c k

方法

A d d P r o p e r t y R e a d E x p r e s s i o n R e a d M e t h o dR e f r e s h R e s e t T o D e f a u l t S a v e A s C l a s sW r i t e E x p r e s s i o n W r i t e M e t h o d

示例

3 6

下列示例使用 H e a d e r 对象以及 C a p t i o n 属性更改表格中第一个标头的标题

将一个表格控件放在表单上打开表并在表格中显示表中的内容使

用了 C a p t i o n 属性为 C U S T _ I D 字段指定不同的标头标题 ( C u s t o m e r I D ) 将一个命令按

钮放在表单上以关闭该表单

使用了 S e t A l l 方法以及 D y n a m i c B a c k C o l o r 属性以指定记录的背景颜色在表格

中如果一个记录的编号是偶数则该记录的 D y n a m i c B a c k C o l o r 属性为白色否则

D y n a m i c B a c k C o l o r 为绿色C L O S E A L L & & 关闭表和数据库O P E N D A T A B A S E ( H O M E ( 2 ) + ' d a t a \ t e s t d a t a ' )

U S E c u s t o m e r I N 0 & &打开 C u s t o m e r 表

f r m M y F o r m = C R E A T E O B J E C T ( ' f o r m ' ) & & 创建一个表单f r m M y F o r m . C l o s a b l e = . f . & & 禁止 w i n d o w 弹出菜单

f r m M y F o r m . A d d O b j e c t ( ' c m d C o m m a n d 1 ' , ' c m d M y C m d B t n ' ) & & 增加命令按钮f r m M y F o r m . A d d O b j e c t ( ' g r d G r i d 1 ' , ' G r i d ' ) & & 增加表格控件

f r m M y F o r m . g r d G r i d 1 . L e f t = 2 5 & & 调整表格位置

f r m M y F o r m . g r d G r i d 1 . S e t A l l ( " D y n a m i c B a c k C o l o r " , ;" I I F ( M O D ( R E C N O , 2 ) = 0 , R G B ( 2 5 5 , 2 5 5 , 2 5 5 ) ;, R G B ( 0 , 2 5 5 , 0 ) ) " , " C o l u m n " ) & &将白和绿的记录调换

f r m M y F o r m . g r d G r i d 1 . V i s i b l e = . T . & & 显示表格控件f r m M y F o r m . c m d C o m m a n d 1 . V i s i b l e = . T . & &显示 "Qu i t " 命令按钮f r m M y F o r m . g r d G r i d 1 . C o l u m n 1 . . C a p t i o n = ' C u s t o m e r I D '

f r m M y F o r m . S H O W & &显示表单

3 7

R E A D E V E N T & & 启动事件程序

D E F I N E C L A S S c m d M y C m d B t n A S C o m m a n d B u t t o n & & 创建命令按钮C a p t i o n = ' \ < Q u i t ' & & 给命令按钮增加标题C a n c e l = . T . & & 默认取消命令按钮 ( E s c 键 )L e f t = 1 2 5 & & 命令按钮列T o p = 2 1 0 & & 命令按钮行H e i g h t = 2 5 & & 命令按钮高

P R O C E D U R E C l i c kC L E A R E V E N T & & 终止 2 事件程序关闭表单C L O S E A L L & & 关闭表和数据库

E N D D E F I N E

请参阅

C o l u m n 对象 , C R E A T E F O R M , C R E A T E C L A S S , D E F I N E C L A S S , G r i d 控件

H E A D E R 函数

返回表文件标题所占的字节数

语法

H E A D E R ( [ n W o r k A r e a | c T a b l e A l i a s ] )

3 8

返值类型

数值型

参数描述

n W o r k A r e a | c T a b l e A l i a s返回在非当前工作区中打开的表的表头大小参数 n W o r k A r e a 指定工作区

号 c T a b l e A l i a s 指定表别名如果省略工作区号和表别名则 H E A D E R函数将返回当前工作区中打开的表的表头大小

如果指定的工作区中没有打开的表则 H E A D E R 函数将返回 0 若指定的别名不

存在则 V i s u a l F o x P r o 将显示一条错误信息

说明

表头中包含了该表本身的一些信息其中包括该表的所有字段名字段大小以及该表

是否具有备注文件或结构索引文件等等

请参阅

F S I Z E , R E C S I Z E

H e a d e r H e i g h t 属性

指定表格控件中列标头的高度设计时可用运行时可读写

3 9

语法

H e a d e r .H e a d e r H e i g h t [ = n H e i g h t]参数描述

n H e i g h t标头的高度以像素为单位

应用于

表格

请参阅

S c a l e M o d e 属性

H e i g h t 属性

指定对象在屏幕上的高度设计和运行时可用

语法

O b j e c t.H e i g h t [ = n H e i g h t ]参数描述

4 0

n H e i g h t指定对象的高度其单位由表单的 S c a l e M o d e 属性决定

说明

对于表单高度不包括边框和标题栏

对于控件高度是从其边框的外侧算起的

当用户或程序调整对象的大小时 H e i g h t 属性的值随之发生变化

在计算对象的面积时要用到 H e i g h t 和 W idth 属性

注意当用于列对象包含的控件时 H e i g h t 属性只读

示例

下面的示例演示了 H e i g h t 属性是如何指定表单中三个命令按钮的高度的

先使用 A d d o b j e c t 方法向表单中添加了一个线条控件和三个命令按钮再使用 H e i g h t

属性指定每个命令按钮的垂直高度f r m M y F o r m = C R E A T E O B J E C T ( ' f o r m ' ) & & 创建表单f r m M y F o r m . C l o s a b l e = . F . & & 使控件菜单框失效

f r m M y F o r m . A d d O b j e c t ( ' s h p L i n e ' , ' L i n e ' ) & & 向表单添加一个 Line 控件f r m M y F o r m . A d d O b j e c t ( ' c m d C m n d B t n 1 ' , ' c m d M y C m n d B t n 1 ' ) & & 向上命令按钮f r m M y F o r m . A d d O b j e c t ( ' c m d C m n d B t n 2 ' , ' c m d M y C m n d B t n 2 ' ) & & 向下命令按钮f r m M y F o r m . A d d O b j e c t ( ' c m d C m n d B t n 3 ' , ' c m d M y C m n d B t n 3 ' ) & & Q u i t 命令按钮

f r m M y F o r m . s h p L i n e . V i s i b l e = . T . & & 显示线条控件f r m M y F o r m . s h p L i n e . T o p = 2 0 & & 指定线条控件所在的行f r m M y F o r m . s h p L i n e . L e f t = 1 2 5 & & 指定线条控件所在的行

f r m M y F o r m . c m d C m n d B t n 1 . V i s i b l e = . T . & & 向上命令按钮可见f r m M y F o r m . c m d C m n d B t n 2 . V i s i b l e = . T . & & 向下命令按钮可见

4 1

f r m M y F o r m . c m d C m n d B t n 3 . V i s i b l e = . T . & & Q u i t 命令按钮可见

f r m M y F o r m . S H O W & & 显示表单R E A D E V E N T & & 开始处理事件

D E F I N E C L A S S c m d M y C m n d B t n 1 A S C O M M A N D B U T T O N & & 创建命令按钮C a p t i o n = ' S l a n t \ < U p ' & & 命令按钮的标题L e f t = 5 0 & & 命令按钮所在的列T o p = 1 0 0 & & 命令按钮所在的行

= 2 5 & & 命令按钮的高度

P R O C E D U R E C l i c kT h i s F o r m . s h p L i n e . V i s i b l e = . F . & & 隐藏 Line 控件T h i s F o r m . s h p L i n e . L i n e S l a n t = ' / ' & & 向上倾斜T h i s F o r m . s h p L i n e . V i s i b l e = . T . & & 显示线条控件

E N D D E F I N E

D E F I N E C L A S S c m d M y C m n d B t n 2 A S C o m m a n d B u t t o n & & 创建命令按钮C a p t i o n = ' S l a n t \ < D o w n ' & & 命令按钮的标题L e f t = 2 0 0 & & 命令按钮所在的列T o p = 1 0 0 & & 命令按钮所在的行


P R O C E D U R E C l i c kT h i s F o r m .s h p L i n e . V i s i b l e = . F . & & 隐藏线条控件T h i s F o r m . s h p L i n e . L i n e S l a n t = ' \ ' & & 向下倾斜T h i s F o r m . s h p L i n e . V i s i b l e = . T . & & 显示线条控件

E N D D E F I N E

D E F I N E C L A S S c m d M y C m n d B t n 3 A S C o m m a n d B u t t o n & & 创建命令按钮

4 2

C a p t i o n = ' \ < Q u i t ' & & 命令按钮的标题C a n c e l = . T . & & 默认为取消 ESC 命令按钮L e f t = 1 2 5 & & 命令按钮所在的列T o p = 1 5 0 & &命令按钮所在的行


P R O C E D U R E C l i c kC L E A R E V E N T & & 结束事件处理关闭表单

E N D D E F I N E

应用于

复选框组合框命令按钮命令组容器对象控件对象自定义编辑框表

单表格图像标签线条列表框 O L E 绑定型控件 O L E 容器控件选项按

钮选项组页框 _ S C R E E N 形状微调文本框计时器工具栏

请参阅

L e f t 属性 , M o v e 方法 , S c a l e M o d e 属性 , T o p 属性 , W i d t h 属性

H E L P 命令

打开帮助窗口

语法

4 3

H E L P[T o p i c | I D n C o n t e x t I D ][ I N [ W I N D O W ] W i n d o w N a m e | I N [ W IN D O W ] S C R E E N | I N [ W I N D O W ][ N O W A I T ]

参数描述

T o p i c指定要显示的帮助主题如果只给出主题词的部分拼写字母 V i s u a l F o x P r o会打开帮助窗口并显示拼写最相近的主题

I D n C o n t e x t I D根据主题的上下文标识 ( I D ) 指定要显示的帮助主题

在使用 D B F 样式帮助时 n C o n t e x t I D 是帮助表中字段的值字段

必须是该表的第一个字段

当使用图形样式帮助时 nContex t ID 是帮助项目文件中 M A P 部分的上下文编号

I N [ W I N D O W ] W i n d o w N a m e在一个父窗口中打开帮助窗口帮助窗口并不继承父窗口的任何特性如果

帮助窗口在一个父窗口内激活则它不能移出父窗口父窗口移动时帮助

窗口随之移动在父窗口中打开帮助窗口之前必须先用 D E F I N EW I N D O W 命令定义父窗口

4 4

I N [ W I N D O W ] S C R E E N把帮助窗口放置到 V i s u a l F o x P r o 主窗口中

N O W A I T在打开帮助窗口之后继续执行程序程序不必等待帮助窗口的关闭而是继

续执行 H E L P N O W A I T 之后的下一行程序如果省略 N O W A I T 则在一个

程序中执行 H E L P 命令后打开帮助窗口并且在关闭帮助窗口之前暂停执

行程序

在图形样式帮助中 N O W A I T 参数无效并且在发出 H E L P 命令后程序继续执行

说明

有关创建自己的帮助系统的详细内容请参阅 Microsoft Visual F o x P r o 6 . 0 中文版程

序员指南的相应部分

请参阅

S E T H E L P , S E T H E L P F I L T E R , S E T T O P I C

H e l p 方法

打开帮助窗口

语法

4 5

A p p l i c a t i o n O b j e c t .H e l p ( [ c F i l e N a m e] [ , n C o n t e x t I D ] [ , c H e l p T o p i c ] )

参数描述

c F i l e N a m e指定要打开的帮助文件的名称如果帮助文件不在默认目录中则在帮助文

件名中应该包含路径

n C o n t e x t I D根据主题的上下文 I D 指定要显示的帮助主题 n C o n t e x t I D 是帮助项目文

件 M A P 部分的上下文编号

c H e l p T o p i c指定要显示的帮助主题如果只包含了一个主题标题的部分拼写 V i s u a lF o x P r o 会打开帮助窗口并且使用最匹配的标题显示主题

说明

如果没有包含任何可选的参数则显示主帮助主题这个方法不支持 .d b f 样式的帮

助

应用于

A p p l i c a t i o n 对象 V F P 系统变量

请参阅

4 6

H E L P , S E T H E L P

H e l p C o n t e x t I D 属性

为帮助文件的一个主题指定上下文标识以便提供上下文相关帮助设计和运行时可

用

语法

O b j e c t.H e l p C o n t e x t I D [ = n C o n t e x t I D ]

参数描述

n C o n t e x t I D指定主题在图形样式或 . D B F 样式的帮助文件中的上下文标识编码 c o n t e x tI D 数字的有效范围为 0 到 2 6 8 , 4 3 5 , 4 5 5说明

设计和运行时可用若要在应用程序中为某个对象创建上下文相关帮助必须在创建

帮助文件时把相同的上下文编码同时赋给该对象和相关帮助主题 .

如果已经为应用程序创建了图形样式或 . D B F 样式帮助 V i s u a l F o x P r o 将调用帮助文

件并且请求当前上下文 I D 编码所标识的主题可以使用 S E T H E L P T O 语句指定帮

助文件并指定一个键以便使用 O N K E Y L A B E L 语句激活这个帮助文件创建图形

样式帮助所需要的帮助编译器在专业版 V i s u a l F o x P r o 中提供

4 7

当前的上下文标识编号是焦点对象的 H e l p C o n t e x t I D 属性的设置如果没有搜索到一

个非零的当前上下文编号则显示帮助文件的主目录

对于一个服务程序对象 H e l p C o n t e x t I D 属性指定了为该服务程序创建的类型库的上下

文 ID S e r v e r H e l p F i l e 属性指定了其中包含对应于这个上下文 I D 的帮助主题的帮助文

件

应用于

复选框组合框命令按钮命令组编辑框表单表格图像标签线条列

表框 O L E 绑定型控件 O L E 容器控件选项按钮选项组页面 _ S C R E E N

S e r v e r 对象形状微调文本框工具栏

请参阅

S e r v e r H e l p F i l e 属性 , S E T H E L P , S E T T O P I C

H I D E M E N U 命令

隐藏活动的用户自定义菜单栏

语法

H I D E M E N U M e n u B a r N a m e 1 [ , M e n u B a r N a m e 2 . . . ] | A L L[ S A V E ]

4 8

参数描述

M e n u B a r N a m e 1 [ , M e n u B a r N a m e 2 . . . ]指定要隐藏的菜单栏的名称或名称列表以逗句隔开各个菜单栏名

A L L隐藏所有的用户定义菜单栏

S A V E把菜单栏的图像放置到屏幕或某个窗口中常用于程序的开发和调试要从

V i s u a l F o x P r o 主窗口或用户自定义窗口中清除菜单栏的图像可以使用

C L E A R 命令

说明

H I D E M E N U 命令可以从 V i s u a l F o x P r o 主窗口或用户自定义窗口中移去指定的某个菜

单栏一组菜单栏或所有菜单栏但并不从内存中移去菜单的定义只有那些用

D E F I N E M E N U 创建的菜单栏才能被隐藏菜单栏的隐藏与废止是不同的菜单栏被

隐藏之后仍然驻留在内存中并且可以使用 A C T I V A T E M E N U 或 S H O W M E N U 命令

重新显示

请参阅

A C T I V A T E M E N U , D E F I N E M E N U , D E F I N E P A D , S H O W M E N U

4 9

H i d e 方法

通过把 V i s i b l e 属性设置为假 ( .F.) 隐藏表单表单集或工具栏

语法

O b j e c t.H i d e说明

表单被隐藏后用户不可访问它的控件但是这些控件仍然可用并且可以在代码中

访问它们虽然这些控件是不可见的但这些保存在不可见表单中的控件仍然保留自

己的 V i s i b l e 属性设置值

当表单集的 V i s i b l e 属性为假 ( .F . ) 时用户看不到它所包含的表单表单集被隐藏

后用户不可访问其中的表单但是这些表单仍然可用并且可以在代码中访问它

们表单集的 H i d e 方法并不设置子表单的 V i s i b l e 属性因此当一个表单包含在一

个表单集中时若要判断表单是否可见必须同时检查表单和表单集的 V i s i b l e 属性设

置

隐藏表单集之后 V i s u a l F o x P r o 激活前一个活动对象如在此之前没有活动对象则

激活 V i s u a l F o x P r o 主窗口

为 _ S C R E E N 系统变量调用 H i d e 方法无效

应用于

5 0

表单表单集 _ S C R E E N 工具栏

请参阅

A c t i v a t e 事件 , D e a c t i v a t e 事件 , E n a b l e d 属性 , G o t F o c u s 事件 , S h o w 方法 ,V i s ib l e 属性

H I D E P O P U P 命令

隐藏由 H I D E P O P U P 创建的一个或多个活动菜单

语法

H I D E P O P U P M e n u N a m e 1 [ , M e n u N a m e 2 . . . ] | A L L[ S A V E ]

参数描述

M e n u N a m e 1 [ , M e n u N a m e 2 . . . ]指定要隐藏的菜单的名称或名称列表以逗号隔开各个菜单名

A L L隐藏所有已定义的菜单

S A V E把菜单图像放到 V i s u a l F o x P r o 主窗口或用户自定义窗口上常用于程序开发

和调试要从窗口中清除菜单的图像可使用 C L E A R 命令

5 1

说明

H I D E P O P U P 命令可以从 V i s u a l F o x P r o 主窗口或用户自定义窗口中移去指定的一个

一组或全部菜单但并未删除内存中的菜单定义本命令只隐藏那些由 D E F I N E

P O P U P 命令创建的菜单菜单的隐藏与废止是不同的菜单被隐藏之后仍然驻留在内

存中可用 A C T I V A T E P O P U P 或 S H O W P O P U P 命令重新显示

请参阅

A C T I V A T E P O P U P , D E F I N E B A R , D E F I N E P O P U P , S H O W P O P U P

5 2

H I D E W I N D O W 命令

隐藏一个活动的用户自定义窗口或 V i s u a l F o x P r o 系统窗口

语法

H I D E W I N D O W W i n d o w N a m e 1 [ , W i n d o w N a m e 2 . . . ] | A L L | S C R E E N[ I N [ W I N D O W ] W i n d o w N a m e N | I N [ W IN D O W ] S C R E E N| I N [ W I N D O W ][ B O T T O M | T O P | S A M E ]

参数描述

W i n d o w N a m e 1 [ , W i n d o w N a m e 2 . . . ]指定要隐藏的窗口的名称名称列表以逗号隔开各个窗口名不包含任何

参数的 H I D E W I N D O W 命令将隐藏当前的活动窗口在 V i s u a l F o x P r o 中也可指定要隐藏的工具栏名若要查阅 V i s u a l F o x P r o 的全部工具栏名称请

参阅 S H O W W I N D O WA L L

隐藏所有窗口

S C R E E N隐藏 Visual F o x P r o 主窗口若要再次显示 Visual F o x P r o 主窗口可使用

5 3

A C T I V A T E W I N D O W S C R E E N 或 S H O W W I N D O W S C R E E N 命令

I N [ W I N D O W ] W i n d o w N a m e N在父窗口内隐藏一个窗口

I N [ W I N D O W ] S C R E E N隐藏 V i s u a l F o x P r o 主窗口中的一个窗口

B O T T O M | T O P | S A M E指定要把窗口隐藏到什么位置相对其他窗口而言 B O T T O M 将窗口放

到所有窗口的后面 T O P 默认值则将窗口放到所有窗口的前面 S A M E在隐藏窗口时不影响原先的前后关系在用 S H O W W IN D O W A L L 命令显示

所有隐藏窗口时若要保持它们之间的相对位置应使用 S A M E 关键字

说明

H I D E W I N D O W 命令可从 V i s u a l F o x P r o 主窗口或用户自定义窗口中移去一个或多个

窗口 H I D E W I N D O W 命令也可以用来隐藏系统窗口如命令窗口和查看窗口等

隐藏窗口与关闭窗口是不同的隐藏后的窗口仍驻留在内存中并且仍然是活动窗

口可以向隐藏窗口输出数据只是不能看见该窗口

释放一个窗口可从内存中删除该窗口要想重新显示已移去的窗口则必须重定义这个

窗口显示窗口可使用 A C T I V A T E W I N D O W 或 S H O W W I N D O W 命令

若要隐藏系统窗口和工具栏在 V i s u a l F o x P r o 中必须用引号把系统窗口或工具栏

的全名括起来例如若要隐藏 V i s u a l F o x P r o 中报表控制工具栏可执行下列命

令H I D E W I N D O W " R e p o r t C o n t r o l s "

5 4

示例

下面的示例定义并激活了窗口程序等待您按一个键然后隐藏此窗

口程序等待您再按一个键然后显示窗口的数值第三次按键会从屏幕和内存中删

除此窗口D E F I N E W I N D O W w O u t p u t 1 F R O M 6 , 1 T O 1 9 , 7 5 T I T L E ' O u t p u t ' ;

C L O S E F L O A T G R O W Z O O MA C T I V A T E W I N D O W w O u t p u t 1

W A I T W I N D O W ' P r e s s a k e y t o h i d e t h i s w i n d o w ' w O u t p u t 1

W A I T W I N D O W ' P r e s s a k e y t o s e e t h e w i n d o w a g a i n 'S H O W W I N D O W w O u t p u t 1

W A I T W I N D O W ' P r e s s a k e y t o r e m o v e t h e w i n d o w f r o m m e m o r y 'D E A C T I V A T E W I N D O W w O u t p u t 1R E L E A S E W I N D O W w O u t p u t 1

请参阅

A C T I V A T E W I N D O W , D E A C T I V A T E W I N D O W , D E F I N E W I N D O W ,R E L E A S E W I N D O W , S H O W W I N D O W

5 5

H i d e D o c 事件

当您从一个 A c t i v e D o c u m e n t 漫游时发生

语法

P R O C E D U R E O b jec t .H i d e D o c说明

当您从一个 Act ive Document 漫游时或者当关闭 Ac t ive Document 的容器时发生 HideDoc

事件

当 Act ive Document 容器最小化或者当容器恢复原来大小时不发生 HideDoc 事件

应用于

A c t i v e D o c 对象

请参阅

S h o w D o c 事件

5 6

H i d e S e l e c t i o n 属性

指定当一个控件失去焦点时已选中的文本是否显示为选中设计和运行时可用

语法

C o n t r o l.H i d e S e l e c t i o n [ = l E x p r]参数描述

l E x p rH i d e S e l e c t i o n 属性的设置有

设置说明

真 ( .T . ) 默认值当控件失去焦点时已选中的文本不显示为选中

假 ( .F.) 当控件失去焦点时已选中的文本显示为选中

说明

可以使用这个属性表明当另一个表单或对话框获得焦点时所选中的文本例如在拼

写检查例程中

应用于

组合框编辑框微调文本框

请参阅

D i s a b l e d B a c k C o l o r , D i s a b l e d F o r e C o l o r 属性 , G o t F o c u s 事件 , L o s t F o c u s 事件

5 7


指定表格控件中具有焦点的单元格是否显示为选中设计时可用运行时可读写

语法

G r i d .H i g h l i g h t [ = l E x p r]参数描述

l E x p rH i g h l i g h t 属性的设置有

设置说明

真 ( .T . ) 默认值具有焦点的单元格显示为选中

假 ( .F.) 具有焦点的单元格不显示为选中

说明

如果 H i g h L i g h t 属性设置为真 ( .T . ) 可以将它与一个列的 S e l e c t O n E n t r y 属性一起

使用以确定整个单元格是否显示为选中如果将 H i g h L i g h t 属性设置为假

( .F.) 则会忽略 S e l e c t O n E n t r y 属性

应用于

表格

5 8

请参阅

H i g h l i g h t R o w 属性 , S e l e c t O n E n t r y 属性

H i g h l i g h t R o w 属性

指定一个表格控件中的当前行和单元格是否突出显示设计时可用运行时可读写

语法

G r i d .H i g h l i g h t R o w [ = l E x p r]参数描述

l E x p rH i g h l i g h t R o w 属性的设置有

设置说明

真 ( .T . ) 默认值当前行和单元格突出显示

假 ( .F.) 当前行和单元格不突出显示

应用于

表格

请参阅


5 9

H O M E 函数

返回启动 V i s u a l F o x P r o 和 V i s u a l S t u d i o 的目录名

语法

H O M E ( [ n L o c a t i o n ] )返值类型

字符型

参数描述

n L o c a t i o n指定 H O M E 返回特定的 V i s u a l F o x P r o 或 V i s u a l S t u d i o 目录的名称注

意如果省略 n L o c a t i o n 则等同于 H O M E ( 0 )下表列出了 n L o c a t i o n 的值以及 H O M E 返回的目录假设您在安装

V i s u a l F o x P r o 或 V i s u a l S t u d i o 时选择了默认的安装目录

n L o c a t i on

目录

0 或省略启动 V i s u a l F o x P r o 的目录

1 V i s u a l F o x P r o 的安装根目录

6 0

续表

2 包含 V i s u a l F o x P r o 示例的目录这个目录等同于 _ S A M P L E S 系

统变量中的示例目录

3 V i s u a l S t u d i o C o m m o n 目录

4 V i s u a l S t u d i o C o m m o n \ G r a p h i c s 目录

5 V i s u a l S t u d i o 和 M S D N 的示例目录

6 V i s u a l S t u d i o C o m m o n \ T o o l s 目录

说明

H O M E 函数与 S Y S ( 2 0 0 4 ) 命令等价包含它是为了提供与 d B A S E I V 的兼容性

示例

C L E A R? ‘Visual F o x P r o S ta rup d i rec to ry : ‘ , ? ‘Visual FoxPro i ns ta l l a t i on d i rec to ry : ‘ , 1? ‘Visual F o x P r o s a m p l e s d i r e c t o r y : ‘ , 2? ‘V i s u a l S t u d i o c o m m o n d i r e c t o r y : ‘ , 3? ‘V i sua l S tud io g raph i cs d i r ec to r y : ‘, 4? ‘V i s u a l S t u d i o s a m p l e s d i r e c t o r y : ‘, 5? ‘V i sua l S tud io t oo l s d i rec to ry : ‘ , 6

请参阅

_ S A M P L E S 系统变量 , S Y S 函数概述 , S Y S ( 2 0 0 4 )

6 1

H o m e D i r 属性

指定项目的主目录

语法

O b j e c t.H o m e D i r [ = c D i r e c t o r y ]参数描述

c D i r e c t o r y指定项目的主目录默认值是 V i s u a l F o x P r o 当前目录可以用 C U R D I R函数确定这个目录

说明

项目的主目录是项目中所有文件的相对路径 H o m e D i r 属性对应于项目信息对话

框项目选项卡中主目录文本框中的目录

应用于

项目对象

请参阅

C U R D I R , 项目信息对话框

6 2

H o s t N a m e 属性

返回或设置您的 V i s u a l F o x P r o 应用程序的用户可读的宿主名设计时可用运行时可

读写

语法

C o n t r o l.H o s t N a m e [ = c N a m e ]参数描述

c N a m e返回或设置一个字符串表达式该表达式指定了宿主名

说明

当编辑一个对象时 H o s t N a m e 属性的设置会显示为该对象的窗口主题但是有些提

供对象的应用程序不显示这个 H o s t N a m e 属性的值

应用于

O L E 绑定型控件 O L E 容器控件

请参阅

D o c u m e n t F i l e 属性

6 3

H O U R 函数

返回日期时间表达式的小时部分

语法

H O U R (t E x p r e s s i o n )参数描述

t E x p r e s s i o n指定的日期时间表达式 H O U R 函数将返回它的小时部分

返值类型

数值型

说明

H O U R 函数返回的数值是以 2 4 小时制为基础的并且不受 S E T H O U R S 当前设置

的影响例如不论 S E T H O U R S 设置为 1 2 还是 2 4 下列命令都将返回 1 3? H O U R ( { ^ 1 9 9 8 - 0 2 - 1 6 1 : 0 0 p } )

示例

下面的示例将显示当前时间的小时部分和一个指定时间的小时部分C L E A R

6 4

? D A T E T I M E? { ^ 1 9 9 8 - 0 2 - 1 6 1 0 : 4 2 a } & & 显示数值 1 0

请参阅

C T O T , D A T E , D A T E T I M E , D T O T , M I N U T E , S E C, S E C O N D S , SET S E C O N D S , T I M E

H o u r s 属性

指定在一个日期时间值的小时部分是显示为 12 或 2 4 小时时间格式设计运行时可用

语法

O b j e c t.H o u r s [ = n V a l u e ]参数描述

n V a l u e取下列设置之一

设置说明

0 默认值由 S E T H O U R S 的设置确定在一个日期时间值的小时部分

是显示为 1 2 还是 2 4 小时时间格式如果 S E T H O U R S 为 1 2 则这个

日期时间值的小时部分显示为 1 2 小时时间格式如果 S E T H O U R S 为

2 4 则这个日期时间值的小时部分显示为 2 4 小时时间格式

6 5

续表

1 2 日期时间值的小时部分显示为 1 2 小时时间格式

2 4 日期时间值的小时部分显示为 2 4 小时时间格式

说明

如果 D a t e F o r m a t 属性的设置为 S h o r t 或 L o n g 则忽略 H o u r s 属性的设置

应用于

文本框

请参阅

C e n t u r y 属性 , D a t e F o r m a t 属性 , D a t e M a r k 属性 , S e c o n d s 属性 , SET H O U R S ,S t r i c t D a t e E n t r y 属性

H S c r o l l S m a l l C h a n g e 属性

指定当单击一个表单的水平滚动箭头时表单的水平滚动量设计和运行时可用

语法

O b j e c t.H S c r o l l S m a l l C h a n g e [ = n E x p r e s s i o n ]参数描述

6 6

n E x p r e s s i o n指定水平滚动的增量度量单位由 S c a l e m o d e 属性的设置决定当

S c a l e m o d e 属性设置为 3 – 像素时默认的增量为 1 0 个像素

应用于

表单

请参阅

S c a l e M o d e 属性 , S c r o l l B a r s 属性 , V S c r o l l S m a l l C h a n g e 属性

H y p e r l i n k 对象

创建一个超链接对象

语法

H y p e r l i n k说明

超链接对象为 V i s u a l F o x P r o 应用程序和包含在容器例如 M i c r o s o f t I n t e r n e t

E x p l o r e r 中的 A c t i v e D o c u m e n t s 提供了漫游能力使用超链接对象 V i s u a l F o x P r o 应

6 7

用程序可以要求一个 A c t i v e D o c u m e n t 容器跳转到一个给定的 U R L ( U n i f o r m R e s o u r c e

L o c a t o r )

超链接对象没有用户界面超链接对象的 N a v i g a t e T o 方法允许您跳转到一个给定的

U R L G o B a c k 和 G o F o r w a r d 方法允许您在容器的历史列表中前后移动

附注只在 M i c r o s o f t I n t e r n e t E x p l o r e r 中支持超链接对象使用 V i s u a l F o x P r o 的

H y p e r l i n k 按钮 H y p e r l i n k 图像或组件管理库中的 H y p e r l i n k L a b e l 基类可以获得独立

于浏览器的漫游能力

属性

A p p l i c a t i o n B a s e C l a s s C l a s sC l a s s L i b r a r y C o m m e n t N a m eP a r e n t P a r e n t C l a s s T a g

事件

D e s t r o y E r r o r In i t

方法

A d d P r o p e r t y G o B a c k M e t h o d G o F o w a r d M e t h o dN a v i g a t e T oM e t h o d

R e a d E x p r e s s i o n R e a d M e t h o d

R e s e t T o D e f a u l t S a v e A s C l a s s W r i t e E x p r e s s i o n

请参阅

6 8

A c t i v e D o c 对象

I c o n 属性

指定最小化表单时显示的图标对于表单指定在运行时刻一个表单最小化时显示的

图标设计和运行时可用

对于项目对象指定为一个发布的 .e x e 应用程序显示的图标

语法

O b j e c t. I c o n [ = c F i l e N a m e]参数描述

c F i l e N a m e指定表单最小化时所显示图标的文件名和路径对于表单指定表单最小化

时显示的图标的文件名和路径对于一个发布的 . e x e 应用程序为该应用程

序显示的图标的文件名和路径

说明

对于表单 I c o n 属性可以为任何表单指定自定义图标运行时供用户最小化表单时

使用例如可以指定一个特殊图标来说明表单的功能设计时从属性窗口中输入

图标的文件名文件名必须以 . I C O 为扩展名并且具有图标的格式如果不指定图

标系统使用 V i s u a l F o x P r o 的默认表单图标

6 9

可以使用 G R A P H I C S \ I C O N S 子目录中的 V i s u a l F o x P r o 图标库

注意如果在设计时设置了 I c o n 属性而指定的文件不存在 V i s u a l F o x P r o会显示错误信息但该属性仍指向指定文件如果在运行时 I c o n 属性

指向一个不存在的文件 V i s u a l F o x P r o 将忽略这个 I c o n 属性

对于项目对象 I c o n 属性指定为一个发布的 . e x e 应用程序显示的图标不能为一个发

布的 V i s u a l F o x P r o . a p p 应用程序指定图标

应用于

表单项目对象 _ S C R E E N

请参阅

C a p t i o n 属性 , P i c t u r e 属性

I D X C O L L A T E 函数

返回索引或索引标识的排序序列

语法

I D X C O L L A T E ( [ c C D X F i l e N a m e , ] n I n d e x N u m b e r [ , n W o r k A r e a |c T a b l e A l i a s ] )

7 0

返值类型

字符型

参数描述

c C D X F i l e N a m e指定复合索引文件名该复合索引文件可以是随表自动打开的结构复合索引

文件也可以是独立的复合索引文件

n I n d e x N u m b e r指定索引或索引标识 I D X C O L L A T E 返回其排序序列当

n I n d e x N u m b e r 从 1 递增到打开的索引文件和索引标识总数时

I D X C O L L A T E 按如下次序返回索引或索引标识的排序序列

1 . 首先返回单项索引 . I D X 文件如果有此类文件打开的排序序列返回

的排序序列取决于 U S E 或 S E T I N D E X 中包含的单项索引文件的序列

2 . 然后返回结构复合索引如果存在中标识的排序序列标识的排序序列

按照标识在结构复合索引中创建的次序返回

3 . 最后返回打开的独立复合索引中标识的排序序列标识的排序序列按照标

识在独立的复合索引中创建的顺序返回

如果 n I n d e x N u m b e r 大于打开的单项索引文件结构复合索引标识和独立的复合索引标

识的总数目则返回空字符串

n W o r k A r e a指定表的工作区 I D X C O L L A T E 函数返回该表的索引文件和索引标识

7 1

的排序序列

如果指定的工作区中没有打开的表 I D X C O L L A T E 函数将返回空字符串

c T a b l e A l i a s指定表的别名 I D X C O L L A T E 返回该表的索引文件和索引标识的排序

序列

如果指定的表别名不存在 V i s u a l F o x P r o 产生错误信息

说明

I D X C O L L A T E 函数可以返回多项复合索引文件中每一标识的排序序列这样只

需使用一系列的 S E T C O L L A T E 和 I N D E X 命令就可以完全删除一个索引文件然

后再正确地重建这个索引文件

附注 R E I N D E X 的某些功能并不需要 I D X C O L L A T E 因为其排序序列信息已经存

放在索引和索引标识中

有关 Visual F o x P r o 国际化支持的详细内容请参阅 Microsoft Visual F o x P r o 6 . 0 中

文版程序员指南的第十八章开发国际化应用程序

示例

下面示例先打开 t e s tda ta 数据库的 c u s t o m e r 表然后使用 F O R . . . E N D F O R 创建一个循

环在该循环中应用 I D X C O L L A T E 函数来显示 c u s t o m e r 结构索引中每个索引标

识的排序序列每个结构索引标识的名称和它的排序序列一起显示C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' D a t a \ t e s t d a t a ' )U S E C u s t o m e r & & 打开 c u s t o m e r 表

7 2

C L E A R

F O R n C o u n t = 1 T O 2 5 4I F ! E M P T Y ( T A G ( n C o u n t ) ) & & 检查索引标识? T A G ( n C o u n t ) + ' ' & & 显示标识名? ? n C o u n t & & 显示排序序列E L S E

E X I T & & 在找到所有的标识之后退出循环E N D I F

E N D F O R

请参阅

S E T C O L L A T E

I F . . . E N D I F 命令

根据逻辑表达式值有选择地执行一组命令

语法

I F l E x p r e s s i o n [ T H E N ]C o m m a n d s

[ E L S EC o m m a n d s ]

7 3

E N D I F参数描述

l E x p r e s s i o n指定要计算的逻辑表达式如果 l E x p r e s s i o n 的计算结果为真 .T . 则

执行 I F 语句之后 E L S E 或 E N D I F 语句以先出现的语句为准之前的所

有命令

• 如果 l E x p r e s s i o n 为假 . F . 而且包含 E L S E 语句则执行 E L S E 语句

之后 E N D I F 语句之前的所有命令

• 如果 l E x p r e s s i o n 为假 . F . 但不包含 E L S E 语句则忽略 I F 语句和

E N D I F 之间的所有命令在这种情况下程序从 E N D I F 语句后面的第一

条命令开始继续往下执行

说明

一个 I F . . . E N D I F 语句块之中可以嵌套另一个 I F . . . E N D I F 语句块

注释可以放在 IF E L S E 和 E N D I F 所在行的后面在编译和执行时程序将忽略这些

注释

示例

C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' D a t a \ t e s t d a t a ' )U S E C u s t o m e r & & 打开 c u s t o m e r 表

7 4

G E T E X P R ' E n t e r c o n d i t i o n t o l o c a t e ' T O g c T e m p ;T Y P E ' L ' D E F AU L T ' C O M P A N Y = " " '

L O C A T E F O R & g c T e m p & & 输入 L O C A T E 表达式 F O U N D & & 是否找到 ?D I S P L A Y & & 是显示记录

& & I f n o t f o u n d? ' C o n d i t i o n ' + g c T e m p + ' w a s n o t f o u n d ' & & 显示相应信息

U S E

请参阅

D O C A S E . . . E N D C A S E , D O W H I L E . . . E N D D O , F O R . . . E N D F O R , I I F ,S C A N . . . E N D S C A N

I IF 函数

根据逻辑表达式的值返回两个值中的某一个

语法

I I F ( l E x p r e s s i o n , e E x p r e s s i o n 1 , e E x p r e s s i o n 2 )返值类型

字符型数字型货币型日期型或日期时间型

7 5

参数描述

l E x p r e s s i o n指定要计算的逻辑表达式

e E x p r e s s i o n 1 , e E x p r e s s i o n 2如果 l E x p r e s s i o n 计算结果为真 ( . T . ) 返回 e E x p r e s s i o n 1 如果

l E x p r e s s i o n 为假 ( .F . ) 则返回 e E x p r e s s i o n 2说明

该函数也称作 I m m e d i a t e I F 它计算一个逻辑表达式的值然后根据计算结果返回

两个表达式中的一个如果逻辑表达式的值为真 ( .T . ) 则 I IF 返回第一个表达

式如果逻辑表达式的值为假 ( .F.) 则 I IF 返回第二个表达式

提示对于简单的条件表达式该函数可以代替 I F . . . E N D I F 语句在按条件

指定报表和标签表达式中的字段内容时 I IF 特别有用 I IF 函数比等价语句 I F . . . E N D I F 执行速度快得多

示例

下面的示例用 I IF 来检查表的备注字段是否为空如果为空显示

没有说明否则显示备注字段的内容C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' D a t a \ t e s t d a t a ' )U S E e m p l o y e e & & 打开 E m p l o y e e 表C L E A R

S C A N

7 6

? E M P T Y (N o t e s ) , 'No N o t e s ', no te s & & 备注字段为空否 ?E N D S C A N

请参阅

I F . . . E N D I F

I m a g e 控件

创建一个可以显示 . B M P 图片的图像控件

语法

I m a g e说明

图像控件是一种图形控件可以显示 . B M P 图片但不能直接修改图片然而同其

他控件一样图像控件具有一整套属性事件和方法因而可以响应事件并且可以

在运行时改变自己

有关创建图像的详细内容请参阅 M i c r o s o f t V i s u a l F o x P r o 6 . 0 中文版程序员指南


7 7

属性

A p p l i c a t i o n B a c k S t y l e B a s e C l a s sB o r d e r C o l o r B o r d e r S t y l e C l a s sC l a s s L i b r a r y C o l o r S o u r c e C o m m e n tD r a g I c o n D r a g M o d e E n a b l e dH e i g h t H e l p C o n t e x t I D L e f tM o u s e P o i n t e r N a m e O L E D r a g M o d eO L E D r a g P i c t u r e O L E D r o p E f f e c t s O L E D r o p H a s D a t aO L E D r o p M o d e P a r e n t P a r e n t C l a s sP i c t u r e S t r e t c h T a gT o o l T i p T e x t T o p V is ib leW h a t s T h i s H e l p I D W idth

事件

C l i c k D b l C l i c k D e s t r o yD r a g D r o p D r a g O v e r E r r o rIn i t M i d d l e C l i c k E v e n t M o u s e D o w nM o u s e M o v e M o u s e U p M o u s e W h e e lO L E C o m p l e t e D r a g O L E D r a g D r o p O L E D r a g O v e r

7 8

续表

O L E G i v e F e e d B a c k O L E S e t D a t a O L E S t a r t D r a gR i g h t C l i c k U I E n a b l e

方法

A d d P r o p e r t y C l o n e O b j e c t D r a gM o v e O L E D r a g R e a d E x p r e s s i o nR e a d M e t h o d R e s e t T o D e f a u l t S a v e A s C l a s sW r i t e E x p r e s s i o n W r i t e M e t h o d Z o r d e r

请参阅

C R E A T E C L A S S , C R E A T E F O R M , D E F I N E C L A S S

IM E M o d e 属性

为一个独立的控件指定 I n p u t M e t h o d E d i t o r ( I M E ) 窗口设置设计和运行时可用

语法

O b j e c t. IM E M o d e [ = n E x p r e s s i o n ]参数描述

7 9

n E x p r e s s i o n取下列设置之一

n E x p r e s s i o n I M E 窗口动作

0 默认值不控制由操作系统确定当控件获得焦点时是否打开

I M E 窗口如果当控件获得焦点时 I M E 窗口是关闭的可以通

过按激活 I M E 窗口的组合键打开 I M E 窗口

1 打开 I M E 当控件获得焦点时打开 I M E 窗口

2 关闭 I M E 当控件获得焦点时关闭 I M E 窗口可以通过按激活

I M E 窗口的组合键打开 I M E 窗口

说明

除非您运行的是远东版 M i c r o s o f t W i n d o w s 9 5 或 W i n d o w s N T 否则会忽略这个属性

应用于

组合框编辑框文本框

请参阅

I M E S T A T U S , S E T B R O W S E I M E

8 0

IM E S T A T U S 函数

打开或关闭 I M E 输入法编辑器窗口或者返回当前的 I M E 状态

语法

I M E S T A T U S ( [n E x p r e s s i o n ])

返值类型

数值型

参数描述

n E x p r e s s i o n打开或关闭 IM E 输入法编辑器窗口下表列出了 n E x p r e s s i o n 的值和相

应的 IM E 窗口的状态

n E x p r e s s i o n I M E 窗口动作

0 关闭 I M E 窗口

1 打开 I M E 窗口

如果省略 n E x p r e s s i o n I M E S T A T U S 返回当前的 I M E 状态下表列出了 I M E 状态

的返回值使用 V E R S I O N ( 3 ) 决定当前环境

下面的表列出了为日语地区的 I M E 状态返回的值

8 1

返回值 I M E 状态

0 没有安装 I M E

1 打开 I M E

2 关闭 I M E

3 使 I M E 不可用

4 H i r a g a n a 模式 (双精度 )

5 K a t a k a n a 模式 (双精度 )

6 K a t a k a n a 模式 (单精度 )

7 A l p h a 数值型模式 (双精度 )

8 A l p h a 数值型模式 (单精度 )

下面的表列出了为朝鲜语地区的 I M E 状态返回的值

返回值 I M E 状态

0 没有安装 I M E

1 H a n g u l 模式 (单精度 )

2 E n g l i s h 模式 (单精度 )

1 1 E n g l i s h 模式 (双精度 )

1 5 H a n g u l 模式 (双精度 )

2 3 H a n j a 转换模式 ( H a n g u l + 单精度模式 )

3 1 H a n j a 转换模式 ( H a n g u l + 双精度模式 )

说明

8 2

详细内容请参阅 Microsoft Visual F o x P r o 6 . 0 中文版程序员指南的第十八

章开发国际化应用程序中的输入国际化字符

操作对于如 H i r a g a n a 和 K a t a k a n a 语言的双精度字符设置时该函数非常有用

请参阅

S E T B R O W S E I M E , I M E M o d e 属性 , I S L E A D B Y T E , S T R C O N V

IM P O R T 命令

从外部文件导入数据创建一个 V i s u a l F o x P r o 新表

语法

I M P O R T F R O M F i l e N a m e[ D A T A B A S E D a t a b a s e N a m e [ N A M E L o n g T a b l e N a m e ] ][ T Y P E ] F W 2 | M O D | P D O X | R P D | W K 1| W K 3 | W K S | W R 1 | W R K | X L S| X L 5 [ S H E E T c S h e e t N a m e]| X L 8 [ S H E E T c S h e e t N a m e][ A S n C o d e P a g e ]

参数描述

8 3

F i l e N a m e指定导入数据的文件名如果不包含文件扩展名则使用默认扩展名

D A T A B A S E D a t a b a s e N a m e创建的新表将加入到本处指定的数据库中

N A M E L o n g T a b l e N a m e为新表指定一个长表名长表名最多可包含 1 2 8 个字符若不指定长表名

则使用 F i l e N a m e 作为表名

T Y P E关键字 T Y P E 是可选的但 IM P O R T 命令中必须包含以下某种文件类型

文件类型说明

F W 2 包含 F W 2 表示要导入由 F r a m e w o r k I I 创建的 F W 2 型文件

M O D 包含 M O D 表示要导入由 M ic ro so f t Mu l t i p l an 4 .0 创建的 M O D

型文件

P D O X 包含 P D O X 可导入 P a r a d o x 文件要导入 B o r l a n d 公司的

P a r a d o x 3 . 5 和 4 . 0 中的数据库文件可以包含 P D O X

7 R P D 包含 R P D 可导入由 R a p i d F i l e 创建的 R P D 型文件

W K 1 | W K 3 |

W K S

包含 W K 1 可以从 L o t u s 1 - 2 - 3 的电子表格中导入数据电子表

格中的列变为表中的字段行变为表中的记录 Lotus 1 -2 -3

2 . X 创建的电子表格以 W K 1 为扩展名 L o t u s 1 - 2 - 3 3 . X 创建的

电子表格以 W K 3 为扩展名 L o t u s 1 - 2 - 3 1 - A 创建的电子表格

以 W K S 为扩展名

8 4

续表

W R 1 | W R K 包含 W R 1 可由 L o t u s S y m p h o n y 电子表格导入数据电子表格

中的列变为表中的字段行变为表中的记录 S y m p h o n y 1 . 1 0

产生的电子表格以 .W R 1 为扩展名 S y m p h o n y 1 . 1 产生的电子

表格以 . W R K 为扩展名

X L S 包含 X L S 可从 M icrosof t Exce l 2 .0 3 . 0 和 4 . 0 的工作表中导入

数据工作表中的列变为表中的字段行变为表中的记录

M i c r o s o f t E x c e l 创建的工作表文件以 . X L S 为扩展名

X L 5 [ S H E E T

c S h e e t N a m e ]

包含 X L 5 可以从 M ic roso f t Exce l 5 .0 中导入数据工作表中的

列变为表中的字段行变为表中的记录 M i c r o s o f t E x c e l 创建

的工作表文件以 . X L S 为扩展名

如果省略了 S H E E T 子句则 V i s u a l F o x P r o 从 S H E E T 1 中导入

数据若要从某一指定工作表中导入数据就应包含关键字

S H E E T 并用参数 c S h e e t N a m e 来指定工作表的名称

X L 8 [ S H E E T

c S h e e t N a m e ]

包含 X L 8 可以从 M ic roso f t Exce l 9 7 中导入数据工作表中的

列变为表中的字段行变为表中的记录 M i c r o s o f t E x c e l 创建

的工作表文件以 . X L S 为扩展名

如果省略了 S H E E T 子句则 V i s u a l F o x P r o 从 S H E E T 1 中导入

数据若要从某一指定工作表中导入数据就应包含关键字

S H E E T 并用参数 c S h e e t N a m e 来指定工作表的名称

A S n C o d e P a g e指定导入文件的代码页 V i s u a l F o x P r o 复制导入文件的内容并且在复制同

8 5

时把数据自动转换成当前 V i s u a l F o x P r o 代码页

如果 V i s u a l F o x P r o 不支持指定的 n C o d e P a g e 的值会产生错误信息也可以使用获取

n C o d e P a g e 的 G E T C P 函数来显示代码页对话框并在对话框中指定一个代码

页

如果省略了 A S n C o d e P a g e 而 V i s u a l F o x P r o 不能决定导入文件的代码页 V i s u a l

F o x P r o 会复制导入文件的内容而且在复制的同时把数据自动转换成当前的 V i s u a l

F o x P r o 代码页如果省略了 A S n C o d e P a g e 子句而 V i s u a l F o x P r o 可以决定导入文件的

代码页则 V i s u a l F o x P r o 会自动将导入文件中的数据从数据代码页转换成当前的

V i s u a l F o x P r o 代码页使用 C P C U R R E N T 可以确定当前的 V i s u a l F o x P r o 代码页

如果 n C o d e P a g e 的值为 0 V i s u a l F o x P r o 假定导入文件的代码页即为当前的 V i s u a l

F o x P r o 代码页并且不进行代码页转换

说明

大部分软件包以自己可以使用的文件格式存储数据 V i s u a l F o x P r o 不能直接打开它

们 I M P O R T 命令使用存储于 V i s u a l F o x P r o 不能直接读的文件格式中的数据创建新的

V i s u a l F o x P r o 表

新创建的表与导入数据的文件名同名但以 . D B F 为扩展名

请参阅

A P P E N D F R O M , C O P Y T O , E X P O R T , G E T C P

8 6

_ I N C L U D E 系统变量

指定一个默认的头文件其中包含用户定义的类表单或表单集

语法

_ I N C L U D E = H e a d e r F i l e N a m e参数描述

H e a d e r F i l e N a m e指定预定义编译常数的默认头文件其中自动包含用户定义的类表单或表

单集如果头文件没有位于当前默认目录中则在头文件名中应该包含路

径

说明

可以通过选项对话框中的默认文件项目确定默认的头文件

请参阅

C R E A T E C L A S S 命令 , C R E A T E F O R M 命令 , F i l e L o c a t i o n s T a b , 选项对话框 ,# I N C L U D E

8 7

I n c r e m e n t 属性

单击上箭头或下箭头时微调控件中数值增加或减小的量设计和运行时可用

语法

S p i n n e r . I n c r e m e n t [ = n I n c r e m e n t]参数描述

n I n c r e m e n t指定单击上箭头时微调中增加的数值和单击下箭头时微调减少的数值默认

值为 1 . 0 0应用于

微调

请参阅

R a n g e L o w 事件

8 8

I n c r e m e n t a l S e a r c h 属性

指定控件是否支持对键盘操作的递增搜索设计和运行时可用

语法

C o n t r o l . I n c r e m e n t a l S e a r c h [ = l E x p r]参数描述

l E x p r下表列出了 I n c r e m e n t a l S e a r c h 属性的设置

设置说明

真 ( .T . ) 默认设置支持递增搜索

假 ( .F.) 不支持递增搜索

说明

设计和运行时可用下面举例说明什么是递增搜索比如要搜索 E L A S T I C 这个单

词可以键入 E - L - A 等等在键入字母的时候 V i s u a l F o x P r o 会逐步搜索所键入

字母的组合逐字匹配要找的单词在非递增搜索的情况下它会找首字母为 E 的第

一个单词然后再找首字母为 L 的第一个单词以此类推

附注 D B L C L I C K 系统变量的设置确定了对于下一个键入的字母等待多长时间可以调

整 _ D B L C L I C K 的值使得递增搜索正常工作

8 9

应用于

组合框列表框

请参阅

组合框 , _ D B L C L I C K , 列表框

I N D B C 函数

如果指定的数据库对象在当前数据库中则返回真 T 否则返回假 F

语法

I N D B C (c D a t a b a s e O b j e c t N a m e, c T y p e )返值类型

逻辑值

参数描述

c D a t a b a s e O b j e c t N a m e指定一个命名连接字段索引表或者 S Q L 视图的名称 I N D B C 函数将据此返回一个逻辑值表明该对象是否存在于当前数据库中

9 0

c T y p e指定 c D a t a b a s e O b j e c t N a m e 的数据库对象类型下表列出了 c T y p e 可能的取

值和相应的数据库对象类型

c T y p e 数据库对象类型

C O N N E C T I O N 命名连接

F I E L D 字段

I N D E X 索引

T A B L E 表

V I E W S Q L 视图

C O N N E C T I O N F I E L D I N D E X T A B L E 和 V I E W 不能简写

说明

执行 I N D B C 函数时必须打开一个数据库并把它设置为当前数据库否则

V i s u a l F o x P r o 会产生错误信息

示例

下面示例中创建一个名为 m y d b c 的临时数据库并把名为 m y t a b l e 的临时表添加到

这个数据库中然后用 I N D B C 函数来检查这个新创建的表是否在该数据库中

最后关闭所创建的数据库和表并删除它们C L O S E D A T A B A S E SC R E A T E D A T A B A S E m y d b c & & 创建一个新数据库C R E A T E T A B L E m y t a b l e ( f i e l d 1 C ( 1 0 ) ) & & 自动添加到数据库中

? ' M y T a b l e i n t h e d a t a b a s e ? '? ? ' m y t a b l e ' , ' T A B L E ' & & 返值类型 . T .

9 1

C L O S E D A T A B A S E SD E L E T E D A T A B A S E m y d b c D E L E T E T A B L E S

请参阅

A D B O B J E C T S , C R E A T E D A T A B A S E , D E L E T E D A T A B A S E , O P E ND A T A B A S E , S E T D A T A B A S E

_ I N D E N T 系统变量

使每段的第一行产生缩进包含此变量是为了提供向后兼容性可以用报表设计器代

替

I N D E X 命令

创建一个索引文件利用该文件可以按某种逻辑顺序显示和访问表记录

语法

9 2

I N D E X O N e E x p r e s s i o n T O ID X F i l e N a m e | T A G T a g N a m e [ O FC D X F i l e N a m e ]

[ F O R l E x p r e s s i o n ][ C O M P A C T ][ A S C E N D I N G | D E S C E N D I N G ][ U N I Q U E | C A N D I D A T E ][ A D D I T I V E ]

参数描述

e E x p r e s s i o n指定一个索引表达式该表达式中可以包含当前表中的字段名在索引文件

中按索引表达式给每个表记录都创建一个索引关键字 V i s u a l F o x P r o 使用

这些关键字来显示和访问表中的记录

注意尽管不提倡事实上 e E x p e s s i o n 也可以是一个变量数组元素或者其他工

作区中表的字段或字段表达式备注字段不能单独用于索引文件表达式

中它们必须与其他的字符表达式结合起来如果索引中包含的变量或字

段不存在或不能定位 V i s u a l F o x P r o 会产生错误信息

如果索引表达式中的字段以表别名或工作区字母开头 V i s u a l F o x P r o 会产生错

误信息虽然在包含别名字段的情况下可以用 R u s h m o r e 技术优化 F O R子句但在创建索引时最好避免使用别名字段在有些情况下

U S E . . . A G A I N S Q L 查询等等 V i s u a l F o x P r o 会自动给表指定一个

不同的别名这时可能不能正确更新或使用索引

9 3

有关 R u s h m o r e 技术的详细内容请参阅 M i c r o s o f t V i s u a l F o x P r o 6 . 0 中文版程

序员指南第十五章理解 R u s h m o r e 技术

如果要建立一个具有可变长度关键字的索引关键字会被空格填充 V i s u a l F o x P r o 不

支持可变长度的索引关键字

索引关键字的长度可以为 0 例如当索引表达式是空备注字段的一个子字符串时所

创建的索引关键字长度就为 0 当 V i s u a l F o x P r o 创建索引时它检验表中第一个记录

的字段如有一个字段为空可能需要向第一个记录中这样的字段内填入一些临时数

据以免产生长度为 0 的索引关键字

. i d x 索引的索引关键字长度必须在 1 到 1 0 0 个字符间

.c d x 索引的索引关键字长度必须在 1 到 2 4 0 个字符间

T O ID X F i l e N a m e创建 . I D X 索引文件索引文件的默认扩展名为 . I D X 可以使用一个与之不

同的扩展名也可以在 V i s u a l F o x P r o 配置文件内改变索引文件的这个默认扩

展名创建索引文件时必须遵循标准 W i n d o w s 的文件命名规则

T A G T a g N a m e [ O F C D X F i l e N a m e]创建一个复合索引文件复合索引文件是一种可包含任意数量的独立标识

索引项的单个索引文件每一个标识都由其唯一标识名确定标识名必

须以字母或下划线开头最多可由 1 0 个字母数字或下划线组成

复合索引文件中的标识数目仅受可用内存和磁盘空间的限制

多项复合索引文件一般是压缩的创建复合索引文件时不必包含 C O M P A C T 复合索

引文件的扩展名为 . C D X

9 4

可创建的复合索引文件有两种类型结构复合索引文件和非结构复合索引文件

在 T A G T a g N a m e 参数中不包含可选的 O F C D X F i l e N a m e 子句便可以创建结构复合索

引文件结构复合索引文件的基本名不含扩展名的文件名总是与表的基本名相

同并且自动与表同时打开

如果一个表的复合索引文件不能被定位被删除或者已被重命名则在打开该表时会

显示一个对话框这时如果在对话框中选择默认的取消按钮则不打开表如选

择忽略按钮则打开该表并且删除表头中的标记表头可表明该表与结构复合

索引文件相关联

提示如果一个结构复合索引已经与它的表脱离关系则用下面的命令可以使它

重新和表相关联

U S E T a b l e N a m e I N D E X C D X F i l e N a m e

在 T A G T a g N a m e 参数之后包含 O F C D X F i l e N a m e 便可以创建非结构复合索引文件与结构复合索引不同的是必须明确使用 S E T I N D E X 命令或 U S E 命令中的 I N D E X 子句打开非结构复合索引文件

创建并打开一个复合索引文件之后执行带有 T A G T a g N a m e 参数的 I N D E X 命令可以

在该复合索引文件中添加一个标识

其中 C D X F i l e N a m e 是与表脱离关系的结构复合索引名如果结构复合索引与表脱离

关系以后对表进行了修改则需要重索引该表

F O R l E x p r e s s i o n指定一个条件只显示或访问满足这个条件表达式 l E x p r e s s i o n 的记录索引

文件只为那些满足条件表达式的记录创建索引关键字

如果 l E x p r e s s i o n 是一个可优化表达式 R u s h m o r e 将优化 I N D E X . . . F O R l E x p r e s s i o n 命

9 5

令要获取最佳性能请在 F O R 子句中使用可优化表达式

详细内容请参阅稍后的 S E T O P T I M I Z E 命令与 Microsoft Visual F o x P r o 6 . 0 中文版

程序员指南第十五章优化应用程序中的掌握 R u s h m o r e 技术

C O M P A C T使用 C O M P A C T 可以创建一个压缩的 . I D X 文件

A S C E N D I N G指定 . C D X 文件为升序在默认情况下按升序创建 . C D X 标识包含

A S C E N D I N G 参数可以将索引文件的排序方式明确指示出来类似地包

含 D E S C E N D I N G 可按降序索引一个表

D E S C E N D I N G指定 . C D X 文件为降序在创建 . I D X 文件时不能包含 D E S C E N D I N G 参数

但可以用 S E T I N D E X 或 S E T O R D E R 命令将 . I D X 索引文件指定为降序

U N I Q U E对于一个索引关键字值只有第一个满足该值的记录包含在 . I D X 文件

或 . C D X 标识中利用 U N IQ U E 子句可以避免显示或访问记录的重复值所

有添加到表中的记录如果与表中原有记录有重复的索引关键字值则不包

含在索引文件之内使用 I N D E X 命令的 U N I Q U E 选项与在执行 I N D E X或 R E I N D E X 命令之前执行 S E T U N I Q U E O N 命令完全等效

在 U N I Q U E 索引或索引标识处于激活状态时如果更改了一个有重复索引关键字值的

记录则同时需要更新索引或索引标识但在重新用 R E I N D E X 命令重索引该文件之

前仍然不能访问下一个有相同索引关键字值的记录

9 6

C A N D I D A T E创建候选结构索引标识只有在创建结构索引标识时才能包含关键字

C A N D I D A T E 否则 V i s u a l F o x P r o 会产生错误信息

使用候选索引标识可以避免索引表达式 e E x p r e s s i o n 指定的字段或字段组合有重复值

C a n d i d a t e 候选一词是指索引类型因为候选索引中不同的记录没有重复值所以

它们可以作为主索引的候选索引

如果一个字段或字段组合已包含重复值那么为它创建候选索引标识时 V i s u a l F o x P r o

会产生错误信息

有关候选与主索引标识的详细内容请参阅 Microsoft Visual F o x P r o 6 . 0 中文版程序

员指南第七章处理表中的设置主索引或候选索引

A D D I T I V E所有先前已打开的索引文件保持打开状态如省略 A D D I T I V E 子句则在用

I N D E X 命令创建索引文件或表时关闭所有先前已打开的索引文件结构复

合索引文件除外

说明

I n d e x 可用来在具有索引文件的表中按索引表达式所规定的顺序显示或访问记录但

并不会根据索引文件更改表的物理存储顺序

如果 S E T T A L K 设置成 O N 则在索引过程中 V i s u a l F o x P r o 会报告已建立索引的记

录数目索引过程中显示记录的计数器间隔可由 S E T O D O M E T E R 指定

使用 D I S P L A Y S T A T U S 命令可以显示打开的索引文件的许多内容其中包括所有打

开的索引文件的文件名类型结构非结构 . C D X . I D X 索引表达式排序序

列以及主控索引文件名或主控标识名

9 7

可以打开的索引文件 . C D X 或 . I D X 数目只受内存或系统资源的限制在 V i s u a l

F o x P r o F o x P r o f o r W i n d o w s 和 F o x P r o f o r M S - D O S 中能打开的文件总数目由 M S -

D O S 的配置文件 C O N F I G . S Y S 中的 F I L E S 设置决定有关 F I L E S 设置的详细内容

请参阅 M S - D O S 手册

索引类型 V i s u a l F o x P r o 允许创建两种类型的索引文件

• 包含多个索引标识项索引名的 . C D X 复合索引文件

• 包含一个索引项的 . I D X 单项索引文件

您也可以创建一个结构复合索引文件该文件同表一起自动打开

提示也可以创建结构复合索引文件这种索引文件在打开表时自动打开

因为结构复合索引文件随表的打开而自动打开所以这种类型比较常

用

包含 C O M P A C T 文件可创建压缩的 . I D X 索引文件而复合索引文件总是压缩的

在 V i s u a l F o x P r o 与 F o x B A S E + 中共享文件时应该使用非压缩的 . I D X 索引文件否

则在创建 . I D X 时应包含 C O M P A C T 子句以利用 V i s u a l F o x P r o 的 R u s h m o r e 技

术

索引的顺序与更新表的显示或访问顺序只由一个索引文件主控索引文件或标识

主控标识控制有一些命令如 S E E K 命令使用主控索引文件或标识搜索记

录但是在修改表时所有已打开的 . I D X 和 . C D X 索引文件都将被更新使用 U S E

命令的 I N D E X 子句或 S E T I N D E X 和 S E T O R D E R 命令可以指定主控索引文件或标

识

U s e r - D e f i n e d F u n c t i o n s 索引表达式中虽然可以包含用户自定义函数但最好不要这

9 8

样做因为索引表达式中使用用户自定义函数会增加创建或更新索引所需的时间另

外如果索引表达式中使用了用户自定义函数有可能不更新这个索引

如果索引表达式中使用了用户自定义函数则应该保证 V i s u a l F o x P r o 能够找到这个函

数当 V i s u a l F o x P r o 创建索引时索引表达式存储在索引文件中但用户自定义函数

并不存储在索引文件中索引文件中只保存指向用户自定义函数的引用

示例

示例 1 打开 c u s t o m e r 表创建一个名为 c o m p l i s t 的索引文件显示数值并且按

c o m p a n y 字段的字母顺序处理记录

示例 2 再次打开 c u s t o m e r 表并且根据 city 字段前五个字符和 c o m p a n y 字段前六个字

符的子字符串创建一个名为 c i t y c o m p 的索引文件当使用这个索引文件时表中的记

录主要根据 city 字段排序其次根据 c o m p a n y 字段排序

示例 3 创建了索引标识第一个标识是 a d d r e s s 字段的结构复合索引标识第二个标识

是在名为 c u s t c d x 的非结构索引文件中创建的* 示例 1C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' D a t a \ t e s t d a t a ' )U S E C u s t o m e r & & 打开 c u s t o m e r 表

c o m p a n y comp l i s tC L E A RD I S P L A Y S T A T U S

* 示例 2C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' D a t a \ t e s t d a t a ' )U S E C u s t o m e r & & 打开 c u s t o m e r 表

S U B S T R ( c i t y , 1 , 5 ) + S U B S T R ( c o m p a n y , 1 , 6 ) c i t y c o m p

9 9

C L E A RD I S P L A Y S T A T U S

* 示例 3C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' D a t a \ t e s t d a t a ' )U S E C u s t o m e r & & 打开 c u s t o m e r 表

a d d r e s s a d d r e s s c o m p a n y c o m p a n y c u s t c d x

C L E A RD I S P L A Y S T A T U S

请参阅

A L T E R T A B L E , C D X , C O P Y I N D E X E S , C O P Y T A G , D E L E T E T A G ,

F O R , I N D E X S E E K , K E Y , M D X , N D X , O R D E R ,

R E I N D E X , S E T C O L L A T E , SET I N D E X , S E T O D O M E T E R , S E T O R D E R ,

S E T T A L K , S E T U N I Q U E , S O R T , S Y S ( 1 4 ) , S Y S ( 2 1 ) , S Y S ( 2 2 ) , S Y S ( 2 0 2 1 ) ,

T A G , T A G C O U N T , U S E

返回总目录I N D E X S E E K 函数

I n d e x T o I t e m I D 方法

I n i t 事件

I n i t i a l S e l e c t e d A l i a s 属性

I N K E Y 函数

I N L I S T 函数

I N P U T 命令

I n p u t M a s k 属性

I N S E R T 命令

I N S E R T – S Q L 命令

I N S M O D E 函数

I n s t a n c i n g 属性

I N T 函数

I n t e g r a l H e i g h t 属性

I n t e r a c t i v e C h a n g e 事件

I n t e r v a l 属性

I S A L P H A 函数

I S B L A N K 函数

I S C O L O R 函数

I S D I G I T 函数

I S E X C L U S I V E 函数

I S F L O C K E D 函数

I S H O S T E D 函数

I S L E A D B Y T E 函数

I S L O W E R 函数

I S M O U S E 函数

I S N U L L 函数

I S R E A D O N L Y 函数

I S R L O C K E D 函数

I S U P P E R 函数

I t e m 方法

I t e m B a c k C o l o r , I t e m F o r e C o l o r 属性

I t e m D a t a 属性

I t e m I D D a t a 属性

I t e m I D T o I n d e x 方法

I t e m T i p s 属性

J O I N 命令

J U S T D R I V E 函数

J U S T E X T 函数

J U S T F N A M E 函数

J U S T P A T H 函数

J U S T S T E M 函数

K E Y 函数

K E Y B O A R D 命令

K e y b o a r d H i g h V a l u e , K e y b o a r d L o w V a l u e 属性

K E Y M A T C H 函数

K e y P r e s s 事件

K e y P r e v i e w 属性

L A B E L 命令

L a b e l 控件

L A S T K E Y 函数

L a s t M o d i f i e d 属性

L e f t 属性

L E F T 函数

L E F T C 函数

L e f t C o l u m n 属性

L E N 函数

L E N C 函数

L I K E 函数

L I K E C 函数

L i n e 控件

L i n e 方法

I N D E X S E E K 函数

在一个索引表中搜索第一次出现的某个记录该记录的索引关键字与指定的表达式匹

配可以不移动记录指针

语法

I N D E X S E E K (e E x p r e s s i o n [ , lM o v e P o i n t e r [ , n W o r k A r e a | c T a b l e A l i a s[ , n I n d e x N u m b e r | c I D X I n d e x F i l e N a m e | c T a g N a m e ] ] ] )

返值类型

逻辑值

参数描述

e E x p r e s s i o n指定索引关键字表达式您需要 I N D E X S E E K 搜索这个表达式

lM o v e P o i n t e r指定是否将记录指针移动到匹配记录如果 l M o v e P o i n t e r 为真 ( .T . ) 并

且匹配记录存在则将记录指针移动到该匹配记录如果 lM o v e P o i n t e r 为真 ( .T . ) 而匹配记录不存在则不移动记录指针如果 lM o v e P o i n t e r 为假 ( . F . ) 或省略则即使匹配记录存在也不移动记录指针

n W o r k A r e a指定表的工作区编号在该表中搜索索引关键字

c T a b l e A l i a s指定该表的别名如果省略 n W o r k A r e a 和 c T a b l e A l i a s 则搜索当前选中工

作区中的表

n I n d e x N u m b e r指定索引文件或标识的编号用于搜索索引关键字 n I n d e x N u m b e r 引用

U S E 或 S E T I N D E X 命令中列出的索引文件在 U S E 或 S E T I N D E X 命令中

打开的 . ID X 文件列为第一个在结构 . c d x 文件如果存在中的标识是按

创建顺序编号的最后任何打开的独立 . c d x 文件中的标识是按创建顺序编

号的有关索引编号的详细信息请参阅 S E T O R D E Rc I D X I n d e x F i l e N a m e

指定用于搜索索引关键字的一个 . i d x 文件

c T a g N a m e指定一个 . c d x 文件的标识该文件用于搜索索引关键字标识名可以来自一

个结构 . c d x 文件或任何打开的独立 . c d x 文件

注意如果 .c d x 文件和标识名重名则优先使用 . c d x 文件

说明

如果匹配记录找到了则 I N D E X S E E K 返回真 ( .T . ) 否则返回假 ( .F.)

只能将 I N D E X S E E K 用于索引排序设置的表而且只能搜索一个索引关键字除

非 S E T E X A C T 设置为 O F F 否则匹配必须严格

I N D E X S E E K 可以在不移动记录指针的情况下快速搜索一个记录由于不移动记

录指针就不执行规则和触发器如果 I N D E X S E E K 返回真 ( .T . ) 则表明找

到了一个匹配记录可以再次使用 I N D E X S E E K ( ) 并且将第二个参数

lM o v e P o i n t e r 设置为真 ( .T . ) 以便将记录指针移动到匹配记录

请参阅

I N D E X , K E Y M A T C H ( ) , L O C A T E , S E E K , SEEK( )

I n d e x T o I t e m I D 方法

返回一个指定项的 I D 号

语法

[n I t e m I D = ] C o n t r o l. I n d e x T o I t e m I D (n I n d e x)参数描述

n I t e m I D指定唯一标识号

n I n d e x指定编号该编号代表在控件中显示对象的位置

说明

每一个添加到组合框或列表框中的项都有两个标识号

• n I t e m I D 唯一的标识编号

• n I n d e x 一个整数对应于控件中显示项的排列位置列表中的第一个项对

应于 n I n d e x = 1在对象刚添加到控件中时这两个编号是相同的但随着对象的排序删除和添加

它们就不一定再相等了

如果知道控件中一个特定项的 n I n d e x 号时可使用 I n d e x T o I t e m I D 方法返回它的

nI t emID 号

应用于

组合框列表框

请参阅

A d d I t e m 方法 , A d d L i s t I t e m 方法 , I t e m I D T o I n d e x 方法

In i t 事件

在创建对象时发生

语法

P R O C E D U R E O b j e c t. In i t[ L P A R A M E T E R S P a r a m 1 , P a r a m 2 , . . . ]参数描述

P a r a m 1 , P a r a m 2 . . .参数是可选的但是如果传递参数就必须用 L P A R A M E T E R S 或

P A R A M E T E R S 语句列出每一个参数否则 V i s u a l F o x P r o 将产生错误信息

说明

对于表单集和其他容器对象来说容器中对象的 In i t 事件在容器的 In i t 事件之前触

发因此容器的 In i t 事件可以访问容器中的对象容器中对象的 In i t 事件的发生顺序

与它们添加到容器中的顺序相同

如果不创建控件或 A c t i v e D o c u m e n t 可在 In i t 事件中返回假 . F . 这时不触发

D e s t r o y 事件例如下面的代码在 I n v o i c e 表不存在时返回假 . F .P R O C E D U R E I N I T

I F N O T F I L E ( " I N V O I C E . D B F " )ERROR ' I n i t i a l i za t i on Fa i l ed : F i l e no t f ound 'R E T U R N . F .E L S EU S E I N V O I C E I N 0 A G A I NT H I S . W o r k A r e a = S E L E C T ( )E N D I F

E N D P R O C

应用于

A c t i v e D o c 对象复选框组合框命令按钮命令组容器对象控件对象临时

表自定义控件数据环境编辑框表单表单集表格图像标签线条列

表框 O L E 绑定型控件 O L E 容器控件选项按钮选项组页面页框

P r o j e c t H o o k 对象关系形状微调文本框计时器工具栏

请参阅

A d d O b j e c t 方法 , CREATEOBJECT( ) , L o a d 事件

In i t i a lSe l ec t edAl i a s 属性

在加载数据环境时指定一个与临时表对象相关联的别名作为当前别名

与 S E L E C T 语句的执行方式相似

语法

D a t a E n v i r o n m e n t . I n i t i a l S e l e c t e d A l i a s [ = c T e x t]设置

c T e x t指定一个与临时表对象相关联的别名

说明

与 S E L E C T 语句的执行方式相似

应用于

数据环境

请参阅

A l ias 属性 , S E L E C T

I N K E Y 函数

返回一个编号该编号对应于键盘缓冲区中第一个鼠标单击或按键操作

语法

I N K E Y ( [ n S e c o n d s ] [ , c H i d e C u r s o r ] )返值类型

数值型

参数描述

n S e c o n d s以秒为单位指定 I N K E Y 函数对键击的等待时间如果不包含

n S e c o n d s I N K E Y 函数立即返回一次键击的值如果 n S e c o n d s 为 0I N K E Y 函数一直等待到有键击为止

c H i d e C u r s o r显示或隐藏光标或者检查鼠标单击若要显示光标请在 c H i d e C u r s o r 中包含 S 若要隐藏光标请在 c H i d e C u r s o r 中包含 H 如果既包含 S 又包含

H 则使用后一个字符的设置

默认时 I N K E Y 函数不检查鼠标单击如果要检查鼠标单击可在

c H i d e C u r s o r 中包含 M 若在 c H i d e C u r s o r 中包含了 M 则 I N K E Y 函数

返回 1 5 1 表示一次鼠标单击

如果既要检查鼠标单击又要显示光标可在 c H i d e C u r s o r 中包含 M 和 S 若要检查鼠标

单击并且隐藏光标可包含 M 和 H

当为一个键或组合键指定了键盘宏时在 c H i d e C u r s o r 中包含 E 可以扩展键盘宏包含

E 时 I N K E Y 函数将返回指定给键盘宏的第一个键击所对应的值重复执行包含 E

的 I N K E Y 函数可返回后续键击所对应的值如省略 E I N K E Y 函数将返回

触发键盘宏的键或组合键本身的对应值在 c H i d e C u r s o r 中除了 H M S 和 E 之外

的其他字符都被忽略 .

下表列出了单键以及单键与 S H I F T C T R L 和 A L T 键组合时 I N K E Y 函数的返回值

破折号 ( ) 表示组合键没有返回值

键名单键 S H I F T C T R L A L T

F 1 2 8 8 4 9 4 1 0 4

F 2 – 1 8 5 9 5 1 0 5

F 3 – 2 8 6 9 6 1 0 6

F 4 – 3 8 7 9 7 1 0 7

F 5 – 4 8 8 9 8 1 0 8

F 6 – 5 8 9 9 9 1 0 9

F 7 – 6 9 0 1 0 0 1 1 0

F 8 – 7 9 1 1 0 1 1 1 1

F 9 – 8 9 2 1 0 2 1 1 2

续表

F 1 0 – 9 9 3 1 0 3 1 1 3

F 1 1 1 3 3 1 3 5 1 3 7 1 3 9

F 1 2 1 3 4 1 3 6 1 3 8 1 4 0

1 4 9 3 3 – 1 2 0

2 5 0 6 4 – 1 2 1

3 5 1 3 5 – 1 2 2

4 5 2 3 6 – 1 2 3

5 5 3 3 7 – 1 2 4

6 5 4 9 4 – 1 2 5

7 5 5 3 8 – 1 2 6

8 5 6 4 2 – 1 2 7

9 5 7 4 0 – 1 2 8

0 4 8 4 1 – 1 9

a 9 7 6 5 1 3 0

b 9 8 6 6 2 4 8

c 9 9 6 7 3 4 6

d 1 0 0 6 8 4 3 2

e 1 0 1 6 9 5 1 8

f 1 0 2 7 0 6 3 3

g 1 0 3 7 1 7 3 4

h 1 0 4 7 2 1 2 7 3 5

续表

I 1 0 5 7 3 9 2 3

j 1 0 6 7 4 1 0 3 6

k 1 0 7 7 5 1 1 3 7

l 1 0 8 7 6 1 2 3 8

m 1 0 9 7 7 1 3 5 0

n 1 1 0 7 8 1 4 4 9

o 1 1 1 7 9 1 5 2 4

p 1 1 2 8 0 1 6 2 5

q 1 1 3 8 1 1 7 1 6

r 1 1 4 8 2 1 8 1 9

s 1 1 5 8 3 1 9 3 1

t 1 1 6 8 4 2 0 2 0

u 1 1 7 8 5 2 1 2 2

v 1 1 8 8 6 2 2 4 7

w 1 1 9 8 7 2 3 1 7

x 1 2 0 8 8 2 4 4 5

y 1 2 1 8 9 2 5 2 1

z 1 2 2 9 0 2 6 4 4

I N S 2 2 2 2 1 4 6 1 6 2

H O M E 1 5 5 2 9 1 5 1

D E L 7 7 1 4 7 1 6 3

续表

E N D 6 4 9 2 3 1 5 9

P A G E U P 1 8 5 7 3 1 1 5 3

P A G E

D O W N

3 5 1 3 0 1 6 1

上箭头 5 5 6 1 4 1 1 5 2

下箭头 2 4 5 0 1 4 5 1 6 0

右箭头 4 5 4 2 1 5 7

左箭头 1 9 5 2 2 6 1 5 5

E S C 2 7 – /27 – * / 2 7 – */1

E N T E R 1 3 1 3 1 0 – / 1 6 6

B A C K S P A C E 1 2 7 1 2 7 1 2 7 1 4

空格键 9 1 5 148/* *

S P A C E B A

R

3 2 3 2 3 2 /– 5 7

* W i n d o w s 保留的键

说明

如果没有按下键则 I N K E Y 函数返回 0 如果键盘缓冲区中有多个键 I N K E Y

函数只返回第一个输入到缓冲区的键的值

请参阅

_ D B L C L I C K , K E Y B O A R D , K e y P r e s s 事件 , LASTKEY( ) , O N K E Y ,

READKEY( ) , S E T T Y P E A H E A D

I N L I S T 函数

判断一个表达式是否与一组表达式中的某个匹配

语法

I N L I S T (e E x p r e s s i o n 1 , e E x p r e s s i o n 2 [ , e E x p r e s s i o n 3 . . . ] )返值类型

逻辑型或 nu l l 值

参数描述

e E x p r e s s i o n 1指定 I N L I S T 函数要在表达式组中搜索的表达式

e E x p r e s s i o n 2 [ , e E x p r e s s i o n 3 . . . ]指定要搜索的表达式组表达式组中必须至少包含一个表达式

( e E x p r e s s i o n 2 ) 最多可包含 2 4 个

表达式组中的所有表达式必须具有相同的数据类型

说明

如 I N L I S T 函数在表达式组中找到了要搜索的表达式就返回真 . T . 否

则返回假 . F . 如果 e E x p r e s s i o n 1 为 nu l l 值则 I N L I S T 函数返回 nu l l

值如果 e E x p r e s s i o n 1 与表达式组中的任何表达式都不匹配或者表达式组中有一个

表达式为 nu l l 值 I N L I S T 函数也返回 nu l l 值

示例

本示例中 I N L I S T 判断当前月份在一年中属于哪个季度当前月存储在变量

g c M o n t h 中每个 E A C H 子句用 I N L I S T 来判断 g c M o n t h 的内容是否能在月份名

称的列表中找到返回的季度名称存储在变量 g c R e p o r T i t l e 中S E T T A L K O NS T O R E C M O N T H ( D A T E ( ) ) T O g c M o n t hD O C A S E

C A S E I N L I S T (gcMon th , ' Janua ry ' , ' Feb rua ry ' , 'Ma rch ' )S T O R E ' F i r s t Q u a r t e r ' T O g c R e p o r T i t l e

C A S E I N L I S T (gcMon th , 'Ap r i l ' , 'May ' , ' June ')S T O R E ' S e c o n d Q u a r t e r ' T O g c R e p o r T i t l e

C A S E I N L I S T (g c M o n t h , ' J u l y ' , ' A u g u s t ' , ' S e p t e m b e r ')S T O R E ' T h i r d Q u a r t e r ' T O g c R e p o r T i t l e

O T H E R W I S ES T O R E ' F o u r t h Q u a r t e r ' T O g c R e p o r T i t l e

E N D C A S EW A I T W I N D O W g c R e p o r T i t l e

请参阅

B E T W E E N ( )

I N P U T 命令

包含此项是为了提供向后兼容性请使用文本框控件

I n p u t M a s k 属性

指定控件中数据的输入格式和显示方式设计和运行时有效

语法

C o n t r o l . I n p u t M a s k [ = c M a s k ]设置

c M a s k下表列出了对 I n p u t M a s k 属性的设置

设置说明

X 可输入任何字符

9 可输入数字和正负符号如负号 ( – )

# 可输入数字空格和正负符号

续表

$ 在某一固定位置显示由 S E T C U R R E N C Y 命令指定的当前货币符

号

$ $ 在微调控件或文本框中货币符号显示时不与数字分开

* 在值的左侧显示星号

. 句点分隔符指定小数点的位置

, 逗号可以用来分隔小数点左边的整数部分

说明

设计和运行时可用该属性与 F o r m a t 恰恰相反 F o r m a t 指定整个输入字段的输入方

式可以同时用几种 F o r m a t 代码它们都影响整个输入字段

应用于

列 ,组合框微调文本框

请参阅

D y n a m i c I n p u t M a s k 属性 , F o r m a t 属性

I N S E R T 命令

在当前表中插入新记录包含此命令是为了提供向后兼容性可以使用 A P P E N D 或

I N S E R T - S Q L 命令代替

I N S E R T – S Q L 命令

在表尾追加一个包含指定字段值的记录

语法

I N S E R T I N T O d b f _ n a m e [ ( f n a m e 1 [ , f n a m e 2 , . . . ] ) ]V A L U E S ( e E x p r e s s i o n 1 [ , e E x p r e s s i o n 2 , . . . ])

–或者 –

I N S E R T I N T O d b f _ n a m e F R O M A R R A Y A r r a y N a m e | F R O M M E M V A R参数描述

I N S E R T I N T O d b f _ n a m e指定要追加记录的表名 d b f _ n a m e 中可以包含路径也可以是一个名称表达

式

如果指定的表没有打开则 V i s u a l F o x P r o 先在一个新工作区中以独占方式打开该表

然后再把新记录追加到表中此时并未选定这个新工作区选定的仍然是当前工作

区

如果所指定的表是打开的 I N S E R T 命令就把新记录追加到这个表中如果表不是在当

前工作区打开的则追加记录后表所在的工作区仍然不是选定工作区选定的仍然是

当前工作区

[ ( f n a m e 1 [ , f n a m e 2 [ , . . . ] ] ) ]指定新记录的字段名 I N S E R T - S Q L 命令将向这些字段中插入字段值

V A L U E S ( e E x p r e s s i o n 1 [ , e E x p r e s s i o n 2 [ , . . . ] ] )新插入记录的字段值如果省略了字段名那么必须按照表结构定义字段的

顺序来指定字段值如果 S E T N U L L 的值为 O N I N S E R T – S Q L 会试图将

n u l l 值插入在 V A L U E S 子句中没有指定的任意字段中

F R O M A R R A Y A r r a y N a m e指定一个数组数组中的数据将被插入到新记录中从第一个数组元素开

始数组中的每个元素的内容依次插入到记录的对应字段中第一个数组元

素的内容插入到新记录的第一个字段第二个元素的内容插入到第二个字

段依此类推

当包含 F R O M A R R A Y 子句时会忽略字段的任何默认值

F R O M M E M V A R把变量的内容插入到与它同名的字段中如果某一字段不存在同名的变量

则该字段为空

说明

新记录中包含了 V A L U E 子句列出的值或包含指定的数组或变量中的值插入新记

录后记录指针指向新记录

示例

下面的示例打开了 e m p l o y e e 表并添加一个记录U S E e m p l o y e e

I N S E R T I N T O e m p l o y e e ( e m p _ n o , f n a m e , l n a m e , o f f i c e n o ) ;V A L U E S ( 3 0 2 2 , " J o h n " , " S m i t h " , 2 1 0 1 )

下面的示例打开了数据库 t e s tda ta 中的 c u s t o m e r 表当前记录的内容分散到变量中

并且表的结构被复制到新表 cus t2 中可用 I N S E R T – S Q L 在表 cus t2 中插入新记录

也可以发出 B R O W S E 来显示新记录C L O S E D A T A B A S E SC L E A R

O P E N D A T A B A S E ( H O M E ( 2 ) + ' D a t a \ t e s t d a t a ' )U S E C u s t o m e r & & 打开 c u s t o m e r 表*把当前记录存入内存变量中S C A T T E R M E M V A R

* 把当前表的结构复制到 E X A M P L E 表中C O P Y S T R U C T U R E T O c u s t 2

* 从内存变量中插入记录I N S E R T I N T O c u s t 2 F R O M M E M V A R

S E L E C T C U S T 2B R O W S E

* 关闭并删除 E X A M P L E 表U S ED E L E T E F I L E c u s t 2 . d b f

请参阅

C R E A T E Q U E R Y , C R E A T E T A B L E – S Q L , M O D I F Y Q U E R Y , S E L E C T –

S Q L

I N S M O D E 函数

返回当前的插入方式或者把插入方式设置成 O N 或 O F F

语法

I N S M O D E ( [ l E x p r e s s i o n ] )返值类型

逻辑值

参数描述

l E x p r e s s i o n把插入方式设置成 O N 或 O F F I N S M O D E ( . T . ) 将插入方式设置成 O NI N S M O D E ( . F . ) 将插入方式设置成 O F F 返回的逻辑值表示在执行

I N S M O D E ( . T . ) 或 I N S M O D E ( . F . ) 之前的插入方式

说明

省略可选参数时如果插入方式处于 O N 状态在光标前面插入字符则

I N S M O D E 函数返回真 ( .T . ) 如果插入方式处于 O F F 状态改写光标所在位

置的字符则 I N S M O D E 函数返回假 ( .F.)

示例

下面的示例利用 I N S M O D E 函数把插入方式设置成 O N 然后再把插入方式切换成

相反的状态S E T T A L K O N= I N S M O D E ( . T .) & & 把插入方式置为 O N? I N S M O D E ( )= I N S M O D E ( ! I N S M O D E ( ) ) & & 把插入方式切换到相反的状态? I N S M O D E ( )

请参阅

C A P S L O C K ( ) , NUMLOCK( )

I n s t a n c i n g 属性

指定项目中的一个服务程序如何被实例化设计和运行时可用

语法

O b j e c t. I n s t a n c i n g [ = n E x p r e s s i o n ]设置

n E x p r e s s i o n指定如何实例化一个服务程序下表列出了 n E x p r e s s i o n 的值以及每个值

的说明

设置 F o x P r o . h 常数说明

1 S E R V E R I N S T A N C E _ S I N G L E U S E 默认值允许您在 V i s u a l

F o x P r o 内外使用 O L E 自动服务

创建该类的一个实例项目之

外的一个自动服务客户程序对

该类一个实例的每一个请求都

会启动自动服务程序的一个独

立副本

2 S E R V E R I N S T A N C E _ N O T C R E A T

A B L E

只允许您在 V i s u a l F o x P r o 内创

建该类的一个实例

3 S E R V E R I N S T A N C E _ M U L T I U S E 允许您在 V i s u a l F o x P r o 内外使

用 O L E 自动服务创建该类的一

个实例

项目之外的一个自动服务客户

程序对该类一个实例的每一个

请求会使自动服务程序的一个

已经运行的副本成为新实例的

源

应用于

服务程序对象

请参阅

G E T O B J E C T ( ) , S e r v e r C l a s s 属性 , S e r v e r C l a s s L i b r a r y 属性

I N T 函数

计算一个数值表达式的值并返回其整数部分

语法

I N T (n E x p r e s s i o n )返值类型

数值型

参数描述

n E x p r e s s i o n指定 I N T 计算的数值表达式

示例

C L E A R? I N T (12 .5 ) & & 显示数值 1 2? I N T (6 .25 * 2 ) & & 显示数值 1 2? I N T (-12 .5 ) & & 显示数值 - 1 2S T O R E - 1 2 . 5 T O g n N u m b e r? I N T (g n N u m b e r ) & & 显示数值 - 1 2

请参阅

C E I L I N G ( ) , FLOOR( ) , ROUND( )

I n t e g r a l H e i g h t 属性

指定是否自动调整编辑框或列表框控件的高度这样可以正确显示控件中的最后一

项指定是否自动调整文本框控件的高度以显示一行文本设计时可用运行时只

读

语法

O b j e c t. I n t e g r a l H e i g h t [ = l E x p r]参数描述

l E x p r取下列一个值

l E x p r 说明

真

( .T . )

自动调整编辑框或列表框控件的高度这样可以正确显示控件中

的最后一项自动调整文本框控件的高度以显示一行文本

假

( .F.)

默认值编辑框或列表框的高度不可调不可以正确显示控件的

最后一项不可以自动调整文本框控件的高度以显示一行文

本

说明

如果编辑框或列表框控件的高度不合适则控件中的最后一行文字会只显示一部分

将 I n t e r g r a l H e i g h t 设置为真 ( .T . ) 可以自动调整控件的高度这样可以正确显示

控件中的最后一项

对于一个文本框将 I n t e r g r a l H e i g h t 设置为真 ( .T . ) 可以保证当控件的 F o n t S i z e 属

性改变时该控件能自动调整自己的高度

当 I n t e g r a l H e i g h t 属性设置为真 ( .T.) 时 H e i g h t 属性的值可能与控件的真实高度

不符

应用于

编辑框列表框文本框

请参阅

H e i g h t 属性

I n t e r a c t i v e C h a n g e 事件

在使用键盘或鼠标更改控件的值时该事件发生

语法

P R O C E D U R E C o n t r o l . I n t e r a c t i v e C h a n g e

[ L P A R A M E T E R S n I n d e x ]参数描述

n I n d e x对于控件数组中的控件指定唯一标识号

说明

在每次交互地更改对象时都要发生该事件例如当用户在文本框中键入字符时

每一次击键都会触发 I n t e r a c t i v e C h a n g e 事件

应用于

复选框组合框命令组编辑框列表框选项组微调文本框

请参阅

C l i c k 事件

In t e rva l 属性

指定计时器控件的 T i m e r 事件之间的时间间隔毫秒数设计和运行时可用

语法

T i m e r . I n t e r v a l [ = n T i m e ]参数描述

n T i m e指定 T i m e r 事件之间的间隔毫秒数默认为 0 不触发 T i m e r 事件

说明

有关 i n t e rva l 属性的详细内容请参阅 Microsoft Visual F o x P r o 6 . 0 中文版程序员指

南的第十章使用控件中的计时器控件的初始化

应用于

计时器

请参阅

R e s e t 方法 , T i m e r 事件

I S A L P H A 函数

判断字符表达式的最左边一个字符是否为字母

语法

I S A L P H A (c E x p r e s s i o n )返值类型

逻辑值

参数描述

c E x p r e s s i o nI S A L P H A 函数所要判断的字符表达式 c E x p r e s s i o n 中第一个字符之后的

所有字符都将被忽略

说明

如果字符表达式的第一个字符是字母 I S A L P H A 函数将返回真 (.T . ) 否则

返回假 ( .F.)

示例

C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' D a t a \ t e s t d a t a ' )U S E C u s t o m e r & & 打开 c u s t o m e r 表C L E A R

D I S P L A Y c o n t a c t? I S A L P H A (c o n t a c t) & & 显示 . T .D I S P L A Y m a x o r d a m t? I S A L P H A (cus t_ id ) & & 显示 . F .

请参阅

I S L O W E R ( ) , ISUPPER( ) , LOWER( ) , UPPER( )

I S B L A N K 函数

判断表达式是否为空值

语法

I S B L A N K (e E x p r e s s i o n )返值类型

逻辑值

参数描述

e E x p r e s s i o nI S B L A N K 要判断的表达式 e E x p r e s s i o n 可以是表中的一个字段一个

变量或数组元素也可以是一个表达式

对一个字段来说如果该字段包含下述值则 I S B L A N K 函数将返回真 (.T . )

类型内容

字符型空字符串空格或无值新追加的空记录或用 B L A N K 命令清除

后的记录

数值型无值新追加的空记录或用 B L A N K 命令清除后的记录

浮点型无值新追加的空记录或用 B L A N K 命令清除后的记录

日期型空日期时间 { / / : : } 或无值新追加的空记录或用 B L A N K

命令清除后的记录

续表

日期时间型空日期时间 { / / : : } 或无值新追加的空记录或用 B L A N K

命令清除后的记录

逻辑型无值新追加的空记录或用 B L A N K 命令清除后的记录

备注型空无备注内容

通用型空无 O L E 对象

图片空无图片

说明

如果表达式 e E x p r e s s i o n 为空值则 I S B L A N K 函数返回真 ( .T.) 否则返回

假 ( .F.)

A P P E N D B L A N K 和 B L A N K 命令可用来创建空记录 B L A N K 命令还可以用来清除一

个记录内某些字段中的数据用 I S B L A N K 函数则可以判断一个字段是否为空

值

附注货币型整型双精度型表达式永远不可能为空值因而对这些表达式

I S B L A N K 函数总是返回假 (.F.)

I S B L A N K 函数与 E M P T Y 和 I S N U L L 函数不同例如当字符表达式是

nu l l 值空格 T a b 字符回车换行符的某种组合时 E M P T Y 函数将返回

真 ( .T . ) 但只有字符表达式中仅包含空字符串或空格时 I S B L A N K 函数才返

回真 ( .T . )

示例

下面的示例创建了表 m y t a b l e 并追加了一个空白记录 I S B L A N K 返值类型 t r ue

( .T. ) 因为 m y f i e l d 为空在 m y f i e l d 中放置值 , 并且 I S B L A N K 返值类型 f a l se

( .F . ) 因为 m y f i e l d 不再为空C R E A T E T A B L E m y t a b l e F R E E ( m y f i e l d C ( 2 0 ) )A P P E N D B L A N K & & 添加新的空记录C L E A R

? I S B L A N K ( m y f i e l d ) & & 显示 . T .R E P L A C E m y f i e l d W I T H ' J o h n S m i t h ' & & 在字段中插入一个值? I S B L A N K (myf ie ld ) & & 显示 . F .

请参阅

A P P E N D , B L A N K , E M P T Y ( ) , ISNULL( ) , L E N ( )

I S C O L O R 函数

判断当前计算机能否显示彩色

语法

ISCOLOR( )返值类型

逻辑值

说明

如果当前计算机具有彩色显示能力不管当前所用的是否为彩色监视器 I S C O L O R

函数将返回真 (.T . ) 如果当前计算机不支持彩色显示 I S C O L O R 函数将

返回假 ( .F.)

请参阅

颜色概览 , S E T D I S P L A Y , S Y S ( 2 0 0 6 )

I S D I G I T 函数

判断字符表达式的最左边一个字符是否为数字 0 到 9

语法

I S D I G I T (c E x p r e s s i o n )返值类型

逻辑值

参数描述

c E x p r e s s i o n指定 I S D I G I T 函数要判断的字符表达式 c E x p r e s s i o n 中第一个字符之后

的所有字符都被忽略

说明

如果字符表达式的最左边一个字符是数字 0 到 9 则 I S D I G I T 函数返回真

( .T . ) 否则 I S D I G I T 函数返回假 ( .F.)

示例

C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' D a t a \ t e s t d a t a ' )U S E o r d e r s & & 打开 O r d e r s 表C L E A R

D I S P L A Y c u s t _ i d? I S D I G I T (cus t_ id ) & & 显示 . F .D I S P L A Y o r d e r _ d s c? I S D I G I T (A L L T R I M ( S T R ( o r d e r _ d s c ) ) ) & & 显示 . T .

请参阅

I S A L P H A ( )

I S E X C L U S I V E 函数

如果一个表或数据库是以独占方式打开的则返回真 ( .T . ) 否则返回假

( .F.)

语法

I S E X C L U S I V E ( [ c T a b l e A l i a s | n W o r k A r e a | c D a t a b a s e N a m e [ , n T y p e ] ] )返值类型

逻辑值

参数描述

c T a b l e A l i a s指定的表别名 I S E X C L U S I V E 函数将返回它的独占使用状态如指定

的表别名不存在 V i s u a l F o x P r o 会显示错误信息

n W o r k A r e a指定的工作区 I S E X C L U S I V E 函数将返回指定工作区中表的独占使用

状态如果所指定的工作区中没有打开的表则 I S E X C L U S I V E 函数返

回假 ( . F . )c D a t a b a s e N a m e

指定的数据库名 I S E X C L U S I V E 函数返回该数据库的独占使用状态

n T y p e指定所返回的是表的独占使用状态还是数据库的独占使用状态下表列出了

n T y p e 的值和相应的返回状态

n T y p e 要返回独占使用状态的对象

1 表

2 数据库

若要判断数据库的独占使用状态必须把 n T y p e 设置为 2

说明

如果省略了 c T a b l e A l i a s n W o r k A r e a 和 c D a t a b a s e N a m e 三个可选参数 I S E X C L U S I V E

函数返回当前选定工作区中表的独占使用状态

要以独占方式打开一个表可以在 U S E 命令中包含关键字 E X C L U S I V E 子句也可以

在打开表之前把 S E T E X C L U S I V E 设置成 O N

要以独占方式打开数据库可在 O P E N D A T A B A S E 命令中包含关键字 E X C L U S I V E

示例

在下例中使用 I S E X C L U S I V E 函数检验表是否以独占方式打开由于当前工作

区中的表不是以独占方式打开所以表没有被重索引c E x c l u s i v e = S E T ( ' E X C L U S I V E ' )S E T E X C L U S I V E O F FS E T P A T H T O ( H O M E ( 2 ) + ' d a t a \ ' )O P E N D A T A t e s t d a t a & & 打开一个数据库U S E c u s t o m e r & & 不以独占方式打开 c u s t o m e r 表U S E e m p l o y e e I N 0 E X C L U S I V E & & 在另一个工作区中以独占方式打开I F I S E X C L U S I V E ( )

R E I N D E X & & 只有当表以独占方式打开时才重建索引E L S E

W A I T W I N D O W ' T h e t a b l e h a s t o b e e x c l u s i v e l y o p e n e d 'E N D I FS E T E X C L U S I V E & c E x c l u s i v e

请参阅

O P E N D A T A B A S E , S E T E X C L U S I V E , U S E

I S F L O C K E D 函数

返回表的锁定状态

语法

I S F L O C K E D ( [ n W o r k A r e a | c T a b l e A l i a s] )返值类型

逻辑值

参数描述

n W o r k A r e a指定数据区需要返回其中锁定状态的表就在该数据区中如果您既不指定

n W o r k A r e a 也不指定 n W o r k A r e a 则当前工作区中的表的锁定状态被返

回

c T a b l e A l i a s指定返回锁定状态的表的别名如果指定了别名的表没有打开也将出现

没有找到别名的错误信息

说明

如果指定的表被锁定 I S F L O C K E D 返回真 ( .T . ) 否则返回假 ( .F.) I S F L O C K E D

与 S Y S ( 2 0 1 1 ) 类似但 I S F L O C K E D 返回逻辑值 S Y S ( 2 0 1 1 ) 返回字符值

请参阅

F L O C K ( ) , ISRLOCKED( ) , LOCK( ) , RLOCK( ) , S Y S ( 2 0 1 1 )

I S H O S T E D 函数

返回一个逻辑值表明一个 A c t i v e D o c u m e n t 是否包含在 A c t i v e D o c u m e n t 容器中

语法

ISHOSTED( )返值类型

逻辑值

说明

如果一个 A c t i v e D o c u m e n t 包含在 A c t i v e D o c u m e n t 容器例如 M i c r o s o f t I n t e r n e t

E x p l o r e r 中则 I S H O S T E D 返回真 ( .T . ) 如果一个 A c t i v e D o c u m e n t 没有包

含在 A c t i v e D o c u m e n t 容器中则 I S H O S T E D 返回假 ( .F.) 例如 A c t i v e

D o c u m e n t 在一个交互的 Visual F o x P r o 工作期中或运行时刻 Visual 中运行

请参阅

G E T H O S T ( )

I S L E A D B Y T E 函数

如果字符表达式第一个字符的首字节是前导字节则返回真 (.T . )

语法

I S L E A D B Y T E (c E x p r e s s i o n )返值类型

逻辑值

参数描述

c E x p r e s s i o n指定 I S L E A D B Y T E 求值的字符表达式忽略 c E x p r e s s i o n 中第一个字符

的第一个字节之后的任何字节

说明

如果字符表达式第一个字符的首字节是前导字节 I S L E A D B Y T E 返回真

( .T . ) 否则返回假 ( .F.)

该函数可用于管理双字节字符集

请参阅

I S A L P H A ( ) , ISDIGIT( ) , ISLOWER( ) , ISUPPER( )

I S L O W E R 函数

判断字符表达式最左边的字符是否为小写字母

语法

I S L O W E R (c E x p r e s s i o n )返值类型

逻辑值

参数描述

c E x p r e s s i o n指定 I S L O W E R 函数要判断的字符表达式 c E x p r e s s i o n 中第一个字符之

后的所有字符都被 I S L O W E R 函数忽略

说明

如果指定字符表达式的第一个字符是小写字母 I S L O W E R 函数返回真 ( .T . )

否则返回假 ( .F.)

示例

C L E A R? I S L O W E R ( ' r e d m o n d ') & & 显示数值 . T .? I S L O W E R ( ' R e d m o n d ') & & 显示数值 . F .

请参阅

I S A L P H A ( ) , ISUPPER( ) , LOWER( ) , UPPER( )

I S M O U S E 函数

如果所用计算机装有鼠标则返回真 ( .T.)

语法

ISMOUSE( )说明

若有鼠标 I S M O U S E 函数返回真 ( .T . ) 否则返回假 ( .F.)

示例

下面的示例在有鼠标时显示真 ( .T . ) 否则显示假 ( .F.)C L E A R? ' M o u s e h a r d w a r e p r e s e n t ? '? ? I S M O U S E ( )

请参阅

M C O L ( ) , MDOWN( ) , MROW( ) , SYSMETRIC( )

I S N U L L 函数

如果一个表达式的计算结果为 nu l l 值则返回真 ( .T.) 否则返回假 ( .F.)

语法

I S N U L L (e E x p r e s s i o n )返值类型

逻辑值

参数描述

e E x p r e s s i o n指定要计算的表达式

说明

I S N U L L 函数可用于判断字段变量或数组元素是否为 nu l l 值也可以判断表达

式的计算结果是否为 nu l l 值

示例

下面的示例中 I S N U L L 用于检查 nu l l 值S T O R E . N U L L . T O m N u l l v a l u e & & 将 nu l l 值存入内存变量

C L E A R? m N u l l v a l u e & &显示内存变量的值? I S N U L L (m N u l l v a l u e) & & 返回 .T . , 表示为 nu l l 值

? T Y P E ( ' m N u l l v a l u e ' ) & & 返回 L , 表示为逻辑值? ( m N u l l v a l u e = . N U L L . ) & & 返回 .NULL . , nu l l 值测试有误

请参阅

N V L ( ) , S E T N U L L

I S R E A D O N L Y 函数

判断是否以只读方式打开表

语法

I S R E A D O N L Y ( [ n W o r k A r e a | c T a b l e A l i a s ] )返值类型

逻辑值

参数描述

n W o r k A r e a | c T a b l e A l i a s返回其他工作区中打开表的只读状态 n W o r k A r e a 指定工作区号

c T a b l e A l i a s 指定表或工作区的别名若在指定的工作区中没有打开的表

I S R E A D O N L Y 函数返回假 ( .F . )如果没有指定工作区号表别名或工作区别名则返回当前工作区中打开的

表的只读状态

说明

若表是以只读方式打开 I S R E A D O N L Y 返回真 ( .T . ) 否则返回假

( .F.)

要以只读方式打开表可以使用包含 N O U P D A T E 选项的 U S E 命令也可以在打

开对话框打开该表时在对话框中选定只读复选框还可以把表文件的 M S -

D O S 文件属性设置为只读

用 S E L E C T - S Q L 命令创建的临时表总是只读的

示例

C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' d a t a \ t e s t d a t a ' )U S E c u s t o m e r N O U P D A T E & & 以只读方式打开 c u s t o m e r 表

C L E A R? I S R E A D O N L Y (' c u s t o m e r ' ) & & r e t u r n . T .

请参阅

U S E

I S R L O C K E D 函数

返回记录的锁定状态

语法

I S R L O C K E D ( [ n R e c o r d N u m b e r , [n W o r k A r e a | c T a b l e A l i a s] ] )返值类型

逻辑值

参数描述

n R e c o r d N u m b e r指定一个记录号该记录的锁定状态被返回如果您省略记录号当前记录

的锁定状态被返回

n W o r k A r e a指定记录所在的表所在的工作区如果您既不指定 n W o r k A r e a 也不指定

n W o r k A r e a 则默认返回当前工作区中的表中的记录的锁定状态

c T a b l e A l i a s指定表的别名

说明

如果指定记录处于锁定状态 I S R L O C K E D 返回真 ( .T . ) 否则返回假 ( .F.)

请参阅

F L O C K ( ), ISFLOCKED( ) , LOCK( ), RLOCK( ) , S Y S ( 2 0 1 1 )

I S U P P E R 函数

判断字符表达式的首字符是否为大写字母 (A Z )

语法

I S U P P E R (c E x p r e s s i o n )返值类型

逻辑值

参数描述

c E x p r e s s i o n指定要判断的字符表达式 c E x p r e s s i o n 中第一个字符以后的所有字符都将被

忽略

说明

若字符表达式的第一个字符为大写字母 (A Z ) I S U P P E R 函数返回真 ( .T . )

否则返回假 ( .F.)

示例

? I S U P P E R ( ' R e d m o n d ') & & 显示数值 . T .? I S U P P E R ( ' r e d m o n d ' ) & & 显示数值 . F .

请参阅

I S A L P H A ( ) , ISLOWER( ) , LOWER( ) , UPPER( )

I tem 方法

返回对文件集合项目集合或服务程序集合中一个指定文件项目或服务程序的对象

引用

语法

O b j e c t. I t e m (n I n d e x)n I n d e x

一个指定文件集合项目集合或服务程序集合中一个文件项目或服务程序

的值如果 n I n d e x 比集合中的文件项目或服务程序数目多则会造成一

个无效引用错误

说明

使用 N a m e 属性和 I t e m 属性可以确定一个文件项目或服务程序的名称以及它们

的目录

应用于

文件集合项目集合服务程序集合

请参阅

N a m e 属性

I tem B a c k C o l o r , I t e m F o r e C o l o r 属性

在组合框或列表框控件中指定显示数据项文本的背景色或前景色设计和运行时可

用

语法

C o n t r o l. I t e m B a c k C o l o r [ = n C o l o r ]

– 或 –

C o n t r o l . I t e m B a c k C o l o r = R G B (n R e d V a l u e , n G r e e n V a l u e , n B l u e V a l u e )C o n t r o l . I t e m F o r e C o l o r [ = n C o l o r]

– 或 –

C o n t r o l. I t e m F o r e C o l o r = R G B (n R e d V a l u e , n G r e e n V a l u e , n B l u e V a l u e )参数描述

n C o l o r指定表示文本颜色的整数

注意在属性窗口中双击颜色属性系统显示颜色对话框可以在此对话框

中选择或定义颜色关闭颜色对话框后与所选颜色相对应的红

绿蓝三色的深度就变成这些属性的设置

有关详细内容请参阅 B a c k C o l o r , F o r e C o l o r 属性中的颜色表主题

应用于

组合框列表框

请参阅

B a c k C o l o r , F o r e C o l o r 属性 , S e l e c t e d I t e m B a c k C o l o r , S e l e c t e d I t e m F o r e C o l o r 属性

I tem D a ta 属性

使用索引引用一维数组该数组包含的数据项数目与组合框或列表框控件中 L i s t 属性

的设置相等设计时不可用运行时可读写

语法

C o n t r o l. I t e m D a t a (n I n d e x ) [ = n D a t a ]

参数描述

n I n d e x指定要保存或检索的数据项的索引 n I n d e x 对应于列表中数据项的显示顺

序

n D a t aI t e m D a t a 列表中要保存或检索的编号

说明

使用 I t e m D a t a 属性可使组合框或列表框中的每个数据项都与一个指定编号相联系

然后可以在程序中使用这些编号来标识列表中的各个数据项例如在列表框中可

用编号来标识每个雇员的姓名在填充列表框的同时也把雇员的编号填充到

I t e m D a t a 数组的对应元素中

注意当使用 A d d I t e m 方法向列表中插入数据项时 I t e m D a t a 数组中也将自

动插入一个数据项但并未对该数据项的值进行初始化即这个数据

项所在位置的值并没有发生变化因而如果使用 I t e m D a t a 属性当

向列表中添加新数据项时一定要给每个数组元素赋值

另请注意 I t e m D a t a 属性的值只有在组合框或列表框的项少于 6 0 时才正确

应用于

组合框列表框

请参阅

A d d I t e m 方法 , I t e m I D T o I n d e x 方法 , L i s t 属性 , L i s t I t e m I D 属性 , N e w I t e m I D 属性 R e m o v e I t e m 方法 , S e l e c t e d 属性 , T o p I t e m I D 属性

I tem I D D a t a 属性

使用唯一的标识编号来引用一维数组该数组中包含的数据项数目与组合框或列表框

控件中 L i s t 属性的设置相等设计时不可用运行时可读写

语法

C o n t r o l. I t e m I D D a t a ( n I t e m I D ) [ = n D a t a ]参数描述

n I t e m I D指定数据项的唯一标识号

n D a t aI t e m I D D a t a 列表中要保存或检索的编号

说明

使用 I t e m I D D a t a 属性可使组合框或列表框中的每个数据项都与一个指定的编号相联

系然后可以在程序中使用这些编号来标识列表中的各个数据项例如对于每一个

雇员的列表可以有一个对应的编号当在列表中添加新数据项时 I t e m I D D a t a a r r a y 数

组中对应编号的相应项也做相应改动

注意当使用 A d d I t e m 方法向列表中插入数据项时 I t e m I D D a t a 数组中也

将自动插入一个数据项但并未对该数据项的值进行初始化即这个

数据项所在位置的值并没有发生变化因而在使用 I t e m I D D a t a 属性

向列表中添加新数据项时一定要给每个数组元素赋值该数组与

I t e m D a t a 属性所访问的数组相同

应用于

组合框列表框

请参阅

I n d e x T o I t e m I D 方法 , L i s t 属性 , L i s t I t e m I D 属性 , N e w I t e m I D 属性 ,

R e m o v e I t e m 方法 , S e l e c t e d 属性 , T o p I t e m I D 属性

I tem I D T o I n d e x 方法

返回 n I n d e x 值这个值指示数据项在控件列表中的位置

语法

[n I n d e x = ]C o n t r o l. I t e m I D T o I n d e x (n I t e m I D )参数描述

n I t e m I D与数据项相联系的唯一标识号

说明

添加到组合框或列表框中的每个数据项都具有两个编号

• n I t e m I D 唯一的标识编号

• n I n d e x 一个整数它对应于控件中数据项显示顺序列表中的第一个数据

项对应于 n I n d e x = 1在数据项刚添加到控件中时这两个编号是相同的但随着数据项的排序删除和添

加这两个编号可能不相同

当知道控件列表中某一指定项的 n I t e m I D 编号时可使用 I t e m I D T o I n d e x 方法获得它

的 n I n d e x 编号

应用于

组合框列表框

请参阅

A d d I t e m 方法 , A d d L i s t I t e m 方法 , I n d e x T o I t e m I D 方法 , L i s t I t e m I D 属性 , L i s t属性 , L i s t C o u n t 属性

I tem T ips 属性

指定组合框或列表框中的项是否显示条目提示设计时可用在运行时刻可读写

语法

C o n t r o l. I t e m T i p s [ = l E x p r e s s i o n ]参数描述

l E x p r e s s i o n

I t e m T i p 属性的设置有

设置说明

真

(.T . )

组合框或列表框中的项显示条目提示

假

(.F.)

默认值组合框或列表框中的项不显示条目提示

说明

条目提示是一个小窗口当鼠标指针位于组合框或列表框的一项上时条目提示显示

整个项当组合框或列表框中的项比控件长时可将这个属性设置为真

任何时候组合框或列表框控件中的项都比控件的宽度大

应用于

组合框列表框

请参阅

I t e m D a t a 属性

J O I N 命令

包含此命令是为了提供向后兼容性可使用 S E L E C T - S Q L 命令代替

J U S T D R I V E 函数

从完整路径中返回驱动器的字母

语法

J U S T D R I V E (c P a t h )返值类型

字符型

参数描述

c P a t h指定完整路径名您只需要驱动器的字母

请参阅

A D D B S ( ) , DEFAULTEXT( ) , FILE( ) , FORCEEXT( ) , FORCEPATH( ) ,

JUSTEXT( ) , JUSTFNAME( ) , JUSTPATH( ), JUSTSTEM( )

J U S T E X T 函数

从完整路径中返回三字母的扩展名

语法

J U S T E X T (c P a t h )返值类型

字符型

参数描述

c P a t h指定文件的名称其中包含完整路径您只需其中的扩展名

请参阅


JUSTDRIVE( ) , JUSTFNAME( ) , JUSTPATH( ) , JUSTSTEM( )

J U S T F N A M E 函数

返回完整路径和文件名中的文件名部分

语法

J U S T F N A M E ( c F i l e N a m e)返值类型

字符型

参数描述

c F i l e N a m e指定文件的名称其中包含完整路径您只需其中的文件名

请参阅


JUSTDRIVE( ) , JUSTEXT( ) , JUSTPATH( ) , JUSTSTEM( )

J U S T P A T H 函数

返回完整路径中的路径名

语法

J U S T P A T H (c F i l e N a m e)返值类型

字符型

参数描述

c F i l e N a m e指定文件的名称其中包含完整路径您只需其中的路径

请参阅


JUSTDRIVE( ) , JUSTEXT( ) , JUSTFNAME( ) , JUSTSTEM( )

J U S T S T E M 函数

返回完整路径和文件名中的根名扩展名前的文件名

语法

J U S T S T E M (c F i l e N a m e )返值类型

字符型

参数描述

c F i l e N a m e指定文件的名称其中包含完整路径您只需其中的根名

请参阅


JUSTDRIVE( ) , JUSTEXT( ) , JUSTFNAME( ) , JUSTPATH( )

K E Y 函数

返回索引标识或索引文件的索引关键字表达式

语法

K E Y ( [ C D X F i l e N a m e , ] n I n d e x N u m b e r [ , n W o r k A r e a | c T a b l e A l i a s ] )返值类型

字符型

参数描述

C D X F i l e N a m e指定复合索引文件的文件名 K E Y 函数将返回 . C D X 文件中索引标识的

索引关键字表达式所指定的复合索引文件可以是和表一起自动打开的结构

复合索引文件也可以是独立的复合索引文件

n I n d e x N u m b e r指定要返回哪一个索引关键字表达式

U S E 和 S E T I N D E X 命令都支持一个索引文件列表从中可以为一个表同时打开多个索

引文件索引文件列表中可以包含 . I D X 单项索引文件结构复合索引文件或独立的复

合索引文件等三种索引文件的任意组合

数值表达式 n I n d e x N u m b e r 指定从打开的索引文件中返回哪一个索引表达式随着

n I n d e x N u m b e r 从 1 递增到所打开的 . I D X 单项索引文件结构复合索引文件和独立复合

索引文件三者的总数 K E Y 函数将按下列顺序依次从打开的各索引文件中返回索

引表达式

1 . 首先返回 . I D X 单项索引文件如果有此类文件打开中的索引表达式

各个单项索引文件在 U S E 或 S E T I N D E X 命令中的排列顺序决定索引表达

式的返回顺序

2 . 其次返回结构复合索引如果有中的每个标识的索引表达式多个标识

的索引表达式的返回顺序取决于各标识在结构复合索引中的创建顺序

3 . 最后返回打开的独立复合索引中的每个标识的索引表达式多个标识的索

引表达式的返回顺序取决于标识在独立复合索引中创建的顺序

若 n I n d e x N u m b e r 大于打开的索引文件总数包括 . I D X 单项索引文件结构复合索引

文件和独立的复合索引文件则返回空字符串

n W o r k A r e a指定表所在的工作区号 K E Y 函数将返回该表的索引关键字表达式

如果指定的工作区中没有表打开则 K E Y 函数返回空字符串

c T a b l e A l i a s指定表别名 K E Y 函数将返回该表的索引关键字表达式

若指定的表别名不存在 V i s u a l F o x P r o 将产生错误信息

若省略 n W o r k A r e a 和 c T a b l e A l i a s 参数将返回当前工作区中打开表的索引关键字表达

式

说明

用 I N D E X 命令创建索引标识或索引文件时可指定其索引关键字表达式当该索引标

识或索引文件作为主控索引标识或主控索引文件打开时其索引关键字表达式将决定

表的显示或访问方式

有关创建索引标识索引文件以及索引关键字表达式的详细内容请参阅 I N D E X

示例

下面的示例先打开 t e s tda ta 数据库中的 c u s t o m e r 表然后在 F O R . . . E N D F O R 创建的循

环中使用 K E Y 函数来显示 c u s t o m e r 结构索引文件中每个索引标识的索引表达式

每个结构索引标识名和它的索引表达式同时显示C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' D a t a \ t e s t d a t a ' )U S E C u s t o m e r & & 打开 c u s t o m e r 表C L E A R

F O R n C o u n t = 1 T O 2 5 4I F ! E M P T Y ( T A G ( n C o u n t ) ) & & 检查索引文件中的标识? T A G ( n C o u n t ) + ' ' & & 显示标识的名称? ? K E Y (n C o u n t ) & & 显示索引表达式E L S E

E X I T & & 所有标识都搜索完以后退出循环E N D I F

E N D F O R

请参阅

I N D E X , R E I N D E X , S E T I N D E X , S Y S ( 1 4 )

K E Y B O A R D 命令

把指定的字符表达式放置到键盘缓冲区中

语法

K E Y B O A R D c K e y b o a r d V a l u e[ P L A I N ] [ C L E A R ]

参数描述

c K e y b o a r d V a l u e指定要放入键盘缓冲区的字符表达式字符表达式可以是字符串一个键标

记一组键标记也可以是一个可返回字符表达式的用户自定义函数

若 c K e y b o a r d V a l u e 是一个键标记则必须把它用大括号和引号括起来例如

K E Y B O A R D ' { C T R L + L E F T A R R O W } '

有关键标记的列表请参阅 O N K E Y L A B E L 键盘缓冲区中最多可容纳 1 2 8 个字符

当键盘缓冲区完全充满以后多余的字符将被忽略

P L A I N如果您定义了键盘宏或激活了 O N K E Y L A B E L 命令包含 P L A I N 参数可忽

略这些键盘指定包含 P L A I N 参数的 K E Y B O A R D 命令向键盘缓冲区中放

置的是原义字符而非键盘指定值

例如若您已用 O N K E Y L A B E L 命令给 A 键指定了一条命令而且 c K e y b o a r d V a l u e

中又包含有 A 使用 P L A I N 参数可把字母 A 放到键盘缓冲区中而没有执行指

定给 A 的 O N K E Y L A B E L 命令

C L E A R在把 c K e y b o a r d V a l u e 放置到键盘缓冲区以前先清除该缓冲区内的所有内

容

说明

使用 K E Y B O A R D 命令可把字符放置到键盘缓冲区中在 V i s u a l F o x P r o 查找键盘输入

之前这些字符将一直保存在键盘缓冲区中在查找键盘输入时这些字符将被读出

并执行如同我们直接从键盘输入一样

利用 K E Y B O A R D 命令可创建自动运行的演示系统来演示您的应用程序

请参阅

C H R S A W ( ) , O N K E Y L A B E L , P L A Y M A C R O , S E T F U N C T I O N

K e y b o a r d H i g h V a l u e , K e y b o a r d L o w V a l u e 属性

指定可用键盘输入到微调控件文本框中的最大最小值设计和运行时可用

语法

S p i n n e r .K e y b o a r d H i g h V a l u e [ = n H i g h ]

S p i n n e r .K e y b o a r d L o w V a l u e [ = n L o w ]参数描述

n H i g h指定可输入的最大值 n H i g h 的默认值为 2 , 1 4 7 , 4 8 3 , 6 4 7

n L o w指定可输入的最小值 n L o w 的默认值为 2 , 1 4 7 , 4 8 3 , 6 4 7应用于

微调

请参阅

S p i n n e r H i g h V a l u e , S p i n n e r L o w V a l u e 属性

K E Y M A T C H 函数

在索引标识或索引文件中搜索一个索引关键字

语法

K E Y M A T C H (e I n d e x K e y [ , n I n d e x N u m b e r [ , n W o r k A r e a | c T a b l e A l i a s ] ] )返值类型

逻辑值

参数描述

e I n d e x K e y指定要搜索的索引关键字索引文件或索引标识中的索引关键字是由索引表

达式决定的用 I N D E X 命令创建索引文件或索引标识时可以指定其索引表

达式 K E Y 函数和 S Y S ( 1 4 ) 命令都可返回索引文件或索引标识的索引表

达式有关创建索引文件索引表达式以及索引关键字的详细内容请参阅

I N D E X若省略所有可选参数 K E Y M A T C H 函数将在主控索引文件或主控索引标识中搜索

指定的索引关键字如果不存在有效的主控索引文件或主控索引标识例如已用不

包含任何参数的 S E T O R D E R T O 命令把表设置成了物理记录顺序 V i s u a l F o x P r o 将

产生错误信息

n I n d e x N u m b e r指定在哪一个索引文件或索引标识中搜索通常情况下若要搜索其他的索

引标识 n I n d e x N u m b e r 一般是一个从 1 开始以 1 递增的整数

如 n I n d e x N u m b e r 为 1 则搜索主控单项索引 ( . I D X ) 文件或主控索引标识如果有

随着 n I n d e x N u m b e r 的增大依次搜索结构复合索引文件如果有中各个后续标识

各个标识的搜索次序取决于它们在结构复合索引中的创建顺序

随着 n I n d e x N u m b e r 的继续增大在搜索结构复合索引文件中的所有标识后将搜索打

开的独立复合索引文件中的标识各标识的搜索次序取决于它们在独立复合索引中的

创建顺序

若 n I n d e x N u m b e r 大于打开的索引文件总数包括 . I D X 单项索引文件结构复合索引

标识和独立的复合索引标识 V i s u a l F o x P r o 将产生错误信息

n W o r k A r e a | c T a b l e A l i a s用于搜索非当前工作区中的索引文件或标识 n W o r k A r e a 指定工作区号

c T a b l e A l i a s 指定表别名若省略这两个参数 K E Y M A T C H 函数将搜索

由当前工作区中的表打开的索引文件或标识

如果指定的表别名不存在 V i s u a l F o x P r o 将产生错误信息

说明

K E Y M A T C H 函数在索引标识或索引文件中搜索指定的索引关键字若找到则返回

真 (.T.) 否则返回假 (.F.) 该函数可以用来防止重复出现的索引关键字

K E Y M A T C H 函数运行完之后仍把记录指针放置到运行该函数之前记录指针所

指的记录上

请参阅

I N D E X , I N D E X S E E K ( ) , KEY( ) , S E T I N D E X , S Y S ( 1 4 ) , U S E

K e y P r e s s 事件

当用户按下并释放某个键时发生此事件

语法

P R O C E D U R E O b jec t .K e y P r e s sL P A R A M E T E R S [ n I n d e x , ] n K e y C o d e , n S h i f t A l t C t r l

–或者 –

L P A R A M E T E R S n K e y C o d e , n S h i f t A l t C t r l参数描述

在该事件的处理程序中必须包含 L P A R A M E T E R S 或 P A R A M E T E R S 语句并为每

个参数指定名称

n I n d e x唯一地标识控件数组中的一个控件

n K e y C o d e包含一个数值用该数值标识被按下的键有关特殊键和组合键的编码请

参阅 I N K E Y ( )

n S h i f t A l t C t r l 如果按下在 n K e y C o d e 中标识的键时也按下修改键则设置一个

位

有效的修改键是 S H I F T C T R L 和 A L T 键

下表列出了为单独的修改键在 n S h i f t A l t C t r l 中返回的值

对 n S h i f t A l t C t r l 的修改键值

键值

S H I F T 1

C T R L 2

A L T 4

参数是位的总数重要性最小的位对应于 S H I F T 键 ( b i t 0 ) C T R L 键 ( b i t 1 ) 与 A L T 键

(b i t 2 )

位分别对应于值 1 2 和 4 该参数指出了键的状态可以设置一些位所有位或不能

设置位表示按下了一些键所有键或没有按键例如如果同时按下 C T R L 与 A L T

键 n S h i f t A l t C t r l 的值为 6

说明

具有焦点的对象接收该事件

在两种情况下表单可接收 K e y P r e s s 事件

• 表单中不包含控件或表单的控件都不可见或未激活

• 表单的 K e y P r e v i e w 属性设置为真 ( .T .) 表单首先接收 K e y P r e s s 事件

然后具有焦点的控件才接收此事件

• 表单的 K e y P r e v i e w 属性设置为真 ( .T .) 表单首先接收 K e y P r e s s 事件

然后具有焦点的控件才接收此事件

K e y P r e s s 事件常用于截取输入到控件中的键击它使您可以立即检验键击的有效性或

对键入的字符进行格式编排使用 K e y P r e v i e w 属性可以创建全局键盘处理程序

对任何与 A L T 键的组合键不发生 K e y P r e s s 事件

应用于

复选框组合框命令按钮编辑框表单列表框选项按钮微调文本框

请参阅

I , K e y P r e v i e w 属性

K e y P r e v i e w 属性

指定表单的 K e y P r e s s 事件是否优先于控件的 K e y P r e s s 事件设计和运行时可用

语法

O b j e c t.K e y P r e v i e w [ = l E x p r]参数描述

l E x p r下表列出了 K e y P r e v i e w 属性的设置

设置说明

真

(.T . )

表单首先接收 K e y P r e s s 事件然后活动控件才接收

假

(.F.)

默认值由活动控件接收 K e y P r e s s 事件表单不接收

说明

使用 K e y P r e v i e w 属性可使表单先对 K e y P r e s s 事件进行处理然后再由当前活动控件

对这些事件进行处理

可以使用这个属性为表单创建一个全局键盘处理程序例如在应用程序中用到功能

键时可以在表单层次上对这些键击做出处理而不用为每一个接收到键击事件的控

件分别编写代码

若表单没有可见的活动控件它将自动接收所有键盘事件

应用于

表单页面 _ S C R E E N 工具栏

请参阅

E n a b l e d 属性 , K e y P r e s s 事件 , V is ib l e 属性

L A B E L 命令

根据表文件和标签定义文件打印标签

语法

L A B E L [ F O R M F i l e N a m e 1 | F O R M ? ] ,[ E N V I R O N M E N T ][S c o p e ][ F O R l E x p r e s s i o n 1 ][W H I L E l E x p r e s s i o n 2 ][ N O C O N S O L E ][ N O O P T I M I Z E ][ P D S E T U P ]

[ P R E V I E W [ N O W A I T ] ][ N A M E O b j e c t N a m e][ T O P R I N T E R [ P R O M P T ] | T O F I L E F i l e N a m e 2 ]

参数描述

F O R M F i l e N a m e 1指定要打印的标签所对应的标签定义文件名标签定义文件的默认扩展名

为 . L B X 若标签定义文件不在当前驱动器或当前目录中则必须指定驱动

器和目录

F O R M ?显示打开对话框从中可以选择一个已有的标签文件

E N V I R O N M E N T包含此参数是为了提供与 F o x P r o 2 . x 标签的向后兼容性若要恢复与 V i s u a lF o x P r o 标签相联系的数据环境可把该数据环境的 A u t o O p e n T a b l e s 属性置

为默认值真 ( .T .) 为了确保在标签打印完毕后关闭数据环境可把该数

据环境的 A u t o C l o s e 属性设置为默认值真 ( .T .)

当创建或修改标签时可把当前的 V i s u a l F o x P r o 数据环境同标签定义文件一起保存起

来保存 V i s u a l F o x P r o 数据环境可把所有打开的表和索引文件索引顺序以及表之

间的关系等其他信息作为附加记录放置在标签定义表中

S c o p e指定记录的范围系统只打印该范围以内的记录 S c o p e 子句有 A L L

N E X T n R e c o r d s R E C O R D n R e c o r d N u m b e r 和 R E S T 等包含 S c o p e 参数的

命令只对活动工作区中的表进行操作

L A B E L 命令默认的范围是所有 ( A L L ) 记录

F O R l E x p r e s s i o n 1指定一个条件只打印满足逻辑条件 l E x p r e s s i o n 1 的记录这样可以把不想

打印的记录筛选掉

若 l E x p r e s s i o n 1 是一个可优化的表达式则 R u s h m o r e 将对 L A B E L F O R 命令所创建

的查询进行优化为了达到最好的运行效率应在 F O R 子句中使用可优化的表达式



W H I L E l E x p r e s s i o n 2指定一个条件只要逻辑表达式 lExpress ion2 计算为真 ( .T.) 就连续打印记

录

N O C O N S O L E在打印标签或向文件中传送标签时不在 V i s u a l F o x P r o 主窗口或用户自定义

窗口显示标签的输出结果

N O O P T I M I Z E关闭 R u s h m o r e 对 L A B E L 命令进行优化

详细内容请参阅稍后的 S E T O P T I M I Z E 命令与 Microsoft Visual F o x P r o6 .0 中文版程序员指南第十五章优化应用程序中的掌握 R u s h m o r e 技

术

P D S E T U P加载打印机驱动程序设置

在 V i s u a l F o x P r o 中包含 P D S E T U P 关键字可以使用打印机驱动设置来打印在

F o x P r o f o r M S - D O S 中创建的基于字符的标签打印 V i s u a l F o x P r o 中建立的基于图形的

标签时忽略 P D S E T U P

P R E V I E W [ N O W A I T ]打印之前先在预览窗口中显示标签而不打印若要打印标签必须再

发出一条不含 P R E V I E W 子句的 L A B E L 命令

在 V i s u a l F o x P r o 中若包含可选的 N O W A I T 子句则在运行时 V i s u a l F o x P r o 将不等

待关闭页面预览窗口而是在该窗口打开的情况下继续往下执行

N A M E O b j e c t N a m e为标签的数据环境指定一个对象变量名数据环境和其中的对象具有属性和

方法例如 A d d O b j e c t 运行时需要设置或调用它们利用对象变量可对

这些属性和方法进行访问若不指定对象变量名 V i s u a l F o x P r o 将把标签文

件的文件名作为对象变量名的默认值供事件引用

T O P R I N T E R [ P R O M P T ]向打印机发送标签在 V i s u a l F o x P r o 中若包含可选项 P R O M P T 则在开

始打印以前提示打印对话框

T O F I L E F i l e N a m e 2把 F o x P r o f o r M S - D O S 中创建的基于字符的标签发送到文本文件 F i l e N a m e 2

中包含 T O F I L E 子句将创建该文件默认扩展名为 . T X T说明

用 M O D I F Y L A B E L 或 C R E A T E L A B E L 命令可以创建标签定义文件

若不带任何参数发出 L A B E L 命令打开对话框出现显示已有的标签文件以供

选择

请参阅

C R E A T E L A B E L , M O D I F Y L A B E L

L a b e l 控件

创建用以显示文本的标签

语法

L a b e l说明

标签控件是用以显示文本的图形控件其中的文本不能直接更改但是由于标签控

件具有与其他控件相同的一套属性事件和方法所以运行时它也可以对事件做出反

应或者动态地被更换

若要给标签指定一个访问键可在标题中作为访问键的字符前面加上反斜杠和小于号

( \ < ) 显示这一标签时该字符带有下划线按下标签的访问键时将激活 T a b 键次

序所指定的下一个控件使用 T a b I n d e x 属性可给标签指定一个 T a b 键次序

不同的对象所显示的标题也不同

标签控件的 C a p t i o n 属性允许包含的最大字符数目为 2 5 6 个

有关创建标签控件的详细内容请参阅 Microsoft Visual F o x P r o 6 . 0 中文版程序员指

南的第十章使用控件

属性

A l i g n m e n t A p p l i c a t i o n A u t o S i z eB a c k C o l o r B a c k S t y l e B a s e C l a s sB o r d e r S t y l e C a p t i o n C l a s sC l a s s L i b r a r y C o l o r S c h e m e C o l o r S o u r c eC o m m e n t D i s a b l e d B a c k C o l o r D i s a b l e d F o r e C o l o rD r a g I c o n D r a g M o d e E n a b l e dF o n t B o l d F o n t C o n d e n s e F o n t E x t e n dF o n t I t a l i c F o n t N a m e F o n t O u t l i n eF o n t S h a d o w F o n t S i z e F o n t S t r i k e T h r uF o n t U n d e r l i n e F o r e C o l o r H e i g h tH e l p C o n t e x t I D L e f t M o u s e I c o nM o u s e P o i n t e r N a m e O L E D r a g M o d e

续表

O L E D r a g P i c t u r e O L E D r o p E f f e c t s O L E D r o p H a s D a t aO L E D r o p M o d e P a r e n t P a r e n t C l a s sR i g h t T o L e f t T a b I n d e x T a gT o o l T i p T e x t T o p V is ib leW h a t s T h i s H e l p I D W idth W o r d W r a p事件

C l i c k D b l C l i c k D e s t r o yD r a g D r o p D r a g O v e r E r r o rIn i t M i d d l e C l i c k M o u s e D o w nM o u s e M o v e M o u s e U p M o u s e W h e e lO L E C o m p l e t e D r a g O L E D r a g D r o p O L E D r a g O v e rO L E G i v e F e e d B a c k O L E S e t D a t a O L E S t a r t D r a gR i g h t C l i c k U I E n a b l e

方法

A d d P r o p e r t y C l o n e O b j e c t D r a gM o v e O L E D r a g R e a d E x p r e s s i o nR e a d M e t h o d R e s e t T o D e f a u l t S a v e A s C l a s sU I E n a b l e W r i t e E x p r e s s i o n W r i t e M e t h o dZ O r d e r

请参阅


L A S T K E Y 函数

返回最近一次按键所对应的整数

语法

LASTKEY( )返值类型

数值型

说明

L A S T K E Y 函数的返回值与 I N K E Y 函数的返回值是相等的当在各控制间移

动时 L A S T K E Y 函数的值被更新 .

请参阅

C H R S A W ( ), INKEY( ), READKEY( )

L a s t M od i f i ed 属性

包含项目中一个文件最后更改的日期和时间设计和运行时只读

语法

O b j e c t.L a s t M o d i f i e d说明

L a s t M o d i f i e d 属性包含一个日期时间值表明文件最后更改的时间

应用于

文件对象

请参阅

F D A T E ( ) , F T I M E ( )

L e f t 属性

对于表单对象确定表单的左边界与 V i s u a l F o x P r o 主窗口左边界之间的距离设计和

运行时可用

语法

O b j e c t.L e f t [ = n D i s t]参数描述

n D i s t指定对象的左边界与容器对象的左边界之间的距离

一个表单的默认容器是 V i s u a l F o x P r o 主窗口

说明

Lef t 属性指定了对象零位置的距离例如如果在 Visual 主窗口中包含了一个

表单零位置立即到主窗口的左边界的右侧如果工具栏停放在主窗口的左侧零位

置立即到工具栏的右侧在 M a c i n t o s h 的 Visual F o x P r o 中如果表单在桌面上不包

含 Visual F o x P r o 主窗口中零位置在屏幕的左边

Lef t T o p H e i g h t 和 W idth 属性多用于与对象的外部尺寸有关的操作如移动或调整

对象大小可以用 S c a l e M o d e 属性更改度量单位

注意用于列对象所包含的控件时 L e f t 属性只读

示例

下面的示例演示了如何使用 L e f t 属性确定控件在表单中的位置使用 A d d O b j e c t 方法

向表单中添加一个线条控件和三个命令按钮 Lef t 属性指定了表单上每个控件的水平

位置f r m M y F o r m = C R E A T E O B J E C T ( ' F o r m ' ) & & 创建一个表单f r m M y F o r m . C l o s a b l e = . F . & & 禁止控件菜单框

f r m M y F o r m . A d d O b j e c t ( ' s h p L i n e ' , ' L i n e ' ) & & 向表单中添加线条控件f r m M y F o r m . A d d O b j e c t ( ' c m d C m n d B t n 1 ' , ' c m d M y C m n d B t n 1 ' ) & & 向上命令按钮

f r m M y F o r m . A d d O b j e c t ( ' c m d C m n d B t n 2 ' , ' c m d M y C m n d B t n 2 ' ) & & 向下命令按钮f r m M y F o r m . A d d O b j e c t ( ' c m d C m n d B t n 3 ' , ' c m d M y C m n d B t n 3 ' ) & & 退出命令按钮

f r m M y F o r m . s h p L i n e . V i s i b l e = . T . & & 使线条控件可见f r m M y F o r m . s h p L i n e . T o p = 2 0 & & 指定线条控件行f r m M y F o r m . s h p L i n e . L e f t = 1 2 5 & & 指定线条控件列

f r m M y F o r m . c m d C m n d B t n 1 . V i s i b l e = . T . & & 向上命令按钮可见f r m M y F o r m . c m d C m n d B t n 2 . V i s i b l e = . T . & & 向下命令按钮可见f r m M y F o r m . c m d C m n d B t n 3 . V i s i b l e = . T . & & 退出命令按钮可见

f r m M y F o r m . S H O W & & 显示表单R E A D E V E N T S & & 开始事件处理

D E F I N E C L A S S c m d M y C m n d B t n 1 A S C O M M A N D B U T T O N & & 创建命令按钮C a p t i o n = ' S l a n t \ < U p ' & & 命令按钮标题L e f t = 5 0 & & 命令按钮行T o p = 1 0 0 & & 命令按钮列H e i g h t = 2 5 & & 命令按钮高度

P R O C E D U R E C l i c kT h i s F o r m . s h p L i n e . V i s i b l e = . F . & & 隐藏线条控件T h i s F o r m . s h p L i n e . L i n e S l a n t = ' / ' & & 斜向上T h i s F o r m . s h p L i n e . V i s i b l e = . T . & & 显示线条控件

E N D D E F I N E

D E F I N E C L A S S c m d M y C m n d B t n 2 A S C o m m a n d B u t t o n & & 创建命令按钮C a p t i o n = ' S l a n t \ < D o w n ' & & 命令按钮标题L e f t = 2 0 0 & & 命令按钮行T o p = 1 0 0 & & 命令按钮列H e i g h t = 2 5 & & 命令按钮高度

P R O C E D U R E C l i c kT h i s F o r m . s h p L i n e . V is i b l e = . F . & & 隐藏线条控件T h i s F o r m . s h p L i n e . L i n e S l a n t = ' \ ' & & 斜向下T h i s F o r m . s h p L i n e . V i s i b l e = . T . & & 显示线条控件

E N D D E F I N E

D E F I N E C L A S S c m d M y C m n d B t n 3 A S C o m m a n d B u t t o n & & 创建命令按钮C a p t i o n = ' \ < Q u i t ' & & 命令按钮标题C a n c e l = . T . & & 默认取消命令按钮 ( E s c )L e f t = 1 2 5 & & 命令按钮行T o p = 1 5 0 & & 命令按钮列H e i g h t = 2 5 & & 命令按钮高度

P R O C E D U R E C l i c kC L E A R E V E N T S & & 结束事件处理关闭表单

应用于

复选框组合框命令按钮命令组容器对象控件对象自定义编辑框表

单表格图像标签线条列表框 O L E 绑定型控件 O L E 容器控件选项按

钮选项组页框 _ S C R E E N 形状微调文本框计时器工具栏

请参阅

H e i g h t 属性 , M o v e 方法 , S c a l e M o d e 属性 , T o p 属性 , W i d t h 属性

L E F T 函数

从字符表达式最左边字符开始返回指定数目的字符

语法

L E F T (c E x p r e s s i o n , n E x p r e s s i o n )返值类型

字符型

参数描述

c E x p r e s s i o n指定的字符表达式 L E F T 函数从中返回字符

n E x p r e s s i o n指定从字符表达式中返回的字符个数若 n E x p r e s s i o n 的值大于 c E x p r e s s i o n的长度则返回字符表达式的全部字符否则返回空字符串

L E F T 函数与起始位置为 1 的 S U B S T R 函数是等价的

示例

C L E A R? L E F T ( ' R e d m o n d , W A ' , 4 ) & & 显示数值 R e d m

请参阅

A T ( ), LTRIM( ), RIGHT( ), RTRIM( ), SUBSTR( )

L E F T C 函数

返回字符表达式中指定数目的字符从最左边的字符开始计数

语法

L E F T C (c E x p r e s s i o n , n E x p r e s s i o n )返值类型

字符型

参数描述

c E x p r e s s i o n指定要从中返回字符的字符表达式

n E x p r e s s i o n指定从字符表达式中返回的字符数目如果 n E x p r e s s i o n 大于 c E x p r e s s i o n 长度则返回 n E x p r e s s i o n 的所有字符否则返回空字符串

说明

LEFTC( ) 函数是为包含双字节字符的表达式设计的如果该表达式只包括单字节字

符 LEFTC( ) 函数等同于 LEFT( )

L E F T C 从包含单字节和双字节的任意组合的字符表达式中返回指定数目的字符

L E F T C 与起始位置为 1 的 S U B S T R C 等价

该函数适用于管理 H i r a g a n a 或 K a t a k a n a 等语言的双字节字符集

请参阅

A T _ C ( ), LEFT( ), RIGHTC( ), SUBSTRC( )

L e f t C o l u m n 属性

指定表格控件显示的最左列的编号设计和运行时只读

语法

G r i d .L e f t C o l u m n说明

用 L e f t C o l u m n 可以指定哪些列对用户是不可见的例如若 L e f t C o l u m n = 3 则第 1

列和第 2 列就是不可见的

应用于

表格

请参阅

A c t i v e C o l u m n 属性 , A c t i v e R o w 属性 , C o l u m n O r d e r 属性 , R e l a t i v e C o l u m n 属性 , R e l a t i v e R o w 属性

L E N 函数

返回字符表达式中字符的数目

语法

L E N (c E x p r e s s i o n )返值类型

数值型

参数描述

c E x p r e s s i o n指定的字符表达式 L E N 函数返回其字符数目

说明

L E N 函数可用于确定字符表达式的长度

示例

下面的示例打开了数据库 t e s tda ta 中的 c u s t o m e r 表 L E N 用于显示 c u s t _ i d 与

con tac t 字段的宽度C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' D a t a \ t e s t d a t a ' )U S E C u s t o m e r & & 打开 c u s t o m e r 表

C L E A R

? 'W id th o f con tac t f i e l d : '? ? L E N (c o n t a c t)? 'W id th o f cus t_ id f i e ld : '? ? L E N (cus t_ id )

请参阅

F S I Z E ( ), TXTWIDTH( )

L E N C 函数

返回字符表达式或备注字段中字符的数目

语法

L E N C (c E x p r e s s i o n )返值类型

数值型

参数描述

c E x p r e s s i o n指定由 L E N C 返回其字符数的字符表达式

说明

L E N C 用于包含双字节字符的表达式如果表达式只包含单字节字符 L E N C

等同于 LEN( )

L E N C 返回包含单字节和双字节任意组合的字符表达式或备注字段的字符数

该函数适用于管理双字节字符集

请参阅

L E N ( )

L I K E 函数

确定字符表达式是否与另一个字符表达式相匹配

语法

L I K E (c E x p r e s s i o n 1 , c E x p r e s s i o n 2 )返值类型

逻辑值

参数描述

c E x p r e s s i o n 1指定要与 c E x p r e s s i o n 2 相比较的字符表达式 c E x p r e s s i o n 1 中可以包含通配

符 * 和 ? 问号 ( ? ) 可与 c E x p r e s s i o n 2 中的任何单个字符相匹配星号 ( * ) 可与任意数目的字符相匹配在 c E x p r e s s i o n 1 中可以把任何数目的通配符进行

任意组合

c E x p r e s s i o n 2指定要与 c E x p r s s i o n 1 相比较的字符表达式只有在 c E x p r e s s i o n 1 与c E x p r e s s i o n 2 中的字逐个匹配的情况下 L I K E 函数才返回真 ( . T . )说明

如果 c E x p r e s s i o n 1 与 c E x p r e s s i o n 2 相匹配则 L I K E 函数返回真 ( .T.) 否则

返回假 ( .F.)

S E T C O M P A T I B L E 决定 L I K E 函数如何比较 c E x p r e s s i o n 1 和 c E x p r e s s i o n 2 中的空

格若 S E T C O M P A T I B L E 设置为 O N 或 D B 4 则在比较之前删除 c E x p r e s s i o n 1 和

c E x p r e s s i o n 2 中的后缀空格若 S E T C O M P A T I B L E 设置为 O F F 或 F O X P L U S 则两

字符表达式中的后缀空格也参加比较

示例

在以下示例中显示 p r o d u c t s 表中前两个字母为 “ C h ” 的所有产品名C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' D a t a \ t e s t d a t a ' )U S E p r o d u c t s & & 打开 P r o d u c t s 表

C L E A R? 'A l l p roduc t names w i t h f i r s t two l e t t e r s Ch : '?S C A N F O R L I K E ( ' C h * ' , p r o d _ n a m e )

? p r o d _ n a m eE N D S C A NU S E

请参阅

$ , A T ( ), ATC( ), OCCURS( ), RAT( ) , S E T C O M P A T I B L E

L I K E C 函数

确定字符表达式是否与另一个字符表达式相匹配

语法

L I K E C (c E x p r e s s i o n 1 , c E x p r e s s i o n 2 )返值类型

逻辑值

参数描述

c E x p r e s s i o n 1指定要与 c E x p r e s s i o n 2 相比较的字符表达式 c E x p r e s s i o n 1 中可以包含通配

符 * 和 ? 问号 ( ? ) 可与 c E x p r e s s i o n 2 中的任何单个字符相匹配星号 ( * ) 可与任意数目的字符相匹配

c E x p r e s s i o n 2指定要与 c E x p r s s i o n 1 相比较的字符表达式只有在 c E x p r e s s i o n 1 与c E x p r e s s i o n 2 中的字符逐个匹配的情况下 L I K EC 函数才返回真

( . T . )说明

L I K E C 用于包含双字节字符的表达式如果表达式只包含单字节字符 L

等同于 LIKE( )

L I K E C 决定一个字符表达式是否与另一个字符表达式相匹配字符表达式可以包

含单字节和双字节的任意组合如果 c E x p r e s s i o n 1 与 c E x p r e s s i o n 2 相匹配则 L I K E C

函数返回真 ( .T . ) 否则返回假 ( .F.)

S E T C O M P A T I B L E 决定 L I K EC 函数如何比较 c E x p r e s s i o n 1 和 c E x p r e s s i o n 2 中的

空格若 S E T C O M P A T I B L E 设置为 O N 或 D B 4 则在比较之前删除 c E x p r e s s i o n 1 和

c E x p r e s s i o n 2 中的所有后缀空格若 S E T C O M P A T I B L E 设置为 O F F 或 F O X P L U S

则两字符表达式中的后缀空格也参加比较

该函数适用于管理双字节字符集

请参阅

A T _ C ( ), ATCC( ), LIKEC( ), RATC( )

L i n e 控件

创建一个显示水平竖直或对角线条的控件

语法

L i n e说明

线条控件是一种用来显示水平竖直或对角线条的图形控件所显示的线条不能直接

更改但是由于线条控件与其他控件一样具有一整套属性事件和方法所以运行

时它可以对事件做出反应或者动态地被更改

有关创建线条的详细内容请参阅 M i c r o s o f t V i s u a l F o x P r o 6 . 0 中文版程序员指南


属性

A p p l i c a t i o n B a s e C l a s s B o r d e r C o l o rB o r d e r S t y l e B o r d e r W i d t h C l a s sC l a s s L i b r a r y C o l o r S o u r c e C o m m e n tD r a g I c o n D r a g M o d e D r a w M o d eE n a b l e d H e i g h t H e l p C o n t e x t I DL e f t L i n e S l a n t M o u s e P o i n t e rN a m e O L E D r a g M o d e O L E D r a g P i c t u r eO L E D r o p E f f e c t s O L E D r o p H a s D a t a O L E D r o p M o d eP a r e n t P a r e n t C l a s s T a gT o p V is ib le W h a t s T h i s H e l p I DW idth

事件

C l i c k D b l C l i c k D e s t r o yD r a g D r o p D r a g O v e r E r r o rIn i t M i d d l e C l i c k M o u s e D o w nM o u s e M o v e M o u s e U p M o u s e W h e e lO L E C o m p l e t e D r a g O L E D r a g D r o p O L E D r a g O v e rO L E G i v e F e e d B a c k O L E S e t D a t a O L E S t a r t D r a gR i g h t C l i c k U I E n a b l e

方法

A d d P r o p e r t y C l o n e O b j e c t D r a gM o v e O L E D r a g R e a d E x p r e s s i o nR e a d M e t h o d R e s e t T o D e f a u l t S a v e A s C l a s sW r i t e E x p r e s s i o n W r i t e M e t h o d Z O r d e r

示例

下面的示例演示了如何添加线条控件到表单中以及如何用 L i n e S l a n t 属性来指定线条

倾斜的方向

可用 A d d O b j e c t 方法添加线条控件到表单中添加了三个命令按钮允许您改变线条

倾斜的方向或关闭表单f r m M y F o r m = C R E A T E O B J E C T ( ' F o r m ' ) & & 创建一个表单f r m M y F o r m . C l o s a b l e = . F . & & 取消控件目录箱的作用

f r m M y F o r m . A d d O b j e c t ( ' s h p L i n e ' , 'L i n e ' ) && 向表单增加线条控件

f r m M y F o r m . A d d O b j e c t ( ' c m d C m n d B t n 1 ' , ' c m d M y C m n d B t n 1 ' ) & & 上移 C m n d 按扭f r m M y F o r m . A d d O b j e c t ( ' c m d C m n d B t n 2 ' , ' c m d M y C m n d B t n 2 ' ) & & 下移 C m n d 按扭f r m M y F o r m . A d d O b j e c t( ' c m d C m n d B t n 3 ' , ' c m d M y C m n d B t n 3 ' ) & & 退出 C m n d 按扭

f r m M y F o r m . s h p L i n e . V i s i b l e = . T . & & 让线条控件可见f r m M y F o r m . s h p L i n e . T o p = 2 0 & & 指定线条控件所在行f r m M y F o r m . s h p L i n e . L e f t = 1 2 5 & & 指定线条控件所在列

f r m M y F o r m . c m d C m n d B t n 1 . V i s i b l e = . T . & & 让向上命令按扭可见f r m M y F o r m . c m d C m n d B t n 2 . V i s i b l e = . T . & & 让向下命令按扭可见f r m M y F o r m . c m d C m n d B t n 3 . V i s i b l e = . T . & & 让退出命令按扭可见

f r m M y F o r m . S H O W & & 显示表单R E A D E V E N T & & 启动事件程序

D E F I N E C L A S S c m d M y C m n d B t n 1 A S C O M M A N D B U T T O N & & 创建命令按扭C a p t i o n = ' S l a n t \ < U p ' & & 给命令按扭增加说明L e f t = 5 0 & & 命令按扭列T o p = 1 0 0 & & 命令按扭行H e i g h t = 2 5 & & 命令按扭高度

P R O C E D U R E C l i c kT h i s F o r m . s h p L i n e . V i s i b l e = . F . & & 隐藏线条控件T h i s F o r m . s h p L i n e . L i n e S l a n t = ' / ' & & 启动T h i s F o r m . s h p L i n e . V i s i b l e = . T . & & 显现线条控件

E N D D E F I N E

D E F I N E C L A S S c m d M y C m n d B t n 2 A S C o m m a n d B u t t o n & & 创建命令按扭C a p t i o n = ' S l a n t \ < D o w n ' & & 给命令按扭增加说明Le f t = 2 0 0 & & 命令按扭列T o p = 1 0 0 & & 命令按扭行H e i g h t = 2 5 & & 命令按扭高

P R O C E D U R E C l i c kT h i s F o r m . s h p L i n e . V i s i b l e = . F . & & 隐藏线条控件T h i s F o r m . s h p L i n e . L i n e S l a n t = ' \ ' & & 向下倾斜T h i s F o r m . s h p L i n e . V i s i b l e = . T . & & 显示线条控件

E N D D E F I N ED E F I N E C L A S S c m d M y C m n d B t n 3 A S C o m m a n d B u t t o n & & 创建命令按扭

C a p t i o n = ' \ < Q u i t ' & & 给命令按扭增加说明C a n c e l = . T . & & 默认取消命令按扭 ( E s c 键 )L e f t = 1 2 5 & & 命令按扭列T o p = 1 5 0 & & 命令按扭行H e i g h t = 2 5 & & 命令按扭高

P R O C E D U R E C l i c kC L E A R E V E N T S & &终止事件程序退出表单

E N D D E F I N E

请参阅


L i n e 方法

在表单对象中画一条线

语法

O b j e c t.L i n e (n X C o o r d 2 , n Y C o o r d 2 )

–或者 –O b j e c t.L i n e (n X C o o r d 1 , n Y C o o r d 1 , n X C o o r d 2 , n Y C o o r d 2 )参数描述

n X C o o r d 1 , n Y C o o r d 1指定线条起始点的坐标度量单位由表单的 S c a l e M o d e 属性指定

n X C o o r d 2 , n Y C o o r d 2指定线条终点的坐标

说明

所画线条的宽度取决于 D r a w W i d t h 属性的设置在背景上画线条的方式取决于

D r a w M o d e 和 D r a w S t y l e 属性的设置运行 L i n e 方法后 C u r r e n t X 和 C u r r e n t Y 属性分

别被设置为 n X C o o r d 2 和 n Y C o o r d 2

应用于


请参阅

C u r r e n t X , C u r r e n t Y 属性 , D r a w M o d e 属性 , D r a w S t y l e 属性 , D r a w W i d t h 属性 ,S c a l e M o d e 属性

返回总目录L I N E N O ( ) 函数

L i n e S l a n t 属性

L i n k M a s t e r 属性

L I S T 命令

L I S T C O N N E C T I O N S 命令

L I S T D A T A B A S E 命令

L I S T D L L S 命令

L I S T O B J E C T S 命令

L I S T P R O C E D U R E S 命令

L i s t 属性

L I S T T A B L E S 命令

L I S T V I E W S 命令

L i s t B o x 控件

L i s t C o u n t 属性

L i s t I n d e x 属性

L i s t I t e m 属性

L i s t I t e m I D 属性

_ L M A R G I N 系统变量

L O A D 命令

L o a d 事件

L O A D P I C T U R E ( ) 函数

L O C A L 命令

L O C A T E 命令

L O C F I L E ( ) 函数

L O C K ( ) 函数

L o c k S c r e e n 属性

L O G ( ) 函数

L O G 1 0 ( ) 函数

L O O K U P ( ) 函数

L o s t F o c u s 事件

L O W E R ( ) 函数

L P A R A M E T E R S 命令

L T R I M ( ) 函数

L U P D A T E ( ) 函数

_ M A C 系统变量

M a c D e s k t o p 属性

M a i n C l a s s 属性

M a i n F i l e 属性

M a r g i n 属性

M A X ( ) 函数

M a x B u t t o n 属性

M a x H e i g h t 属性

M a x L e f t 属性

M a x L e n g t h 属性

M a x T o p 属性

M a x W i d t h 属性

M C O L ( ) 函数

M D 或 M K D I R 命令

M D I F o r m 属性

M D O W N ( ) 函数

M D X ( ) 函数

M D Y ( ) 函数

M E M L I N E S ( ) 函数

M E M O R Y ( ) 函数

M e m o W i n d o w 属性

M E N U 命令

M E N U ( ) 函数

M E N U T O 命令

M e s s a g e 事件

M E S S A G E ( ) 函数

M E S S A G E B O X ( ) 函数

M i d d l e C l i c k 事件

M I N ( ) 函数

M i n B u t t o n 属性

M i n H e i g h t 属性

M I N U T E ( ) 函数

M i n W i d t h 属性

M L I N E ( ) 函数

_ M L I N E 系统变量

M O D ( ) 函数

M o d i f y 方法

L I N E N O ( ) 函数

返回程序中正在执行的那一行的行号行号是相对于主程序第一行

语法

L I N E N O ( [ 1 ] )返值类型

数值型

参数描述

1返回相对于当前程序或过程第一行的行号若省略参数 1 则返回相对于主

程序第一行的行号

说明

程序行从程序头开始计数包括注释行继续行和空行若程序在执行中被挂起则

L I N E N O ( ) 返回程序挂起处的程序行号若取消程序则 L I N E N O ( ) 返回 0

默认情况下返回相对于主程序开始的行号如果调用一个过程行号从调用程序头

部开始计数

L I N E N O ( ) 对于调试程序很有用要设置断点并在指定行号处终止程序执行可在调

试窗口中执行下列命令

L I N E N O ( ) = n E x p r e s s i o n

当 L I N E N O ( ) 的值等于 n E x p r e s s i o n 时挂起程序

示例

下面的示例是一个简单的错误处理例程的一部分O N E R R O R D O b u g _ p r o c W I T H L I N E N O ( )B R W S & & 出现错误O N E R R O R

*** 错误处理 * * *

P R O C E D U R E b u g _ p r o cP A R A M E T E R S g n B a d L i n eW A I T W I N D O W ' E r r o r o c c u r r e d a t l i n e : ' + A L L T R I M ( S T R ( g n B a d L i n e ) )R E T U R N

请参阅

E R R O R ( ), MESSAGE( ), PROGRAM( ) , S Y S ( 1 6 )

L i n e S l a n t 属性

指定线条倾斜方向是从左上到右下还是从左下到右上设计和运行时可用

语法

L i n e .L i n e S l a n t [ = c S l a n t]参数描述

c S l a n tL i n e S l a n t 属性的设置是

设置说明

\ 默认值线条从左上到右下倾斜

/ 线条从左下到右上倾斜

示例

下面示例演示了如何使用 L i n e S l a n t 属性指定线条控件的倾向

先向表单添加线条控件再向表单添加三个命令按钮来更改线条倾向或关闭表单f r m M y F o r m = C R E A T E O B J E C T ( ' F o r m ' ) & & 创建一个表单f r m M y F o r m . C l o s a b l e = . F . & & 使控件菜单框无效

f r m M y F o r m . A d d O b j e c t ( ' s h p L i n e ' , ' L i n e ' ) & & 向表单添加线条控件f r m M y F o r m . A d d O b j e c t ( ' c m d C m n d B t n 1 ' , ' c m d M y C m n d B t n 1 ' ) & & 向上命令按钮f r m M y F o r m . A d d O b j e c t ( ' c m d C m n d B t n 2 ' , ' c m d M y C m n d B t n 2 ' ) & & 向下命令按钮f r m M y F o r m . A d d O b j e c t ( ' c m d C m n d B t n 3 ' , ' c m d M y C m n d B t n 3 ' ) & & 退出命令按钮

f r m M y F o r m . s h p L i n e . V i s i b l e = . T . & & 使线条控件可见f r m M y F o r m . s h p L i n e . T o p = 2 0 & & 指定线条控件行f r m M y F o r m . s h p L i n e . L e f t = 1 2 5 & & 指定线条控件列

f r m M y F o r m . c m d C m n d B t n 1 . V i s i b l e = . T . & & 向上命令按钮可见f r m M y F o r m . c m d C m n d B t n 2 . V i s i b l e = . T . & & 向下命令按钮可见

f r m M y F o r m . c m d C m n d B t n 3 . V i s i b l e = . T . & & 退出命令按钮可见


D E F I N E C L A S S c m d M y C m n d B t n 1 A S C O M M A N D B U T T O N & & 创建命令按钮C a p t i o n = ' S l a n t \ < U p ' & & 命令按钮标题L e f t = 5 0 & & 命令按钮列T o p = 1 0 0 & & 命令按钮行H e i g h t = 2 5 & & 命令按钮高度

P R O C E D U R E C l i c kT h i s F o r m . s h p L i n e . V i s i b l e = . F . & & 隐藏线条控件T h i s F o r m . s h p L i n e . L i n e S l a n t = ' / ' & & 上斜T h i s F o r m . s h p L i n e . V i s i b l e = . T . & & 显示线条控件

E N D D E F I N E

D E F I N E C L A S S c m d M y C m n d B t n 2 A S C o m m a n d B u t t o n & & 显示线条控件C a p t i o n = ' S l a n t \ < D o w n ' & & 命令按钮标题L e f t = 2 0 0 & & 命令按钮列T o p = 1 0 0 & & 命令按钮行H e i g h t = 2 5 & & 命令按钮高度

P R O C E D U R E C l i c kT h i s F o r m . s h p L i n e . V i s i b l e = . F . & & 隐藏线条控件T h i s F o r m . s h p L i n e . L i n e S l a n t = ' \ ' & & 下斜T h i s F o r m . s h p L i n e . V i s i b l e = . T . & & 显示线条控件

E N D D E F I N E

D E F I N E C L A S S c m d M y C m n d B t n 3 A S C o m m a n d B u t t o n & & 创建命令按钮

C a p t i o n = ' \ < Q u i t ' & & 命令按钮标题C a n c e l = . T . & & 默认取消命令按钮 ( E S C )L e f t = 1 2 5 & & 命令按钮列T o p = 1 5 0 & & 命令按钮行H e i g h t = 2 5 & & 命令按钮高度

P R O C E D U R E C l i c kC L E A R E V E T N T S & & 终止事件处理关闭表单

E N D D E F I N E

应用于

线条

请参阅

D r a w M o d e 属性 , D r a w S t y l e 属性

L i n k M as te r 属性

指定表格控件中的子表所链接的父表设计时可用运行时可读写

语法

G r i d .L i n k M a s t e r [ = c N a m e ]参数描述

c N a m e指定用来在表格控件中驱动子表显示的父表别名

说明

使用 L i n k M a s t e r 属性可以在表单的父表或主表与表格 R e c o r d S o u r c e 属性所引用的

表之间设置一对多关系

应用于

表格

请参阅

C h i l d O r d e r 属性 , R e l a t i o n a l E x p r 属性

L I S T 命令

连续显示表的信息

语法

L I S T[ F I E L D S F i e l d L i s t][S c o p e ] [ F O R l E x p r e s s i o n 1 ] [W H I L E l E x p r e s s i o n 2 ]

[ O F F ][ N O C O N S O L E ][ N O O P T I M I Z E ][ T O P R I N T E R [ P R O M P T ] | T O F I L E F i l e N a m e ]

– 或 –

L I S T F I L E S[ O N D r i ve ][ L I K E F i l e S k e l e t o n ][ T O P R I N T E R [ P R O M P T ] | T O F I L E F i l e N a m e ]

– 或 –

L I S T M E M O R Y[ L I K E F i l e S k e l e t o n ][ N O C O N S O L E ][ T O P R I N T E R [ P R O M P T ] | T O F I L E F i l e N a m e ]

– 或 –

L I S T S T A T U S[ N O C O N S O L E ][ T O P R I N T E R [ P R O M P T ] | T O F I L E F i l e N a m e ]

– 或 –

L I S T S T R U C T U R E[ I N n W o r k A r e a | c T a b l e A l i a s ][ N O C O N S O L E ]

[ T O P R I N T E R [ P R O M P T ] | T O F I L E F i l e N a m e ]说明

除了下列差别 L I S T 命令与 D I S P L A Y 命令相同

• L I S T 的默认范围是所有记录

• 信息充满 V isua l FoxPro 主窗口或用户自定义窗口以后 L I S T 不给提示继续

显示

• 当 S E T D E L E T E D 为 O N 时 L I S T 不显示带删除标记的记录

有关 L I S T 命令的详细内容请参阅 D I S P L A Y 中的相应命令

请参阅

D I S P L A Y , D I S P L A Y F I L E S , D I S P L A Y M E M O R Y , D I S P L A Y S T A T U S ,D I S P L A Y S T R U C T U R E , S E T D E L E T E D

L I S T C O N N E C T I O N S 命令

连续显示有关当前数据库中命名连接的信息

语法

L I S T C O N N E C T I O N S

[ T O P R I N T E R [ P R O M P T ] | T O F I L E F i l e N a m e ][ N O C O N S O L E ]

参数描述

T O P R I N T E R [ P R O M P T ]将 L I S T C O N N E C T I O N S 的输出结果送到打印机

在 V i s u a l F o x P r o 中包含 P R O M P T 子句可在打印之前显示打印对话框 P R O M P T

应直接放置在 T O P R I N T E R 后面

T O F I L E F i l e N a m e将 L I S T C O N N E C T I O N S 的输出结果送到 F i l e N a m e 指定的文件中若文件已

存在并且 S E T S A F E T Y 为 O N 则 V i s u a l F o x P r o 询问是否改写文件

N O C O N S O L E不向 V i s u a l F o x P r o 主窗口或活动的用户自定义窗口输出

说明

显示信息包括当前数据库中命名连接数据源和连接字符串的名称使用

D B G E T P R O P( ) 可以返回有关当前数据库中连接的其他内容

示例

下列示例假设一个名为 M y F o x S Q L N T 的 O D B C 数据源可用并且数据源的用户标识

是 sa 示例打开 tes tdata 数据库创建一个名为 M y c o n n 的连接然后用 L I S T

C O N N E C T I O N S 来列出数据库中的命名连接C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' d a t a \ t e s t d a t a ' )

C R E A T E C O N N E C T I O N M y c o n n D A T A S O U R C E " M y F o x S Q L N T " U S E R I D " s a "

C L E A R

L I S T C O N N E C T I O N S & & 列出数据库中的命名连接

请参阅

C R E A T E C O N N E C T I O N , D E L E T E C O N N E C T I O N , D B G E T P R O P ( ) ,D I S P L A Y C O N N E C T I O N S , R E N A M E C O N N E C T I O N

L I S T D A T A B A S E 命令

连续显示有关当前数据库的信息

语法

L I S T D A T A B A S E[ T O P R I N T E R [ P R O M P T ] | T O F I L E F i l e N a m e ][ N O C O N S O L E ]

参数描述

T O P R I N T E R [ P R O M P T ]将 L I S T D A T A B A S E 的输出结果送到打印机

在 V i s u a l F o x P r o 中包含 P R O M P T 子句可在打印启动之前显示打印对话框 P R O M P T

应紧接着放置在 T O P R I N T E R 的后面

T O F I L E F i l e N a m e将 L I S T D A T A B A S E 的输出结果送到 F i l e N a m e 指定的文件中若该文件已

存在并且 S E T S A F E T Y 为 O N 则 V i s u a l F o x P r o 询问是否改写文件


说明

使用 D B G E T P R O P( ) 可以返回有关当前数据库的其他内容

示例

下例创建了一个命名为 peop le 的数据库表 f r i ends 被创建并自动添加到数据库中

D I S P L A Y T A B L E S 命令用来显示数据库中的表而 L I S T D A T A B A S E S 命令列出数据

库中表的相关信息C R E A T E D A T A B A S E p e o p l eC R E A T E T A B L E f r i e n d s ( F i r s t N a m e C ( 2 0 ) , L a s t N a m e C ( 2 0 ) )C L E A RD I S P L A Y T A B L E S & & 显示数据库中的表

L I S T D A T A B A S E & & 列出表的信息

请参阅

D I S P L A Y D A T A B A S E

L I S T D L L S 命令

连续显示有关信息 D L L 函数可用 D E C L A R E - D L L 命令在 V i s u a l F o x P r o 中注册

语法

L I S T D L L S[ T O P R I N T E R [ P R O M P T ] | T O F I L E F i l e N a m e ][ N O C O N S O L E ]

参数描述

T O P R I N T E R [ P R O M P T ]将 L I S T D L L S 的输出结果送到打印机

在 V i s u a l F o x P r o 中包含 P R O M P T 子句可在打印之前显示打印对话框 P R O M P T

应直接放置在 T O P R I N T E R 后面

T O F I L E F i l e N a m e将 L I S T D L L S 的输出结果送到 F i l e N a m e 指定的文件中若该文件已存在并

且 S E T S A F E T Y 为 O N 则 V i s u a l F o x P r o 询问是否改写文件


请参阅

D E C L A R E – D L L , D I S P L A Y D L L S

L I S T O B J E C T S 命令

连续显示有关一个对象或一组对象的信息

语法

L I S T O B J E C T S[ L I K E c O b j e c t S k e l e t o n ][ T O P R I N T E R [ P R O M P T ] | T O F I L E F i l e N a m e ][ N O C O N S O L E ]

参数描述

L I K E c O b j e c t S k e l e t o n显示一组对象的信息 c O b j e c t S k e l e t o n 是对象梗概支持通配符 * 和 ?例如要连续显示所有以 A 开头的对象可使用下列命令

L I S T O B J E C T S L I K E A *

T O P R I N T E R [ P R O M P T ]将 L I S T O B J E C T S 的输出结果送到打印机

包含 P R O M P T 子句可在打印之前显示打印对话框 P R O M P T 关键字应直接放置在

T O P R I N T E R 后面

T O F I L E F i l e N a m e将 L I S T O B J E C T S 的输出结果送到 F i l e N a m e 指定的磁盘文件中若该文件

已存在并且 S E T S A F E T Y 为 O N 则 V i s u a l F o x P r o 询问是否改写文件


说明

L I S T O B J E C T S 显示全部现有对象的下列信息

• 属性和属性值

• 方法

• 成员对象及其所基于的类或子类

• 对象所基于的类或子类

• 对象的类等级

L I S T O B J E C T S 连续不停顿地填满整个 V i s u a l F o x P r o 主窗口

示例

下面的示例用 D E F I N E C L A S S CREATEOBJECT( ) 从 Visual F o x P r o 的 Form 基类中

创建了两个自定义类 F o r m C h i l d 与 F o r m G r a n d C h i l d L I S T O B J E C T S 列出了对象和

它们的属性信息C L E A Rf r m M y F o r m = C R E A T E O B J E C T ( " F o r m G r a n d C h i l d " )

L I S T O B J E C T S L I K E f r m *R E L E A S E f r m M y F o r m

D E F I N E C L A S S F o r m C h i l d A S F O R ME N D D E F I N E

D E F I N E C L A S S F o r m G r a n d C h i l d A S F o r m C h i l dE N D D E F I N E

请参阅

D I S P L A Y O B J E C T S

L I S T P R O C E D U R E S 命令

连续显示当前数据库内部存储过程的名称

语法

L I S T P R O C E D U R E S[ T O P R I N T E R [ P R O M P T ] | T O F I L E F i l e N a m e ][ N O C O N S O L E ]

参数描述

T O P R I N T E R [ P R O M P T ]将 L I S T P R O C E D U R E S 的返回信息输出到打印机

包含 P R O M P T 可在打印之前显示打印对话框 P R O M P T 关键字应直接放置在 T O

P R I N T E R 后面

T O F I L E F i l e N a m e将 L I S T P R O C E D U R E S 的输出信息送到 F i l e N a m e 指定的磁盘文件中若该

文件已存在并且 S E T S A F E T Y 为 O N 则 V i s u a l F o x P r o 询问是否改写文件


说明

用 M O D I F Y P R O C E D U R E S 可创建内部存储过程

示例

下面示例打开 t e s tda ta 数据库并且使用 L I S T P R O C E D U R E S 列出数据库中的内部存

储过程如果存在C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' d a t a \ t e s t d a t a ' )

C L E A R

L I S T P R O C E D U R E S & & 列出数据库中的内部存储过程

请参阅

A P P E N D P R O C E D U R E S , C O P Y P R O C E D U R E S , C R E A T E D A T A B A S E ,DISPLAY D A T A B A S E , D I S P L A Y P R O C E D U R E S , M O D I F Y P R O C E D U R E

L i s t 属性

用来访问组合框或列表框控件中各数据项的字符串数组设计时不可用运行时可读

写

语法

C o n t r o l.L i s t ( n R o w [ , n C o l] ) [ = c C h a r]参数描述

n R o w根据显示顺序指定需要检索的数据项所在的行例如 n R o w = 3 指定在列表

中显示第三行

n C o l根据显示顺序指定需要检索的数据项所在的列例如 n C o l = 2 指定在列表

中显示第二列若未指定 n C o l 则 L i s t 属性默认检索第一列只能对多于一

列的组合框和列表框指定 n C o l说明

可将 L i s t 属性与 L i s t C o u n t 属性联合使用从 1 到 L i s t C o u n t 逐一返回列表中的所有

项

不能同时使用 L i s t 属性和数组函数然而如果 R o w S o u r c e T y p e 属性设置为 5 数

组并且 R o w S o u r c e 属性设置为列表中值所在的数组则可对 R o w S o u r c e 属性指定的

数组使用数组函数

注意当 R o w S o u r c e T y p e 设置为 0 或 1 时可以用 A d d I t e m 方法向组合框或

列表框中添加数据项要删除数据项可使用 R e m o v e I t e m 方法要

按字母顺序放置数据项可在向列表添加数据项之前将控件的 S o r t e d属性设置为真 ( .T .)

示例

在下面示例中使用 L i s t C o u n t 遍历所有数据项这些数据项由组合框或列表框的 L i s t

属性指定

下面示例创建了一个列表框列表框数据项中的数据项源是一个数组该数组用

R o w S o u r c e T y p e 和 R o w S o u r c e 属性指定

列表框的 M u l t i S e l e c t 属性设置为真 ( .T . ) 允许从列表框中做多项选择在 F O R . . .

E N D F O R 循环中使用 L i s t C o u n t 属性来显示列表框中选定的数据项 S e l e c t e d 属性用来

确定所选择的数据项 Lis t 属性用来返回数据项C L E A R

D I M E N S I O N g a M y L i s t A r r a y ( 1 0 )F O R g n C o u n t = 1 t o 1 0 & & 用字母填充数组

S T O R E R E P L I C A T E ( C H R ( g n C o u n t + 6 4 ) , 6 ) T O g a M y L i s t A r r a y ( g n C o u n t )E N D F O R

f r m M y F o r m = C R E A T E O B J E C T ( ' F o r m ' ) & & 创建一个表单f r m M y F o r m . C l o s a b l e = . F . & & 使控件数据框无效

f r m M y F o r m . M o v e ( 1 5 0 , 1 0 ) & & 移动表单

* 添加取消命令按钮f r m M y F o r m . A d d O b j e c t ( ' c m b C o m m a n d 1 ' , ' c m d M y C m d B t n ' )f rmMyForm.AddOb jec t ( ' l s t L i s tBox1 ' , ' l s tMyL i s tBox ' )

* & & 指定一个数组f r m M y F o r m . l s t L i s t B o x 1 . R o w S o u r c e T y p e = 5f r m M y F o r m . l s t L i s t B o x 1 . R o w S o u r c e = ' g a M y L i s t A r r a y '

f r m M y F o r m . c m b C o m m a n d 1 . V i s i b l e = . T . & & 取消命令按钮可见f r m M y F o r m . l s t L i s t B o x 1 . V i s i b l e = . T . & & 列表框可见


D E F I N E C L A S S c m d M y C m d B t n A S C o m m a n d B u t t o n & & 创建命令按钮C a p t i o n = ' \ <Qu i t ' && 命令按钮标题C a n c e l = . T . & & 默认取消命令按钮 ( E s c )L e f t = 1 2 5 & & 命令按钮列T o p = 2 1 0 & & 命令按钮行H e i g h t = 2 5 & & 命令按钮高度

P R O C E D U R E C l i c kC L E A R E V E N T S & & 终止事件处理关闭表单C L E A R & & 清除 V i s u a l F o x P r o 主窗口

E N D D E F I N E

D E F I N E C L A S S l s t M y L i s t B o x A S L i s t B o x & & 创建列表框控件

L e f t = 1 0 & & 列表框列T o p = 1 0 & & 列表框行M u l t i S e l e c t = . T . & & 允许选择多于 1 个数据项

P R O C E D U R E C l i c kA C T I V A T E S C R E E NC L E A R? "Se lec ted i t ems : "? "- - - - - - - - - - - - - - -"F O R n C n t = 1 T O T h i s F o r m . l s t L i s t B o x 1 . L i s t C o u n t

I F T h i s F o r m . l s t L i s t B o x 1 . S e l e c t e d ( n C n t ) & & 是否选择了数据项 ?? S P A C E ( 5 ) + T h i s F o r m . l s t L i s t B o x 1 . L i s t ( n C n t ) & & 显示数据项


E N D D E F I N E

应用于

组合框列表框

请参阅

A d d I t e m 方法 , I n d e x T o I t e m I D 方法 , I t e m I D T o I n d e x 方法 , L i s t C o u n t 属性 ,L i s t I t e m 属性 , L i s t I t e m I D 属性 , R o w S o u r c e , R o w S o u r c e T y p e , S o r t e d 属性

L I S T T A B L E S 命令

连续显示包含在当前数据库中的所有表和表的信息

语法

L I S T T A B L E S[ T O P R I N T E R [ P R O M P T ] | T O F I L E F i l e N a m e ][ N O C O N S O L E ]

参数描述

T O P R I N T E R [ P R O M P T ]将 L I S T T A B L E S 的返回内容输出到打印机

包含 P R O M P T 可在打印之前显示打印对话框 P R O M P T 关键字应直接放置在 T O

P R I N T E R 之后

T O F I L E F i l e N a m e将 L I S T T A B L E S 的输出结果送到 F i l e N a m e 指定的磁盘文件中若文件已存

在并且 S E T S A F E T Y 为 O N 则 V i s u a l F o x P r o 询问是否改写文件 .N O C O N S O L E

不向 V i s u a l F o x P r o 主窗口或活动的用户自定义窗口输出

说明

此命令返回的信息中包括表名和路径是 L I S T S T A T U S 显示内容的子集 L I S T

T A B L E S 显示的信息仅包含与表有关的信息而不管表是否打开

示例

下面示例打开 tes tdata 数据库中的 c u s t o m e r 表用 L I S T T A B L E S 命令列出数据库中关

于表的信息

C L O S E D A T A B A S E SS E T P A T H T O ( H O M E ( 2 ) + ' d a t a \ ' ) & & 设置到数据库路径O P E N D A T A B A S E t e s t d a t a & & 打开 tes tdata 数据库C L E A R

L I S T T A B L E S & & 列出表单信息

请参阅

A D D T A B L E , C L O S E D A T A B A S E S , C R E A T E D A T A B A S E , D I S P L A YT A B L E S ,O P E N D A T A B A S E , R E M O V E T A B L E

L I S T V I E W S 命令

连续显示当前数据库中有关 S Q L 视图的信息

语法

L I S T V I E W S[ T O P R I N T E R [ P R O M P T ] | T O F I L E F i l e N a m e ][ N O C O N S O L E ]

参数描述

T O P R I N T E R [ P R O M P T ]将 L I S T V I E W S 返回的内容输出到打印机

包含 P R O M P T 可在打印开始之前显示打印对话框 P R O M P T 关键字应直接放置在

T O P R I N T E R 后面

T O F I L E F i l e N a m e将 L I S T V I E W S 输出的结果送到 F i l e N a m e 指定的磁盘文件中若文件已存

在并且 S E T S A F E T Y 为 O N 则 V i s u a l F o x P r o 询问是否改写文件


说明

L I S T V I E W S 显示当前数据库中 S Q L 视图的名称并且说明 S Q L 视图是基于本地表还

是远程表使用 D B G E T P R O P ( ) 可以返回当前数据库中关于 S Q L 视图的其他内容

可用 C R E A T E S Q L V I E W 创建 S Q L 视图

示例

下面的示例打开数据库 t es tda ta 用 C R E A T E S Q L V I E W 创建一个本地的 S Q L 视图

m y v i e w 显示视图设计器以允许您指定 S Q L 视图的表和条件保存了所创建的

S Q L 视图后数据库中有关 S Q L 视图的信息会被列出C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' d a t a \ t e s t d a t a ' )C R E A T E S Q L V I E W m y v i e w

C L E A R

L I S T V I E W S

请参阅

C R E A T E D A T A B A S E 命令 , C R E A T E S Q L V I E W 命令 , DBGETPROP( ) ,

D I S P L A Y D A T A B A S E 命令 , D I S P L A Y V I E W S 命令

L i s t B o x 控件

创建列表框

语法

L i s t B o x说明

列表框显示一系列数据项从中可选择一项或多项列表框与组合框相似不同的

是组合框初始时只显示一个数据项

属性

A p p l i c a t i o n B a s e C l a s s B o r d e r C o l o rB o u n d C o l u m n B o u n d T o C l a s sC l a s s L i b r a r y C o l o r S c h e m e C o l o r S o u r c eC o l u m n C o u n t C o l u m n L i n e s C o l u m n W i d t h sC o m m e n t C o n t r o l S o u r c e D i s a b l e d B a c k C o l o rD i s a b l e d F o r e C o l o r D i s a b l e d I t e m B a c k C o l o r D i s a b l e d I t e m F o r e C o l o rD i s p l a y V a l u e D r a g I c o n D r a g M o d eE n a b l e d F i r s t E l e m e n t F o n t B o l dF o n t C o n d e n s e F o n t E x t e n d F o n t I t a l i cF o n t N a m e F o n t O u t l i n e F o n t S h a d o wF o n t S i z e F o n t S t r i k e T h r u F o n t U n d e r L i n eH e i g h t H e l p C o n t e x t I D I n c r e m e n t a l S e a r c hI n t e g r a l H e i g h t I t e m B a c k C o l o r I t e m D a t a

I t e m F o r e C o l o r I t e m I D D a t a I t e m T i p sL e f t L i s t L i s t C o u n tL i s t I n d e x L i s t I t e m L i s t I t e m I DM o u s e I c o n M o u s e P o i n t e r M o v e r B a r s

续表

M u l t i S e l e c t N a m e N e w I n d e xN e w I t e m I D N u l l D i s p l a y N u m b e r O f E l e m e n t sO L E D r a g M o d e O L E D r a g P i c t u r e O L E D r o p E f f e c t sO L E D r o p H a s D a t a O L E D r o p M o d e P a r e n tP a r e n t C l a s s P i c t u r e R i g h t T o L e f tR o w S o u r c e R o w S o u r c e T y p e S e l e c t e dS e l e c t e d I D S e l e c t e d I t e m B a c k C o l o r S e l e c t e d I t e m F o r e C o l o rS o r t e d S p e c i a l E f f e c t S t a t u s B a r T e x tT a b I n d e x T a b S t o p T a gT e r m i n a t e R e a d T o o l T i p T e x t T o pT o p I n d e x T o p I t e m I D V a l u eV is ib le W h a t s T h i s H e l p I D W idth

事件

C l i c k D b l C l i c k D e s t r o yD r a g D r o p D r a g O v e r E r r o rE r r o r M e s s a g e G o t F o c u s In i tI n t e r a c t i v e C h a n g e K e y P r e s s L o s t F o c u sM e s s a g e M i d d l e C l i c k E v e n t M o u s e D o w nM o u s e M o v e M o u s e U p M o u s e W h e e l

续表

O L E C o m p l e t e D r a g O L E D r a g D r o p O L E D r a g O v e rO L E G i v e F e e d B a c k O L E S e t D a t a O L E S t a r t D r a gP r o g r a m m a t i c C h a n g e R a n g e H i g h R a n g e L o wR i g h t C l i c k U I E n a b l e V a l i dW h e n

方法

A d d I t e m A d d L i s t I t e m A d d P r o p e r t yC l e a r C l o n e O b j e c t D r a gI n d e x T o I t e m I D I t e m I D T o I n d e x M o v eO L E D r a g R e a d E x p r e s s i o n R e a d M e t h o dR e f r e s h R e m o v e I t e m R e m o v e L i s t I t e mR e q u e r y R e s e t T o D e f a u l t S a v e A s C l a s sS e t F o c u s W r i t e E x p r e s s i o n W r i t e M e t h o dZ O r d e r

示例

下面的示例创建了一个列表框控件列表框中的项的源是由 R o w S o u r c e T y p e 和

R o w S o u r c e 属性指定的数组

设置列表框的 M u l t i S e l e c t 属性为真 ( .T.) 这样您就可以在列表框中有多个选择可以

用 L i s t C o u n t Se lec t ed 和 L i s t 属性决定在列表和所选的项中项的数目显示项或所

选的项

C L E A R

D I M E N S I O N g a M y L i s t A r r a y ( 1 0 )F O R g n C o u n t = 1 t o 1 0 & & 在数组中填充字母

S T O R E R E P L I C A T E ( C H R ( g n C o u n t + 6 4 ) , 6 ) T O g a M y L i s t A r r a y ( g n C o u n t )N E X T

f r m M y F o r m = C R E A T E O B J E C T ( ' F o r m ' ) & & 创建表单f r m M y F o r m . C l o s a b l e = . f . & & 取消控件目录箱作用


f r m M y F o r m . A d d O b j e c t ( ' c m b C o m m a n d 1 ' , ' c m d M y C m d B t n ' ) & & 增加退出命令按扭f r m M y F o r m . A d d O b j e c t ( ' l s t L i s t B o x 1 ' , ' l s t M y L i s t B o x ' ) & & 增加 L i s t B o x 控件

f r m M y F o r m . l s t L i s t B o x 1 . R o w S o u r c e T y p e = 5 & & 指定一个数组f r m M y F o r m . l s t L i s t B o x 1 . R o w S o u r c e = ' g a M y L i s t A r r a y ' & & 数组包括 l i s tbox 项目

f r m M y F o r m . c m b C o m m a n d 1 . V i s i b l e = . T . & &使退出命令按扭可见f r m M y F o r m . l s t L i s t B o x 1 . V i s i b l e = . T . & & 使 L i s t B o x 可见

f r m M y F o r m . S H O W & & 显示表单R E A D E V E N T S & & 启动事件程序

D E F I N E C L A S S c m d M y C m d B t n A S C o m m a n d B u t t o n & & 创建命令按扭C a p t i o n = ' \ < Q u i t ' & & 给命令按扭增加说明C a n c e l = . T . & &默认取消命令按扭 ( E s c 键 )L e f t = 1 2 5 & & 命令按扭列T o p = 2 1 0 & & 命令按扭行H e i g h t = 2 5 & & 命令按扭高

P R O C E D U R E C l i c kC L E A R E V E N T S & & 终止事件程序关闭表单C L E A R & & 清除 Visual 主窗口

E N D D E F I N E

D E F I N E C L A S S l s t M y L i s t B o x A S L i s t B o x & & 创建 L i s t B o x 控件 lL e f t = 1 0 & & L i s t B o x 列T o p = 1 0 & & L i s t B o x 行M u l t i S e l e c t = . T . & & 允许多项选择

P R O C E D U R E C l i c kA C T I V A T E S C R E E NC L E A R? "Se lec ted i t ems : "? "- - - - - - - - - - - - - - -"F O R n C n t = 1 T O T h i s F o r m . l s t L i s t B o x 1 . L i s t C o u n t

I F T h i s F o r m . l s t L i s t B o x 1 . S e l e c t e d ( n C n t ) & &该项目被选否 ?? S P A C E ( 5 ) + T h i s F o r m . l s t L i s t B o x 1 . L i s t ( n C n t ) & & 显示项目


E N D D E F I N E

请参阅


L i s t C o u n t 属性

存放组合框或列表框控件的列表中的项数设计时不可用运行时只读

语法

C o n t r o l.L i s t C o u n t示例

下面的示例创建了一个列表框列表框中的项的源是由 R o w S o u r c e T y p e 和 R o w S o u r c e

属性指定的数组

L i s t C o u n t 用于对组合框或列表框的 L i s t 属性指定的所有项进行循环遍历

设置列表框的 M u l t i S e l e c t 属性为真 ( .T.) 这样您就可以在列表框中有多个选择在

FOR ... E N D F O R 循环中用 L i s t C o u n t 属性可显示项或在列表框中所选的项可用

S e l e c t e d 和 L i s t 属性来决定选择的项C L E A R



f r m M y F o r m = C R E A T E O B J E C T ( ' F o r m ' ) & &创建一个表单

f r m M y F o r m . C l o s a b l e = . f . & & 取消控件菜单的作用


f r m M y F o r m . A d d O b j e c t ( ' c m b C o m m a n d 1 ' , ' c m d M y C m d B t n ' ) & & A d d 增加退出命令按扭f r m M y F o r m . A d d O b j e c t ( ' l s t L i s t B o x 1 ' , ' l s t M y L i s t B o x ' ) & & 增加 l i s t box 控件 l

f r m M y F o r m . l s t L i s t B o x 1 . R o w S o u r c e T y p e = 5 & & 指定一个数组f r m M y F o r m . l s t L i s t B o x 1 . R o w S o u r c e = ' g a M y L i s t A r r a y ' & & 包含 l i s tbox 项目的数组

f r m M y F o r m . c m b C o m m a n d 1 . V i s i b l e = . T . & & 使退出命令按扭可见f r m M y F o r m . l s t L i s t B o x 1 . V i s i b l e = . T . & & 使 L i s t B o x 可见

f r m M y F o r m . S H O W & & 显示表单R E A D E V E N T S & & 启动事件程序

D E F I N E C L A S S c m d M y C m d B t n A S C o m m a n d B u t t o n & & 创建命令按扭C a p t i o n = ' \ < Q u i t ' & & 给命令按扭增加说明C a n c e l = . T . & & 默认取消命令按扭 ( E s c 键 )L e f t = 1 2 5 & & 命令按扭列T o p = 2 1 0 & & 命令按扭行H e i g h t = 2 5 & & 命令按扭高

P R O C E D U R E C l i c kC L E A R E V E N T S & & 终止事件程序关闭表单C L E A R & & 清除 Visual 主窗口

E N D D E F I N E

D E F I N E C L A S S l s t M y L i s t B o x A S L i s t B o x & & 创建 L i s t B o x 控件 lL e f t = 1 0 & & L i s t B o x 列T o p = 1 0 & & L i s t B o x 行M u l t i S e l e c t = . T . & & 允许选择多项

P R O C E D U R E C l i c kA C T I V A T E S C R E E NC L E A R? "Se lec ted i t ems : "? "- - - - - - - - - - - - - - -"F O R n C n t = 1 T O T h i s F o r m . l s t L i s t B o x 1 .L i s t C o u n t

I F T h i s F o r m . l s t L i s t B o x 1 . S e l e c t e d ( n C n t ) & & 该项是否被选? S P A C E ( 5 ) + T h i s F o r m . l s t L i s t B o x 1 . L i s t ( n C n t ) & & 显示项


E N D D E F I N E

应用于

组合框列表框

请参阅

A d d I t e m 方法 , L i s t 属性 , L i s t I t e m I D 属性 , R e m o v e I t e m 方法

L i s t I n d e x 属性

指定组合框或列表框中选定数据项的索引号设计时不可用运行时可读写

语法

C o n t r o l.L i s t I n d e x [ = n I n d e x ]设置

n I n d e xL i s t I n d e x 属性的设置是

设置说明

0 默认值指示没有选定数据项对组合框来说这说明用户输

入了列表中没有的值

1 . . .

L i s t C o u n t

选定数据项的索引

说明

下面显示了选定数据项的字符串? L i s t (MyL is t .L i s t Index )

使用控件的 V a l u e 属性可返回相同的值

应用于

组合框列表框

请参阅

A d d I t e m 方法 , A d d L i s t I t e m 方法 , I n d e x T o I t e m I D 方法 , I t e m I D T o I n d e x 方法 ,

L i s t 属性 , L i s t I t e m 属性 , R e m o v e I t e m 方法 , V a l u e 属性

L i s t I t e m 属性

该属性是一个字符串数组用于通过 I D 值访问组合框或列表框控件中的数据项设

计时不可用运行时可读写

语法

C o n t r o l.L i s t I t e m (n I t e m I D )[ = c C h a r]设置

n I t e m I D使用数据项的唯一标识 ( I D ) 指定数据项

说明

L i s t I t e m 属性与 L i s t C o u n t 属性联合使用从 1 到 L i s t C o u n t 逐一返回列表中的所有

项使用 L i s t 属性可按显示顺序检索数据项使用 L i s t I t e m 属性可按项的标识检索

项

注意要向组合框或列表框中添加数据项可使用 A d d I t e m 或 A d d L i s t I t e m 方法要删除项可使用 R e m o v e I t e m 或 R e m o v e L i s t I t e m 方法要按字

母顺序放置项在向列表中添加项之前设置控件的 S o r t e d 属性为

真 ( .T .)

应用于

组合框列表框

请参阅


L i s t C o u n t 属性 , L i s t 属性 , L i s t I t e m I D 属性

L i s t I t e m I D 属性

指定组合框或列表框控件中选定项的唯一标识号设计时不可用运行时可读写

语法

C o n t r o l.L i s t I t e m I D [ = n I t e m I D ]

设置

n I t e m I DL i s t I t e m I D 属性的设置和说明是

设置说明

– 1 指示没有选定项对于组合框这说明用户输入了列表中没有

的值

续表

1 (或大于 1

的任何数 )

选定项的项标识

说明

设计时不可用运行时可读写若用 R e m o v e L i s t I t e m 方法从列表中删除一项则所有

剩余项都保持各自的标识号当用 A d d I t e m 方法向列表中添加项并且 S o r t e d 属性设置

为假 ( .F . ) 时指定 nI t emID 为可用的最低值当用 A d d L i s t I t e m 方法向列表中添加

项并且 S o r t e d 属性设置为假 ( .F . ) 时可指定 nI t emID 为任何数

应用于

组合框列表框

请参阅


L i s t C o u n t 属性 , L i s t 属性 , L i s t I t e m 属性 , R e m o v e I t e m 方法 , R e m o v e L i s t I t e m 方法

_ L M A R G I N 系统变量

包含此变量是为了提供向后兼容性可用报表设计器代替

L O A D 命令

包含此变量是为了提供向后兼容性可用 S E T L I B R A R Y 代替

L o a d 事件

在创建对象前发生

语法

P R O C E D U R E O b j e c t. L o a d

[ L P A R A M E T E R S n I n d e x ]参数描述

n I n d e x唯一地标识控件数组中的某个控件

说明

L O A D 事件先为表单集发生然后再为其包含的表单发生 L o a d 事件先于 A c t i v a t e 和

G o t F o c u s 事件发生

为了避免创建表单 L o a d 事件返回 fa l se ( .F . ) 不执行 D e s t r o y 事件

应用于

表单表单集

请参阅

A c t i v a t e 事件 , G o t F o c u s 事件 , U n l o a d 事件

L O A D P I C T U R E ( ) 函数

为位图文件图标文件或 W i n d o w s 图元文件 ( W i n d o w s m e t a f i l e ) 创建一个对象

语法

L O A D P I C T U R E ( [ c F i l e N a m e] )返值类型

对象

参数描述

c F i l e N a m e指定位图文件 ( . B M P ) 图标文件 ( . I C O )或 W i n d o w s 图元文件 ( .W M F ) 如果

省略 c F i l e N a m e 则返回一个空图对象不是 . N U L L . 您可以用

G E T P I C T ( ) 做为 c F i l e N a m e 这样函数运行时将开启打开对话框您

可以从中选取您需要的位图文件 ( . B M P )说明

许多 A c t i v e X 控件要求使用对象作为其设置例如 A c t i v e X O u t l i n e 控件的

P i c t u r e O p e n 属性就需要一个对象作为其设置

请参阅

G E T P I C T ( ) , SAVEPICTURE( )

L O C A L 命令

创建局部变量和变量数组

语法

L O C A L V a r L i s t–或者 –L O C A L [ A R R A Y ] A r r a y N a m e 1 (n R o w s 1 [ , n C o l u m n s 1 ] )

[ , A r r a y N a m e 2 (n R o w s 2 [ , n C o l u m n s 2 ] ) ] . . .参数描述

V a r L i s t指定要创建的一个或多个局部变量

[ A R R A Y ] A r r a y N a m e 1 ( n R o w s 1 [ , n C o l u m n s 1 ] )[ , A r r a y N a m e 2 ( n R o w s 2 [ , n C o l u m n s 2 ] ) ] . . .

指定要创建的一个或多个局部数组有关每个参数的说明请参阅

D I M E N S I O N说明

局部变量和变量数组只能在创建它们的过程或函数中使用和更改不能被高层或低层

程序访问一旦包含局部变量和数组的过程或函数执行完毕则这些局部变量和数组

将被释放

用 L O C A L 创建的变量和数组都初始化为假 (.F.) 必须在赋值之前把变量或数组

声明为局部若在用 L O C A L 声明一个变量或数组为局部变量或数组之前对该变量

或数组进行赋值则 V i s u a l F o x P r o 产生错误信息

局部变量可以由引用方式传递

不能缩写 L O C A L 因为 L O C A L 和 L O C A T E 的前四个字母相同

请参阅

D I M E N S I O N , F U N C T I O N , L P A R A M E T E R S , P A R A M E T E R S ,

P A R A M E T E R S ( ) , P R I V A T E , P U B L I C , R E L E A S E

L O C A T E 命令

按顺序搜索表从而找到满足指定逻辑表达式的第一个记录

语法

L O C A T E F O R l E x p r e s s i o n 1[S c o p e ][W H I L E ][ N O O P T I M I Z E ]

参数描述

F O R l E x p r e s s i o n 1L O C A T E 按顺序搜索当前表以找到满足逻辑表达式 l E x p r e s s i o n 1 的第一个记

录

若 l E x p r e s s i o n 1 是可优化表达式则 R u s h m o r e 优化由 L O C A T E F O R 创建的查询为

了获得最佳执行效果可在 F O R 子句中使用可优化表达式



S c o p e指定要定位的记录范围只有范围内的记录才被定位 S c o p e 子句有

A L L N E X T n R e c o r d s R E C O R D n R e c o r d N u m b e r 和 R E S T 包含 S c o p e 的命令只能在活动工作区中的表上操作

L O C A T E 的默认范围是所有 ( A L L ) 记录

W H I L E l E x p r e s s i o n 2指定一个条件只要逻辑表达式 l E x p r e s s i o n 2 计算值为真 ( . T . ) 就继续

查找记录

N O O P T I M I Z E关闭 L O C A T E 的 R u s h m o r e 优化

详细内容请参阅稍后的 S E T O P T I M I Z E 命令与 Microsoft Visual F o x P r o6 .0 中文版程序员指南第十五章优化应用程序中的掌握 R u s h m o r e 技术

说明

被搜索的表不必已有索引

若 L O C A T E 发现一个满足条件的记录可使用 R E C N O ( ) 返回该记录号若发现满足

条件的记录则 F O U N D ( ) 返回真 ( .T.) E O F ( ) 返回假 ( .F.) 若 S E T T A L K

是 O N 则显示满足条件的记录号

L O C A T E 发现一个满足条件的记录之后可执行 C O N T I N U E 从而在表的剩余部分

寻找其他满足条件的记录当执行 C O N T I N U E 时搜索操作从满足条件的记录的下

一条记录开始继续执行可重复执行 C O N T I N U E 直到到达范围边界或表尾

若找不到满足条件的记录则 R E C N O ( ) 返回表中的记录数加 1 F O U N D ( ) 返回

假 ( .F.) E O F( ) 返回真 ( .T.)

L O C A T E 和 C O N T I N U E 只能用于当前工作区若选择了另一工作区则当重选原来

的工作区时可继续原来的搜索过程

示例

下面的示例定位了来自德国的顾客记录并且显示总数C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' D a t a \ t e s t d a t a ' )U S E c u s t o m e r & & 打开 C u s t o m e r 表S E T T A L K O F F

S T O R E 0 T O g n C o u n t

L O C A T E F O R A L L T R I M ( U P P E R ( c u s t o m e r . c o u n t r y ) ) = ' G E R M A N Y 'D O W H I L E F O U N D ( )

g n C o u n t = g n C o u n t + 1? c o m p a n yC O N T I N U E

E N D D O

? ' T o t a l c o m p a n i e s G e r m a n y : ' + L T R I M ( S T R ( g n C o u n t ) )

请参阅

C O N T I N U E , E O F ( ) , F I N D , FOUND( ) , INDEXSEEK( ) , RECNO( ) , S E E K ,

SEEK( ) , S E T O P T I M I Z E

L O C F I L E ( ) 函数

在磁盘上定位文件并返回带有路径的文件名

语法

L O C F I L E (c F i l e N a m e [ , c F i l e E x t e n s i o n s] [ , c F i l e N a m e C a p t i o n ] )返值类型

字符型

参数描述

c F i l e N a m e指定要定位的文件名称如果 c F i l e N a m e 只包含文件名 L O C F I L E ( ) 函数将

首先搜索 V i s u a l F o x P r o 的默认目录或文件夹如果在默认目录或文件夹中找

不到该文件则搜索 V i s u a l F o x P r o 路径可以用 S E T P A T H 命令指定 V i s u a lF o x P r o 路径

如果 c F i l e N a m e 包含路径及文件名则在指定的位置搜索如果在指定的位置上没有找

到该文件 L O C F I L E ( ) 函数将先搜索 V i s u a l F o x P r o 默认目录或文件夹然后再搜索

V i s u a l F o x P r o 路径

如果已定位了该文件 L O C F I L E ( ) 返回文件名与路径

c F i l e E x t e n s i o n s指定要定位文件的扩展名如果用 c F i l e N a m e 指定的文件名不含扩展名

V i s u a l F o x P r o 将把 c F i l e E x t e n s i o n s 中列出的各个文件扩展名作为该文件的扩

展名并再作搜索

c F i l e E x t e n s i o n s 还可以指定当不能定位指定的文件时在打开对话框中显示的文件

的扩展名

c F i l e E x t e n s i o n s 可以有不同的形式

• 如果 c F i l e E x t e n s i o n s 包含单个扩展名例如 P R G 则只显示具有此扩

展名的文件

• c F i l e E x t e n s i o n s 还可以包含通配符 * 与 ? 此时显示扩展名满足通配符

条件的所有文件例如如果 c F i l e E x t e n s i o n s 为 ? X ? 则所有具有扩展

名 . F X P .E X E 或 . T X T 的文件都将显示出来

• 在 V i s u a l F o x P r o f o r W i n d o w s 中 c F i l e E x t e n s i o n s 可以包含一个文件说

明后面跟一个文件扩展名或者跟一组逗号分隔的文件扩展名该文件

说明出现在文件类型列表框中文件说明和扩展名之间用冒号 ( :) 分隔多个文件说明和扩展名之间用分号 ( ; ) 分隔

例如如果 c F i l e E x t e n s i o n s 为 “文本文件 : T X T ” 说明 “ 文本文件 ” 会出

现在文件类型列表框中并且还会显示所有以 . t x t 为后缀的文件

如果 c F i l e E x t e n s i o n s 为 “ 表 :D B F ; 文件 : T X T , B A K ” 说明 “ 表 ” 和 “ 文件 ”会出现在文件类型列表框中从文件类型列表框中选择 “ 表 ”时会显示所有以 . d b f 为后缀的文件从文件类型列表框中选择

“文件 ” 时会显示所有以 . t x t 和 . b a k 为后缀的文件

c F i l e N a m e C a p t i o n指定用来提示用户的文本该文本出现在输入文件名的文本框的左侧如果

省略本参数则显示文件名

关于 Visual F o x P r o 的文件扩展名与相应的创建程序类型请参阅帮助中的文件扩

展名与文件类型

说明

如果在默认目录或文件夹下在 V i s u a l F o x P r o 路径上以及指定位置上都无法找到该文

件将显示打开对话框该对话框可用于定位文件当从对话框中选定某个文件

时返回带有文件路径的文件名

如果选择取消按 E S C 键或从控制菜单上选择关闭而退出打开对话框

V i s u a l F o x P r o 将产生错误信息 L O C F I L E ( ) 也不会返回值

请参阅

F I L E ( ), GETFILE( ), GETPICT( ), PUTFILE( ) , S E T P A T H

L O C K ( ) 函数

尝试锁定表中一个或更多的记录

语法

L O C K ( [ n W o r k A r e a | c T a b l e A l i a s ]| [ c R e c o r d N u m b e r L i s t , n W o r k A r e a | c T a b l e A l i a s ] )

返值类型

逻辑值

参数描述

n W o r k A r e a | c T a b l e A l i a s尝试锁定指定工作区中已打开表的当前记录 n W o r k A r e a 指定工作区号

c T a b l e A l i a s 指定表别名如果不指定工作区和表别名 L O C K ( ) 函数尝试锁

定当前工作区中的表的当前记录

c R e c o r d N u m b e r L i s t尝试锁定多个记录时指定必须包含的一个或更多记录编号的列表 S E TM U L T I L O C K S 必须为 O N 并且必须要包含给多个记录加锁的工作区或表的别

名

L O C K ( ) 函数尝试锁定您所指定的所有记录 c R e c o r d N u m b e r L i s t 指定的记录编号之间

用逗号分隔例如尝试给某表的前四个记录加锁时 c R e c o r d N u m b e r L i s t 应为 1 ,2 ,3 ,4

若要锁定多个记录可以对其中的每一个记录重复下列步骤移动记录指针指向要锁

定的记录再发出 L O C K ( ) 或 R L O C K ( ) 命令

在 V i s u a l F o x P r o 中可以将 0 指定为记录编号指定 0 时试图锁定表头

警告锁定表头的时间应尽可能地短因为表头锁定时其他用户不能向表中添加

记录

可以用 U N L O C K R E C O R D 0 U N L O C K 或 U N L O C K A L L 命令解除对表头的锁定

如果在 c R e c o r d N u m b e r s 中指定的所有记录均锁定成功 L O C K ( ) 函数返回真

( .T.) 由 c R e c o r d N u m b e r s 指定的记录中即使有一个记录不能锁定 L O C K ( ) 函数也将

返回假 ( .F . ) 并且不锁定任何记录不过原来已有的记录锁仍保留原样多个记

录的锁定是一个叠加过程设置额外的记录锁并不释放对其他记录的锁定

在一个工作区中可以锁定的最大记录数约为 8 0 0 0 锁定整个表的速度总是比只锁定一

部分记录要快

说明

L O C K ( ) 函数与 R L O C K ( ) 函数等价

如果成功地设置了锁定和解锁则 L O C K ( ) 返回真 ( .T.) 设置锁定的用户对锁定

的记录有读写权限而网络上的其他用户有只读权限

执行 L O C K ( ) 函数并不保证记录锁设置成功不能对已由另一用户锁定的记录或位于

其他用户锁定的表中的记录设置记录锁如果由于某种原因不能设置记录锁 L O C K ( )

函数将返回假 ( .F.)

在默认情况下 L O C K ( ) 函数尝试锁定记录一次使用 S E T R E P R O C E S S 命令可以在

第一次尝试失败后自动地重设记录锁 S E T R E P R O C E S S 确定初始锁定失败时锁定操

作的尝试次数或锁定尝试应当持续的时间详细内容请参阅稍后的

SET R E P R O C E S S 命令

S E T M U L T I L O C K S 决定能否锁定表中的多个记录如果 S E T M U L T I L O C K S 为 O F F

默认值则只能锁定表中的单个记录而 S E T M U L T I L O C K S 为 O N 时可以锁

定表中的多个记录详细内容请参阅稍后的 S E T M U L T I L O C K S 命令

对记录解锁表记录只能由设置锁定的用户进行解锁发出 U N L O C K 命令关闭表或

退出 Visual F o x P r o 都可以释放记录锁定

U N L O C K 可用于释放当前工作区指定的工作区或所有工作区中的记录锁定详细内

容请参阅稍后的 U N L O C K 命令

将 S E T M U L T I L O C K S 从 O N 转换到 O F F 或从 O F F 转换到 O N 即隐含地执行了

U N L O C K A L L 释放所有工作区中的记录锁定

可以用 U S E C L E A R A L L 或 C L O S E D A T A B A S E S 命令来关闭表

有关网络上的记录文件锁定和共享表的详细内容请参阅 Microsoft Visual F o x P r o

6 .0 中文版程序员指南的第十七章共享访问程序设计

示例

下面的示例对 c u s t o m e r 和 e m p l o y e e 表中的前四个记录设置锁定和解锁C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' d a t a \ t e s t d a t a ' )S E T R E P R O C E S S T O 3 A U T O M A T I CS T O R E ' 1 , 2 , 3 , 4 ' T O g c R e c L i s tg c O l d E x c = S E T ( ' E X C L U S I V E ' )S E T E X C L U S I V E O F FS E L E C T 0U S E e m p l o y e e & & 打开 E m p l o y e e 表S E L E C T 0U S E c u s t o m e r & & 打开 C u s t o m e r 表? L O C K ( ' 1 ,2 ,3 ,4 ' , ' cus tomer ') & & 锁住 c u s t o m e r 表的前四个记录? R L O C K ( g c R e c L i s t , ' e m p l o y e e ' ) & & 锁住 e m p l o y e e 表的前四个记录U N L O C K I N c u s t o m e rU N L O C K I N e m p l o y e eS E T E X C L U S I V E & g c O l d E x c

请参阅

C L E A R , C L O S E , F L O C K ( ), RLOCK( ) , S E T M U L T I L O C K S , S E T

R E P R O C E S S , U N L O C K , U S E

L o c k S c r e e n 属性

确定表单是否以批处理方式执行对表单及所含对象属性设置的更改设计和运行时可

用

语法

O b j e c t.L o c k S c r e e n [ = l E x p r]参数描述

l E x p rL o c k S c r e e n 属性的设置有

设置说明

真

( .T . )

表单及其包含的对象以批处理方式反映对属性设置的更改或者说

在同一时刻反映而不是在更改后立即反映

假

( .F.)

默认值表单及其包含的对象在对属性设置更改后立即反映出更

改

说明

需要在运行时对 B a c k C o l o r F o n t N a m e 等显示属性进行更改应设置 L o c k S c r e e n 为

真 ( .T.) 以减少令人厌烦的屏幕刷新动作

L o c k S c r e e n 属性不能防止对表单的更改立即反应出来例如即使 L o c k S c r e e n 属性设

置为真在调用 M o v e 方法时表单会被移动

注意如果设置 L o c k S c r e e n 为假 ( . F . ) 将重画表单及其所有的控件

应用于

表单 _ S C R E E N 工具栏

请参阅

P a i n t 事件

L O G ( ) 函数

返回给定数值表达式的自然对数底数为 e

语法

L O G ( n E x p r e s s i o n )返值类型

数值型

参数描述

n E x p r e s s i o n指定的数值表达式 L O G ( ) 函数返回方程 e x = n E x p r e s s i o n 中的 x 值n E x p r e s s i o n 必须大于 0说明

自然对数以常数 e 为底在返回的结果中小数的位数由 S E T D E C I M A L S 命令指

定

示例

C L E A R? L O G (1 ) & & 显示 0 . 0 0S T O R E E X P ( 2 ) T O g n e S q u a r e? L O G (g n e S q u a r e ) & & 显示 2 . 0 0

请参阅

E X P ( ), LOG10( ) , S E T D E C I M A L S

L O G 1 0 ( ) 函数

返回给定数值表达式的常用对数以 1 0 为底

语法

L O G 1 0 ( n E x p r e s s i o n )返值类型

数值型

参数描述

n E x p r e s s i o n指定的数值表达式 L O G 1 0 ( ) 函数返回方程 1 0 x = n E x p r e s s i o n 中的 x 值n E x p r e s s i o n 必须大于 0

说明

常用对数以 1 0 为底在返回的结果中小数的位数由 S E T D E C I M A L S 命令指定

示例

C L E A R? L O G 1 0 (1 0 ) & & 显示 1 . 0 0S T O R E 1 0 0 T O g n B a s e T e n? L O G 1 0 (g n B a s e T e n ) & & 显示 2 . 0 0? L O G 1 0 (g n B a s e T e n ^ 2 ) & & 显示 4 . 0 0

请参阅

E X P ( ), LOG( ) , S E T D E C I M A L S

L O O K U P ( ) 函数

在表中搜索字段值与指定表达式匹配的第一个记录

语法

L O O K U P ( R e t u r n F i e l d , e S e a r c h E x p r e s s i o n , S e a r c h e d F i e l d [ , c T a g N a m e] )返值类型

字符型数值型货币型浮点型整型双精度型日期型日期时间型或逻辑

型

参数描述

R e t u r n F i e l d指定的一个字段搜索成功时 L O O K U P ( ) 函数返回此字段中的内容如果

搜索不成功 L O O K U P ( ) 函数返回与 R e t u r n F i e l d 长度和数据类型都相同的

空字符串

e S e a r c h E x p r e s s i o n指定搜索表达式搜索表达式常常是表中某个字段的内容或者与活动索引

或复合索引标识的索引表达式相对应

S e a r c h e d F i e l d指定要搜索的字段如果该表没有活动索引 L O O K U P ( ) 函数对由

S e a r c h e d F i e l d 指定的字段执行顺序搜索

如果打开的某个索引文件或索引标识的索引关键字表达式正是您指定的搜索字段

L O O K U P ( ) 函数将利用索引文件或索引标识执行快速搜索

c T a g N a m e指定 L O O K U P ( ) 函数在搜索时使用的复合索引标识名复合索引搜索是

L O O K U P ( ) 函数所能执行的最快的搜索方式

说明

如果搜索成功 L O O K U P ( ) 函数移动记录指针指向匹配记录并返回该记录中指定字

段的内容

如果没有找到搜索表达式 L O O K U P( ) 函数返回与 Re turnF ie ld 长度和数据类型相同

的空字符串并将记录指针定位在文件尾

如果使用 L O O K U P( ) 在父表中搜索则把所有相关子表的记录指针移动到相关记录

上

本函数不能用 R u s h m o r e 优化

示例

在下面的示例中 L O O K U P ( ) 函数使用索引标识 c o m p a n y 搜索字符串 " E r n s t H a n d e l "

的第一次出现如果搜索成功 L O O K U P ( ) 函数返回字段 c o n t a c t 的内容并由 @ .. .

S A T 命令显示这个返回值C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' d a t a \ t e s t d a t a ' )U S E c u s t o m e r O R D E R c o m p a n y & & 打开 C u s t o m e r 表C L E A R@ 2 , 2 S A Y L O O K U P ( c o n t a c t , ' E r n s t H a n d e l ' , c o m p a n y , ' c o m p a n y ')

请参阅

F I N D , I N D E X , L O C A T E , S E E K , S E E K ( )

L o s t F o c u s 事件

当某个对象失去焦点时发生

语法

P R O C E D U R E O b jec t .L o s t F o c u s[ L P A R A M E T E R S n I n d e x ]参数描述

n I n d e x唯一地标识控件数组中的一个控件

说明

这一事件发生的时间取决于对象的类型

• 控件由于用户的操作而失去焦点这类操作包括选中另一个控件或在另一个

控件上单击或在代码中用 S e t F o c u s 方法更改焦点表格由于用户在

M i c r o s o f t 窗口下击 C T R L + T A B 键或在 M a c i n t o s h 机上击 C O N T R O L + T A B 键

退出时失去焦点

• 只有当表单不包含任何控件或者所包含的所有控件的 E n a b l e d 和 V i s ib le属性的设置均为假 ( .F . ) 时表单失去控件或者另一个表单获得焦点

对于表单 L o s t F o c u s 事件在 D e a c t i v a t e 事件之前发生

应用于

复选框组合框命令按钮容器对象控件对象编辑框表单列表框

O L E 绑定型控件 O L E 容器控件选项按钮微调文本框

请参阅

D e a c t i v a t e 事件 , E n a b l e d 属性 , G o t F o c u s 事件 , V i s i b l e 属性

L O W E R ( ) 函数

以小写字母形式返回指定的字符表达式

语法

L O W E R (c E x p r e s s i o n )返值类型

字符型

参数描述

c E x p r e s s i o n指定要由 L O W E R ( ) 函数转换的字符表达式

说明

L O W E R ( ) 函数将字符表达式中所有的大写字母 (A – Z ) 转换为小写字母 ( a – z ) 字符表

达式中的其他字符保持不变

示例

S T O R E ' F O X ' T O g c N a m eC L E A R? L O W E R (g c N a m e) & & 显示 f o x

请参阅

I S A L P H A ( ), ISLOWER( ), ISUPPER( ), PROPER( ), UPPER( )

L P A R A M E T E R S 命令

将调用程序传入的数据赋给局部变量或数组

语法

L P A R A M E T E R S P a r a m e t e r L i s t

参数描述

P a r a m e t e r L i s t为接收数据的局部变量或数组指定名称

在 P a r a m e t e r L i s t 中参数之间用逗号分隔在 L P A R A M E T E R S 语句中至少应有与

D O . . . W I T H 语句中同样多的参数如果在 L P A R A M E T E R S 语句中列出的变量或数组

的数目多于 D O . . . W I T H 语句传递的参数数目则多出的变量初始化为假 ( .F.) 最

多可以传递 2 7 个参数

可以使用 P A R A M E T E R S ( ) 函数确定向最近一次执行的程序过程或用户自定义函数

传递的参数数目

说明

L P A R A M E T E R S 命令在被调用的程序过程或用户自定义函数中创建局部变量和数组

可用 P A R A M E T E R S 命令创建私有变量和数组

如果向程序过程或用户自定义函数传递值变量或者数组那么 L P A R A M E T E R S

必须是被调用程序过程或用户自定义函数的第一条可执行语句

默认情况下 D O . . . W I T H 以引用传递方式向过程传递变量和数组在被调用过程中

更改某个值时新的值将传递回调用程序中相关的变量和数组如果希望以值传递方

式向过程传递某一变量或数组应在 D O . . . W I T H 语句的参数列表中用圆括号将该变

量或数组括起来此时被调用过程中参数的任何更改都不会传递回调用程序

在默认情况下变量以引用传递方式传递给过程以值传递方式传递给用户自定义函

数可以用 S E T U D F P A R M S T O R E F E R E N C E 指定以引用传递方式向用户自定义函数

传递变量

请参阅

D O , F U N C T I O N , L O C A L , P A R A M E T E R S , P A R A M E T E R S ( ) , P R I V A T E ,P R O C E D U R E , P U B L I C , S E T U D F P A R M S

L T R I M ( ) 函数

删除指定字符表达式的前导空格后返回

语法

L T R I M (c E x p r e s s i o n )返值类型

字符型

参数描述

c E x p r e s s i o n指定的字符表达式 L T R I M ( ) 函数将删除其前导空格

说明

当使用 S T R ( ) 函数将数值转换为字符串时可能会插入前导空格本函数对于删除这

些前导空格很有用

示例

S T O R E ' R e d m o n d ' T O g c C i t yS T O R E ' W a s h i n g t o n ' T O g c S t a t eC L E A R? g c C i t y , g c S t a t e & &显示 R e d m o n d W a s h i n g t o n? gcC i t y , L T R I M (g c S t a t e ) & &显示 R e d m o n d W a s h i n g t o n

请参阅

A L L T R I M ( ), LEFT( ), RIGHT( ), RTRIM( ), SUBSTR( ), TRIM( )

L U P D A T E () 函数

返回一个表最近更新的日期

语法

L U P D A T E ( [ n W o r k A r e a | c T a b l e A l i a s ] )返值类型

日期型

参数描述

n W o r k A r e a | c T a b l e A l i a s返回在某一工作区中打开的表最近一次更改的日期 n W o r k A r e a 指定工作区

号 c T a b l e A l i a s 指定表别名如果省略 n W o r k A r e a 和 c T a b l e A l i a s

L U P D A T E ( ) 函数返回当前选定工作区中的表最近一次更新的日期

如果指定的工作区中没有表打开 L U PD A T E ( ) 函数返回空日期如果不存在具有指定

别名的表 V i s u a l F o x P r o 将产生错误信息

说明

本函数在更新过程中很有用

注意在早期版本的 V i s u a l F o x P r o 中表最后更新的年的后两个数字保存在表头中

由于只保存了后两个数字所以无法确定该表更新的世纪默认值为二十世纪

在 Visual F o x P r o 6 . 0 中 L U P D A T E ( ) 询问 W i n d o w s 以确定表更新的日期允许确

定表更新的世纪但是表最后更新的年的后两个数字仍保存在表头中

示例

C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' d a t a \ t e s t d a t a ' )U S E c u s t o m e r & & 打开表 C u s t o m e rC L E A R? L U P D A T E ( ) & & 显示最近一次更新的日期

请参阅

D I R , F D A T E ( ), FTIME( )

_ M A C 系统变量

如果用户使用的是 F o x P r o f o r M a c i n t o s h 或 Microsoft Visual F o x P r o f o r M a c i n t o s h 则为

真 ( .T . )

语法

_ M A C = l E x p r e s s i o n说明

对于任何其他平台的 FoxPro (Visual F o x P r o f o r W i n d o w s F o x P r o f o r W i n d o w s F o x P r o

f o r M S- D O S 或 F o x P r o f o r U N I X ) _ M A C 为假

不能使用 S T O R E 或 = 更改 _ M A C 中包含的值

请参阅

_ D O S , _ U N I X , V E R S I O N ( ) , _W I N D O W S

M a c D e s k t o p 属性

指定表单是否放置在 V i s u a l F o x P r o 主窗口中

语法

O b j e c t.M a c D e s k t o p [ = n V a l u e ]

参数描述

n V a l u eM a c D e s k t o p 属性设置为

设置说明

0 默认值自动根据 S E T M A C D E S K T O P 命令的设置确定表单是否

包含在 Visual F o x P r o 主窗口中如果 S E T M A C D E S K T O P 为 O N 表单

位于 M a c i n t o s h 桌面的顶部如果设置为 O F F 则表单包含在

Visual F o x P r o 主窗口中

1 M a c i n t o s h 桌面表单位于 M a c i n t o s h 桌面的顶部并且可以在移动和调

整大小时独立于 Visual F o x P r o 主窗口

2 Visual F o x P r o 桌面表单包含在 Visual F o x P r o 主窗口中并且不能移

动到外面去

说明

设置 M a c D e s k t o p 属性可以覆盖使用 S E T M A C D E S K T O P 命令对单个表单进行的设

置 S E T M A C D E S K T O P 影响用户自定义窗口表单和系统窗口例如浏览查看

和表单设计器窗口在默认情况下用户自定义窗口的行为遵循 SET M A C D E S K T O P

的设置

M a c D e s k t o p 属性使您能控制您的应用程序更象 M ac in tosh 还是更像 W i n d o w s

应用于

表单

请参阅

S E T K E Y C O M P

M a i n C l a s s 属性

包含项目中设置为主程序的 A c t i v e D o c 类的名称只读

语法

O b j e c t.M a i n C l a s s说明

在一个 A c t i v e D o c 类上单击鼠标右键并且从快捷菜单中选择设置为主程序命

令可以将这个 A c t i v e D o c 类设置为主程序只有基于 A c t i v e D o c 基类的类才可以设

置为主程序程序或表单也可以设置为主程序使用 M a i n F i l e 属性可以确定 . v c x 可

视类库其中包含了设置为主程序的 A c t i v e D o c 类

如果主程序没有设置为 A c t i v e D o c 类则 M a i n C l a s s 包含空字符串

用 S e t M a i n 方法来更改主文件和主类

应用于

项目对象

请参阅

M a i n F i l e 属性 , S e t M a i n 方法

M ainF i l e 属性

包含项目中设置为主程序的文件的名称和路径只读

语法

O b j e c t.M a i n F i l e说明

如果项目没有设置主程序则 M a i n F i l e 包含空字符串程序表单或 A c t i v e D o c 类可

以设置为项目的主程序需要在程序表单或 A c t i v e D o c 类上单击鼠标右键并且从

快捷菜单中选择设置为主程序命令也可以使用 S e t M a i n 方法通过编程指定项目

的主程序

如果一个 A c t i v e D o c 类被设置为主程序则 M ainF i l e 包含 . v c x 可视类库其中包含该

类的名称和路径使用 M a i n C l a s s 属性可以确定设置为项目的主程序的 A c t i v e D o c

类

应用于

项目对象

请参阅

M a i n C l a s s 属性 , S e t M a i n 方法

M a r g i n 属性

为控件的文本部分指定应留的空白宽度设计和运行时可用

语法

C o n t r o l.M a r g i n [ = n V a l u e ]参数描述

n V a l u e为控件的文本部分指定应留的空白

说明

使用 M arg in 属性来指定控件中的文本位置 M a r g i n 属性在控件内部创建空白它并

不影响控件本身的大小

应用于

组合框编辑框微调文本框

请参阅

A l i g n m e n t 属性

M A X () 函数

比较几个表达式的值并返回其中具有最大值的表达式

语法

M A X ( e E x p r e s s i o n 1 , e E x p r e s s i o n 2 [ , e E x p r e s s i o n 3 . . . ] )返值类型

字符型数值型货币型双精度型浮点型日期型或日期时间型

参数描述

e E x p r e s s i o n 1 , e E x p r e s s i o n 2 [ , e E x p r e s s i o n 3 . . . ]指定的若干个表达式 M A X ( ) 返回其中具有最大值的表达式所有表达式

必须为同一数据类型

示例

下列示例使用 A P P E N D B L A N K 创建一个包含 1 0 个记录的表其中的值是任意的

然后使用和 MAX( ) 函数显示表中的最大和最小值

C L O S E D A T A B A S E SC R E A T E T A B L E R a n d o m ( c V a l u e N ( 3 ) )F O R n I t e m = 1 T O 1 0 & & A p p e n d 1 0 r e c o r d s ,

A P P E N D B L A N KR E P L A C E c V a l u e W I T H 1 + 1 0 0 * R A N D ( ) & & 插入任意值

E N D F O R

C L E A RL I S T & & 显示值g n M a x i m u m = 1 & & 初始化最小值g n M i n i m u m = 1 0 0 & & 初始化最大值S C A N

g n M i n i m u m = M I N ( g n M i n i m u m , c V a l u e )g n M a x i m u m = M A X (g n M a x i m u m , c V a l u e )

E N D S C A N? ' T h e m i n i m u m v a l u e i s : ' , g n M i n i m u m & & 显示最小值? ' T h e m a x i m u m v a l u e i s : ' , g n M a x i m u m & & 显示最大值

请参阅

C A L C U L A T E , M I N ( ) , S E L E C T – S Q L

M a x B u t t o n 属性

指定表单是否含有最大化按钮设计和运行时可用

语法

O b j e c t.M a x B u t t o n [ = l E x p r]参数描述

l E x p rM a x B u t t o n 属性的设置为

设置说明

真

( .T . )

默认值表单有最大化按钮

假

( .F.)

表单没有最大化按钮

说明

最大化按钮允许用户将表单扩大到整屏

最大化按钮在窗口最大时自动变为还原按钮当窗口最小或者还原时自动将还原按

钮变为最大化按钮

M a x B u t t o n M i n B o t t o n B o r d e r S t y l e 和 C o n t r o l B o x 属性的设置值只有在运行时才起作

用

在运行时最大化表单将触发 R e s i z e 事件

注意 W i n d o w S t a t e 属性反映了窗口的当前状态如果将窗口状态设置为 2最大化表单将最大化而不管 M a x B u t t o n 和 B o r d e r S t y l e 属性中的

设置

应用于


请参阅

B o r d e r S t y l e 属性 , C o n t r o l B o x 属性 , M i n B u t t o n 属性 , R e s i z e 事件 , TitleBar 属

性 , W i n d o w S t a t e 属性

M a x H e i g h t 属性

决定表单可能的最大高度设计和运行时可用

语法

O b j e c t.M a x H e i g h t [ = n H e i g h t]参数描述

n H e i g h t表单的最大高度度量单位由表单的 S c a l e M o d e 属性指定

说明

当调整表单大小时无论是选择控件菜单的大小命令还是拖动表单的边框表单

的高度将不会超过 M a x H e i g h t 属性的设定值

M a x H e i g h t 的默认设置为 -1 即没有指定最大高度

应用于


请参阅

S c a l e M o d e 属性

M a x L e f t 属性

指定表单从 V i s u a l F o x P r o 主窗口左侧边缘处开始的最大可能距离设计和运行时可

用

语法

O b jec t .M a x L e f t [ = n M a x L e f t ]参数描述

n M a x L e f t指定 V i s u a l F o x P r o 主窗口的左边界与最大化表单左边界间的距离度量单位

由表单的 S c a l e M o d e 属性指定

说明

用 M a x L e f t 属性来保证最大化表单在运行时不会离 V i s u a l F o x P r o 主窗口左边界太远

应用于


请参阅

M a x T o p 属性 , M a x W i d t h 属性 , M i n H e i g h t 属性 , S c a l e m o d e 属性

M a x L e n g t h 属性

指定允许在编辑框中输入字符的最大长度设计和运行时可用

语法

C o n t r o l . M a x L e n g t h [ = n M a x L e n g t h ]参数描述

n M a x L e n g t h可输入到编辑框中的最大字符数若 n M a x L e n g t h 设置为 0 那么输入到编辑

框的字符数目没有限制

说明

可使用 M a x L e n g t h 来限制用户输入编辑框的字符数目当 M a x L e n g t h 大于 0 时

M a x L e n g t h 只适用于文本框文本框不使用 I n p u t M a s k 属性并且它的 V a l u e 属性是

字符类型

应用于

编辑框文本框

请参阅

S e l L e n g t h 属性

M a x T o p 属性

指定最大化表单与 V i s u a l F o x P r o 主窗口上边界之间的距离设计和运行时可用

语法

O b jec t .M a x T o p [ = n M a x T o p ]参数描述

n M a x T o p指定最大化表单上边界与 V i s u a l F o x P r o 主窗口上边界之间的距离度量单位

由表单的 S c a l e M o d e 属性指定

说明

在 Visual F o x P r o f o r t h e M a c i n t o s h 中忽略此属性

用 M a x T o p 属性来确保在运行时刻最大化的表单不会移动到与 V isua l FoxPro 主窗口

的顶部太近的地方

应用于


请参阅

M a x L e f t 属性 , M a x W i d t h 属性 , M i n H e i g h t 属性 , M i n W i d t h 属性 , S c a l e m o d e属性

M a x W i d t h 属性

指定表单的最大宽度设计和运行时可用

语法

O b jec t .M a x W i d t h [ = n M a x W i d t h ]参数描述

n M a x W i d t h指定表单的最大宽度度量单位由表单的 S c a l e M o d e 属性指定

说明

调整表单时无论是选用控件菜单中的大小命令还是拖动表单的边框表单的宽

度都不会大于 M a x W i d t h 属性中设置的值 M a x W i d t h 的默认设置为 -1 即没有指定最

大宽度

应用于


请参阅

M a x H e i g h t 属性 , M i n H e i g h t 属性 , M i n W i d t h 属性 , S c a l e M o d e 属性

M C O L () 函数

返回鼠标指针在 V i s u a l F o x P r o 主窗口或用户自定义窗口中的列位置

语法

M C O L ( [ c W i n d o w N a m e [ , n S c a l e M o d e ] ] )返值类型

数值型

参数描述

c W i n d o w N a m e指定窗口名 M C O L ( ) 函数返回鼠标指针在该窗口中的列位置

若省略 c W i n d o w N a m e 且不存在活动的用户自定义窗口将返回鼠标指针在

V i s u a l F o x P r o 主窗口中的列位置若省略 c W i n d o w N a m e 且存在活动的用户

自定义窗口则返回鼠标指针在活动的用户自定义窗口中的列位置如果鼠

标指针位于用户自定义窗口之外则返回 - 1 如果未安装鼠标驱动程序且

没有输出窗口则返回 - 1

n S c a l e M o d e设定 M C O L ( ) 返回值所使用的度量单位

n S c a l eM o d e

描述

0 默认 F o x e l s f o x e l 的大小是当前表单中字型宽与高的平均值

当开发可在字符平台和图形平台上跨平台运行的应用程序时 f o x e l

十分有用

3 像素像素是屏幕和打印机的最小分辨单位在不同的屏幕中像

素的大小不同

请参阅

A M O U S E O B J ( ), COL( ) , G r i d H i t T e s t 方法 , INKEY( ), ISMOUSE( ) ,MROW( ), ROW( ), WCOLS( ), WROWS( )

M D 或 M K D I R 命令

在磁盘上创建一个新目录或子目录

语法

M D c P a t h | M K D I R c P a t h参数描述

c P a t h指定一条路径含驱动器指示符和目录或目录

若 cPa th 是不含驱动器指示符的目录将把该目录创建为当前 V i s u a l F o x P r o 默认目录

的子目录

说明

如果试图创建一个已存在的目录 V i s u a l F o x P r o 将产生错误信息

示例

下面的示例用 M K D I R 创建了一个新目录 my t s td i r 使用 C H D I R 转到新目录

GETDIR( ) 用于显示目录结构然后用 R M D I R 删除新建目录再用 GETDIR( ) 来显

示目录结构S E T D E F A U L T T O H O M E ( ) & & 恢复 V i s u a l F o x P r o 目录

M K D I R m y t s t d i r & &创建一个新目录C H D I R m y t s t d i r & & 进入新目录= G E T D I R ( ) & & 显示选择目录对话框S E T D E F A U L T T O H O M E ( ) & & 恢复 V i s u a l F o x P r o 目录R M D I R m y t s t d i r & & 移动新目录= G E T D I R ( ) & & 显示选择目录对话框

请参阅

C D | C H D I R , D I R E C T O R Y , D I R E C T O R Y ( ), GETDIR( ), HOME( ) , R D |RMDIR, SET D E F A U L T , S E T P A T H , S Y S ( 5 ) , S Y S ( 2 0 0 3 ) , S Y S ( 2 0 0 4 )

M D I F o r m 属性

指定表单是否为 M D I 界面多文档界面包含此命令是为了提供向后兼容性

M D O W N () 函数

确定鼠标键是否按下并返回真 ( .T.) 或假 ( .F.)

M D X () 函数

根据指定的索引编号返回打开的 . C D X 复合索引文件名

语法

M D X ( n I n d e x N u m b e r [ , n W o r k A r e a | c T a b l e A l i a s ] )返值类型

字符型

参数描述

n I n d e x N u m b e r指定的索引编号返回复合索引文件名若表含有一个结构复合索引文件并

且 n I n d e x N u m b e r 为 1 将返回结构复合索引文件名它总是与表的名称相

同 ) 若 n I n d e x N u m b e r 为 2 将返回 U S E 或 S E T I N D E X 命令指定的第一个

复合索引文件名若 n I n d e x N u m b e r 为 3 将返回第二个复合索引文件名依

次类推若 n I n d e x N u m b e r 大于打开的复合索引文件数则返回空字符串

如果表没有结构复合索引文件并且 nIndexNumber 为 1 则返回 U S E 或 S E T I N D E X 命令指

定的第一个复合索引文件若 nIndexNumber 为 2 将返回第二个复合索引文件名依次类

推若 nIndexNumber 大于打开的复合索引文件数将返回空字符串

n W o r k A r e a指定不在当前工作区打开的复合索引文件所在的工作区号若省略这个可选

参数将返回当前工作区中的复合索引文件名

c T a b l e A l i a s指定不在当前工作区中打开的复合索引文件的表别名若省略该可选参数

将返回当前工作区中打开的复合索引文件名

说明

MDX( ) 等同于 CDX( )

使用含 I N D E X 子句的 U S E 命令或 S E T I N D E X 命令均可为表打开索引文件结构复

合索引文件自动随表打开 M D X ( ) 忽略用 U S E 或 S E T I N D E X 指定的任何 . I D X 索引

文件

T A G ( ) 函数可以返回复合索引文件中的标识名用 N D X ( ) 返回打开的 . I D X 索引文件

名

当 S E T F U L L P A T H 为 O N 时 M D X ( ) 返回含 . C D X 文件名的路径当 S E T

F U L L P A T H 为 O F F 时 M D X ( ) 返回 . C D X 文件所在的驱动器指示符及 . C D X 文件

名

请参阅

C D X ( ), INDEX, NDX( ), SET INDEX, SET FULLPATH, SYS(14), TAG( ) ,U S E

M D Y () 函数

以月 -日 -年格式返回指定日期或日期时间表达式其中月份名不缩写

语法

M D Y ( d E x p r e s s i o n | t E x p r e s s i o n )返值类型

字符型

参数描述

d E x p r e s s i o n指定要返回的日期表达式表达式用月 -日 -年格式表示

t E x p r e s s i o n指定要返回的日期时间表达式表达式用月 -日 -年格式表示

说明

若 S E T C E N T U R Y 为 O F F 按 m o n t h d d ,yy 格式返回字符表达式若 S E T C E N T U R Y

为 O N 返回格式为 m o n t h d d , y y y y

示例

下面的示例创建了一个用户自定义函数该函数返回星期的相应日期S E T C E N T U R Y O F F

C L E A R? L o n g d a t e ( { ^ 1 9 9 8 - 0 2 - 1 6 } ) & & 显示星期一 1 9 9 8 年 2 月 1 6 日

S E T C E N T U R Y O N? L o n g d a t e ( { ^ 1 9 9 8 - 0 2 - 1 6 } ) & & 显示星期一 1 9 9 8 年 2 月 1 6 日

* * * L o n g D a t e * * *

F U N C T I O N l o n g d a t eP A R A M E T E R S g d D a t eR E T U R N C D O W ( g d D a t e ) + ' , ' + M D Y ( g d D a t e )

请参阅

D M Y ( ) , S E T C E N T U R Y , S E T D A T E

M E M L I N E S ( ) 函数

返回备注字段中的行数

语法

M E M L I N E S (M e m o F i e l d N a m e )返值类型

数值型

参数描述

M e m o F i e l d N a m e指定的备注字段名若备注字段所在表不在当前工作区中打开则应在字段

名前加上表的别名和一个句点

说明

备注字段中的行数由 S E T M E M O W I D T H 的当前值决定

示例

下面的示例从 e m p l o y e e 表中扫描 3 个记录并使用 M E M L I N E S ( ) 确定 n o t e s 备注字

段中是否有数据并确定何时分页显示记录 l a s t _ n a m e 字段中的数据并显示 n o t e s

字段如果此备注字段有数据或者显示消息指示该记录没有 n o t e sC L O S E D A T A B A S E SC L E A R

S E T T A L K O F FC L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' D a t a \ t e s t d a t a ' )U S E e m p l o y e e & & 打开 E m p l o y e e 表

S E T M E M O W I D T H T O 6 5g n L i n e = 1G O T O 2S C A N N E X T 3

g n M e m o S i z e = M E M L I N E S (n o t e s)I F g n M e m o S i z e = 0

S T O R E . T . T O g l N o M e m oS T O R E 1 T O g n M e m o S i z e

E L S ES T O R E . F . T O g l N o M e m o

E N D I FI F g n L i n e + g n M e m o S i z e > 6 5

E J E C Tg n L i n e = 1

E N D I F@ g n L i n e , 2 S A Y ' L a s t N a m e : ' + l a s t _ n a m eg n L i n e = g n L i n e + 1@ g n L i n e , 2 S A Y ' n o t e s : '? ? I I F ( g l N o M e m o , ' N o n o t e s ' , n o t e s )g n L i n e = g n L i n e + g n M em o S i z e + 2I F g n L i n e > 2 4

g n L i n e = 1C L E A R

E N D I F

E N D S C A N

请参阅

A L I N E S ( ), MLINE( ) , S E T M E M O W I D T H

M E M O R Y () 函数

返回可供外部程序运行的内存大小

语法

MEMORY( )返值类型

数值型

说明

在 V i s u a l F o x P r o 中 M E M O R Y ( ) 总是返回 6 4 0 K

M E M O R Y ( ) 类似于 S Y S ( 1 2 ) 但有两点区别

• M E M O R Y ( ) 以千字节为单位返回可用内存数量 S Y S ( 1 2 ) 以字节为单位返

回内存数量

• M E M O R Y ( ) 返回数值表达式 S Y S ( 1 2 )以字符串形式返回它的值

请参阅

S Y S ( 1 2 ) , S Y S ( 1 0 0 1 )

M e m o W i n d o w 属性

包含此命令是为了提供向后兼容性可用编辑框控件代替

M E N U 命令

创建菜单系统包含此命令是为了提供向后兼容性可使用菜单设计器创建菜单

M E N U () 函数

以大写字符串形式返回活动菜单栏的名称

语法

MENU( )返值类型

字符型

说明

没有活动菜单时 M E N U ( ) 返回空字符串用菜单设计器可创建并激活菜单

示例

下面的示例用 MENU( ) 将菜单栏的名称传递到过程中用 S E T S Y S M E N U S A V E 在

内存中保存当前的系统菜单栏而用 S E T S Y S M E N U T O 删除所有的系统菜单标题

用 D E F I N E P A D 创建了几个系统菜单标题选定了一个菜单标题时 MENU( ) 将

Microsoft Visual F o x P r o 的系统菜单栏的名称 _ M S Y S M E N U 传递到 c h o i c e 过程中

c h o i c e 过程显示所选的菜单标题和系统菜单栏的名称如果选择了退出菜单将

恢复最初的 Visual F o x P r o 系统菜单* * * 在默认 V F P 目录下将此程序保存为 M E N U E X A M . P R G * * *C L E A RS E T S Y S M E N U S A V ES E T S Y S M E N U T OD E F I N E P A D p a d S y s O F _ M S Y S M E N U P R O M P T ' \ < S y s t e m ' C O L O R S C H E M E 3 ;

K E Y A L T + S , ' 'D E F I N E P A D p a d E d i t O F _ M S Y S M E N U P R O M P T ' \ < E d i t ' C O L O R S C H E M E 3 ;

K E Y A L T + E , ' 'D E F I N E P A D p a d R e c o r d O F _ M S Y S M E N U P R O M P T ' \ < R e c o r d ' C O L O R S C H E M E 3 ;

K E Y A L T + R , ' 'D E F I N E P A D p a d W i n d o w O F _ M S Y S M E N U P R O M P T ' \ < W i n d o w ' C O L O R S C H E M E 3 ;

K E Y A L T + W , ' '

D E F I N E P A D p a d R e p o r t O F _ M S Y S M E N U P R O M P T ' R e \ < p o r t s ' C O L O R S C H E M E 3 K E Y A L T + P , ' 'D E F I N E P A D p a d E x i t O F _ M S Y S M E N U P R O M P T ' E \ < x i t ' C O L O R S C H E M E 3 ;

K E Y A L T +X, ' 'O N S E L E C T I O N M E N U _ M S Y S M E N U ;

D O c h o i c e I N m e n u e x a m W I T H P A D ( ) , M E N U ( )P R O C E D U R E c h o i c eP A R A M E T E R g c P a d , g c M e n uW A I T W I N D O W ' Y o u c h o s e ' + g c P a d + ;

' f r o m m e n u ' + g c M e n u N O W A I TI F g c P a d = ' P A D E X I T '

S E T S Y S M E N U T O D E F A U L TE N D I F

请参阅

A C T I V A T E M E N U , C R E A T E M E N U , D E F I N E M E N U

M E N U T O 命令

包含此命令是为了提供向后兼容性可用 V i s u a l F o x P r o 的菜单设计器来创建菜单

M e s s a g e 事件

在屏幕底部的状态栏中显示一条消息包含此命令是为了提供向后兼容性可用

S t a t u s B a r T e x t 属性代替

M E S S A G E () 函数

以字符串形式返回当前错误消息或者返回导致这个错误的程序行内容

语法

M E S S A G E ( [ 1 ] )返值类型

字符型

参数描述

1当在 O N E R R O R 过程中使用 M E S S A G E ( ) 时包含这个参数可以返回导致

这个错误的程序源代码当不能取得程序源代码时 M E S S A G E ( 1 ) 返回下列

内容之一

• 当此行是宏替换时返回整个程序行

• 当此行是不含附加子句的命令时返回该命令

• 当程序行是含附加子句的命令时返回命令以及三个句点 ( . . . )说明

与 E R R O R ( ) 不同 M E S S A G E ( ) 不被 R E T U R N 或 R E T R Y 重置

示例

下面的示例显示了 MESSAGE( ) 和 M E S S A G E ( 1 ) 的输出数值O N E R R O R D O E r r h a n d

*** 下一行可能出现错误 * * *

U S E N o d a t a b a s eO N E R R O R & &恢复系统错误处理P R O C E D U R E E r r h a n d? ' L i ne o f code w i t h e r r o r : ' + M E S S A G E ( 1 )? ' E r r o r n u m b e r : ' + S T R ( E R R O R ( ) )? ' E r r o r m e s s a g e : ' + M E S S A G E ( )

请参阅

E R R O R ( ) , O N E R R O R

M E S S A G E B O X ( ) 函数

显示一个用户自定义对话框

语法

M E S S A G E B O X (c M e s s a g e T e x t [ , n D i a l o g B o x T y p e [ , c T i t l e B a r T e x t] ] )返值类型

数值型

参数描述

c M e s s a g e T e x t指定在对话框中显示的文本在 c M e s s a g e T e x t 包含回车符 ( C H R ( 1 3 ) ) 可以使

消息移到下一行显示对话框的高度和宽度会根据 c M e s s a g e T e x t 适当增大

以包含全部消息

n D i a l o g B o x T y p e指定对话框中的按钮和图标显示对话框时的默认按钮以及对话框的行为

在下面的表中对话框按钮值从 0 到 5 指定了对话框中显示的按钮图标值 1 6 3 2

6 4 指定了对话框中的图标默认值 0 2 5 6 5 1 2 指定对话框中哪个按钮为默认按钮

当显示对话框时此默认按钮被首先选中

当省略 n D i a l a g B o x T y p e 时等同于指定 n D i a l o g B o x T y p e 值为 0

数值对话框按钮

0 仅有确定按钮

1 确定和取消按钮

2 放弃重试和忽略按钮

3 是否和取消按钮

4 是否按钮

5 重试和取消按钮

数值图标

1 6 停止图标

3 2 问号

4 8 惊叹号

6 4 信息 ( i ) 图标

数值默认按钮

0 第一个按钮

2 5 6 第二个按钮

5 1 2 第三个按钮

n D i a l o g B o x T y p e 可以是三个值的和 -从上面每个表中选一个值例如若

n D i a l o g B o x T y p e 为 2 9 0 2 + 3 2 + 2 5 6 则指定的对话框含有如下特征

• 放弃重试或忽略按钮

• 消息框显示问号图标

• 第二个按钮重试为默认按钮

c T i t l e B a r T e x t指定对话框标题栏中的文本若省略 c T i t l e B a r T e x t 标题栏中将显示

M i c r o s o f t V i s u a l F o x P r o说明

M E S S A G E B O X ( ) 的返回值标明选取了对话框中的哪个按钮在含有取消按钮的对话

框中如果按下 E S C 键退出对话框则与选取取消按钮一样返回值 ( 2 )

注意本函数的最短缩写为 M E S S A G E B ( )

下表列出了 M E S S A G E B O X ( ) 对应每个按钮的返回值

返回值按钮

1 确定 (O K )

2 取消 ( C A N C E L )

3 放弃 ( A B O R T )

4 重试 ( R E T R Y )

5 忽略 ( I G N O R E )

6 是 ( Y E S )

7 否 ( N O )

示例

下面的示例显示了一个用户自定义的对话框该用户自定义的对话框的标题是

R e c o r d n o t f o u n d . W o u l d y o u l i k e t o s e a r c h a g a i n ? 并且标题栏是 M y

A p p l i c a t i o n

这个用户自定义的对话框含有 Y e s 和 N o 按钮还有问号图标并且第二个按钮 ( N o )

是默认按钮当您选定了其中一个按钮时您的选择会被显示出来c M e s s a g e T i t l e = ' M y A p p l i c a t i o n 'c M e s s a g e T e x t = ' R e c o r d n o t f o u n d . W o u l d y o u l i k e t o s e a r c h a g a i n ? 'n D i a l o g T y p e = 4 + 3 2 + 2 5 6* 4 = Y e s a n d N o b u t t o n s* 3 2 = Q u e s t i o n m a r k i c o n* 2 5 6 = S e c o n d b u t t o n i s d e f a u l t

n A n s w e r = M E S S A G E B O X (c M e s s a g e T e x t , n D i a l o g T y p e , c M e s s a g e T i t l e )

D O C A S EC A S E n A n s w e r = 6

W A I T W I N D O W ' Y o u c h o s e Y e s 'C A S E n A n s w e r = 7

W A I T W I N D O W ' Y o u c h o s e N o 'E N D C A S E

请参阅

W A IT

M i d d l e C l i c k 事件

当用户在一个控件上单击一个三键鼠标的中央鼠标时发生

语法

P R O C E D U R E C o n t r o l . M i d d l e C l i c k[ L P A R A M E T E R S n I n d e x]

参数描述

n I n d e x如果一个控件在一个控件数组中则本参数唯一标识该控件

应用于

复选框组合框命令按钮命令组容器控件编辑框表单表格标头

图像标签线条列表框选项按钮选项按钮组页面页框形状微调

文本框工具栏

请参阅

C l i c k 事件 , D b l C l i c k 事件 , D r a g D r o p 事件 , D r a g O v e r 事件 , D r o p D o w n 事件 ,E n a b l e d 属性 , K e y P r e s s 事件 , M o u s e D o w n 事件 , M o u s e M o v e 事件 , MouseUp 事件 , S c r o l l e d 事件 , U n d o c k 事件

M I N ( ) 函数

比较一组表达式并返回其中具有最小值的表达式

语法

M IN (e E x p r e s s i o n 1 , e E x p r e s s i o n 2 [ , e E x p r e s s i o n 3 . . . ] )返值类型

字符型数值型货币型双精度型浮点型日期型日期时间型

参数描述

e E x p r e s s i o n 1 , e E x p r e s s i o n 2 [ , e E x p r e s s i o n 3 . . . ]指定的一组表达式 M IN ( ) 返回其中具有最小值的表达式所有的表达式必

须是相同的类型

示例

下面的示例用 A P P E N D B L A N K 创建了一个包含随机值的 1 0 个记录的表再用 MIN( )

和 MAX( ) 来显示表中的最大值和最小值C L O S E D A T A B A S E SC R E A T E T A B L E R a n d o m ( c V a l u e N ( 3 ) )F O R n I t e m = 1 T O 1 0 & &增加 1 0 个记录

A P P E N D B L A N KR E P L A C E c V a l u e W I T H 1 + 1 0 0 * R A N D ( ) & & 插入任意值

E N D F O R

C L E A RL I S T & & 显示数值g n M a x i m u m = 1 & & 初始化最小值g n M i n i m u m = 1 0 0 & & 初始化最大值S C A N

g n M i n i m u m = M I N (g n M i n i m u m , c V a l u e )g n M a x i m u m = M A X ( g n M a x i m u m , c V a l u e )

E N D S C A N? ' T h e m i n i m u m v a l u e i s : ' , g n M i n i m u m & & 显示最小值? ' T h e m a x i m u m v a l u e i s : ' , g n M a x i m u m & & 显示最大值

请参阅

C A L C U L A T E , M A X ( )

M i n B u t t o n 属性

指定表单是否有最小化按钮设计和运行时可用

语法

O b j e c t.M i n B u t t o n [ = l E x p r]参数描述

l E x p rM i n B u t t o n 属性的设置为

设置描述

真

( .T . )

默认值表单具有最小化按钮

假 ( .F.) 表单不具有最小化按钮

说明

最小化按钮能够将表单窗口最小化为图标

M a x B u t t o n M i n B u t t o n B o r d e r S t y l e 和 C o n t r o l B o x 的设置值只有运行时才起作用

在 M i c r o s o f t W i n d o w s 3 . 0 或更高版本中 M D I 子表单窗口总是具有最小化按钮而不

管 M i n B u t t o n 的设置如何但 M i n B u t t o n 设置为假 (.F . ) 时并不响应单击并且对

应的最小化命令也不出现在表单的控件框菜单中

运行时将表单最小化为图标将产生 R e s i z e 事件

注意 W i n d o w S t a t e 属性反应了窗口的当前状态把 W i n d o w S t a t e 属性设为 1最小化时不管 M i n B u t t o n 和 B o r d e r S t y l e 属性的有效设置如何

表单都将最小化

应用于


请参阅

B o r d e r S t y l e 属性 , C o n t r o l B o x 属性 , M a x B u t t o n 属性 , T i t l e B a r 属性 ,

W i n d o w S t a t e 属性

M inH e igh t 属性

指定表单可被调整到的最小高度设计和运行时可用

语法

O b jec t .M i n H e i g h t [ = n H e i g h t]参数描述

n H e i g h t指定表单可被调整到的最小高度度量单位由表单的 S c a l e M o d e 属性指定

说明

当用户从控件菜单中选取大小命令或者拖动表单的边框调整表单大小时表单的

高度不会小于 M i n H e i g h t 属性中的设置值

M i n H e i g h t 属性的默认设置为 -1 即没有指定最小高度

应用于

表单 , _ S C R E E N请参阅

M a x H e i g h t 属性 , M a x W i d t h 属性 , M i n W i d t h 属性 , S c a l e M o d e 属性

M I N U T E ( ) 函数

返回日期时间表达式中的分钟部分

语法

M IN U T E ( t E x p r e s s i o n )返值类型

数值型

参数描述

t E x p r e s s i o n指定的日期时间表达式 M IN U T E 返回其中的分钟部分

示例

下面的示例显示了当前时间的分钟部分和指定时间的分钟部分C L E A R? M I N U T E (D A T E T I M E ( ) )? M I N U T E ({ ^ 1 9 9 8 - 0 2 - 1 6 1 0 : 4 2 a }) & & 显示 4 2

请参阅

C T O T ( ), DATE( ), DATETIME( ), DTOT( ), HOUR( ), SEC( ), SECONDS( ) ,

SET SECONDS, TIME( )

M inW id th 属性

指定表单可调整到的最小宽度设计和运行时可用

语法

O b jec t .M i n W i d t h [ = n W idth ]参数描述

n W idth指定表单可调整到的最小宽度度量单位由表单的 S c a l e M o d e 属性指定

说明

当用户选择表单控件菜单中的大小命令或者拖动表单的边框调整表单时表单的

宽度不会小于 M i n W i d t h 中的设置值

M i n W id th 属性的默认设置为 -1 即没有指定最小宽度

应用于

F o r m , _ S C R E E N请参阅

M a x H e i g h t 属性 , M a x W i d t h 属性 , M i n H e i g h t 属性 , S c a l e M o d e 属性

M L I N E ( ) 函数

以字符串形式返回备注字段中的指定行

语法

M L I N E (M e m o F i e l d N a m e , n L i n e N u m b e r [ , n N u m b e r O f C h a r a c t e r s ] )返值类型

字符型

参数描述

M e m o F i e l d N a m e指定的备注字段名 M L I N E ( ) 从该字段中返回一行若备注字段是在非当前

工作区打开的表中则应在备注字段名前加上表别名和一个句点

n L i n e N u m b e r指定从备注字段中返回行的行号当 n L i n e N u m b e r 为负数或者大于备注字段

的行数时则返回空字符串

n N u m b e r O f C h a r a c t e r s指定从备注字段开始的字符数从这些字符之后 M L I N E ( ) 返回指定行的内

容

_ M L I N E 系统变量通常可用作 n N u m b e r O f C h a r a c t e r s 每次调用 M L I N E ( ) 后 _ M L I N E

将自动调整

在从较大备注字段中返回行的递归过程中把 _ M L I N E 作为 n N u m b e r O f C h a r a c t e r s 将会

取得较好效果

说明

M L I N E( ) 将裁剪掉 n L i n e N u m b e r 指定行的后续空格

备注字段的行长度和行数由 S E T M E M O W I D T H 的当前值决定一行的默认长度为 5 0

个字符遇到回车符时不再返回更多字符 _ W R A P 的当前设置决定备注字段行

的显示方式

在备注字段中查找字符串时可以使用 A T L I N E( ) 或 A T C L I N E ( ) 返回找到的字符串

所在行的行号然后在 M L I N E ( ) 中使用这个行号返回备注字段中此行的内容

示例

下面的示例中使用两种方法从备注字段中返回行内容使用 M L I N E( ) 在两个循环

中返回备注字段的行注意在第二个循环中使用系统变量 -M L I N E 作为 -M L I N E ( ) 的

参数从而增强了性能C L E A RS E T T A L K O F FS E T M E M O W I D T H T O 5 0C L O S E D A T A B A S E SC R E A T E T A B L E t m e m o ( n a m e c ( 1 0 ) , n o t e s m )A P P E N D B L A N K & & 添加一个记录W A I T W I N D O W ' F i l l i n g m e m o f i e l d - t a k e s s e v e r a l s e c o n d s ' N O W A I T*** 填充备注字段 * * *F O R g n O u t e r L o o p = 1 T O 5 & & 循环 5 次

F O R g n A l p h a b e t = 6 5 T O 7 5 & & 从字符 A 到 HR E P L A C E n o t e s W I T H R E P L I C A T E ( C H R ( g n A l p h a b e t ) , 1 0 ) ;

+ C H R ( 1 3 ) A D D I T I V E

N E X TN E X T

*** 显示备注字段的所有行 * * *

S T O R E M E M L I N E S ( n o t e s ) T O g n N u m L i n e s & & 备注字段的行数S T O R E S E C O N D S ( ) T O g n B e g i n & & 开始时间F O R g n C o u n t = 1 T O g n N u m L i n e s & &执行备注字段行数次循环 Z

? M L I N E ( n o t e s , g n C o u n t ) & &显示每一行N E X T? S T R ( S E C O N D S ( ) - g n B e g i n , 4 , 2 ) + ' s e c o n d s ' & & 总时间

* * * 更好的方法是在 -M L I N E ( ) 中使用 -M L I N E * * ** * * 显示备注字段的所有行 * * *

W A I T ' P r e s s a k e y t o s e e t h e p r e f e r r e d m e t h o d ' W I N D O WC L E A RS T O R E 0 T O _ M L I N E & & 设置 M L I N E 为 0S T O R E S E C O N D S ( ) T O g n B e g i n & & 开始时间F O R c o u n t = 1 T O g n N u m L i n e s & & 执行备注字段行数次循环

? M L I N E ( n o t e s , 1 , _ M L I N E ) & & 显示每一行N E X T? S T R ( S E C O N D S ( ) - g n B e g i n , 4 , 2 ) + ' s e c o n d s ' & & 总时间S E T T A L K O NC L O S E D A T A B A S E SE R A S E t m e m o . d b fE R A S E t m e m o . f p t

请参阅

A L I N E S ( ), ATCLINE( ), ATLINE( ), COPY MEMO, MEMLINES( ) , _M L I N E ,M O D I F Y M E M O , S E T M E M O W I D T H , _ W R A P

_ M L I N E 系统变量

包含 M L I N E ( ) 函数中使用的备注字段偏移量

语法

_ M L I N E = n N u m b e r O f C h a r a c t e r s参数描述

n N u m b e r O f C h a r a c t e r s指定备注字段偏移量有关使用 -M L I N E 的详细内容和使用的示例请参阅

M L I N E ( )说明

M L I N E( ) 从备注字段中返回一行文本 M L I N E ( ) 将备注字段中行的偏移量保存在

_ M L I N E 系统变量中把 _ M L I N E 作为 M L I N E ( ) 函数的第二个数值参数可以提高

M L I N E ( ) 的性能

_ M L I N E 的初始默认值为 0 确保在再次使用 M L I N E ( ) 函数前将 _ M L I N E 的值重置

为 0

请参阅

A L I N E S ( ), MEMLINES( ), MLINE( ) , S E T M E M O W I D T H

M O D () 函数

用一个数值表达式去除另一个数值表达式返回余数

语法

M O D ( n D i v i d e n d , n D i v i s o r)返值类型

数值型

参数描述

n D i v i d e n d指定的被除数 n D i v i d e n d 中的小数位数决定了返回值中的小数位

n D i v i s o r指定除数如果 n D i v i s o r 为正返回正值如果 n D i v i s o r 为负返回负

值

说明

取余函数 M O D ( ) 和 % 操作符返回的值相等

示例

C L E A R? M O D (3 6 , 1 0 ) & & 显示 6

? M O D ( (4 *9 ) , ( 90 /9 )) & & 显示 6? M O D (25 .250 ,5 .0 ) & & 显示 0 . 2 5 0? I IF (M O D (Y E A R ( D A T E ( ) ) , 4 ) = 0 , ' S u m m e r O l y m p i c s t h i s y e a r ' ;

, ' N o S u m m e r O l y m p i c s t h i s y e a r ' )

请参阅

% 操作符

M o d i f y 方法

打开项目中的一个文件以便在相应的设计器或编辑器中修改该文件

语法

O b j e c t.M o d i f y ( [ c C l a s s N a m e ] )参数描述

c C l a s s N a m e当 O b j e c t 是一个 . v c x 可视类库时本参数指定要打开修改的可视类的名

称

说明

如果该文件成功打开则 M o d i f y 方法返回真 ( .T . ) 否则返回假 ( .F.)

当打开该文件之前发生 Q u e r y M o d i f y F i l e 事件如果 Q u e r y M o d i f y F i l e 事件返回

假 ( .F.) 则不打开该文件并且 M o d i f y 方法返回假 ( .F.) 如果

Q u e r y M o d i f y F i l e 方法返回真 ( .T . ) 则打开该文件并且 M o d i f y 方法返回真

( .T . )

应用于

文件对象

请参阅

A d d 方法 , R e m o v e 方法 , Q u e r y M o d i f y F i l e 事件

返回总目录M O D I F Y C L A S S 命令

M O D I F Y C O M M A N D 命令

M O D I F Y C O N N E C T I O N 命令

M O D I F Y D A T A B A S E 命令

M O D I F Y F I L E 命令

M O D I F Y F O R M 命令

M O D I F Y G E N E R A L 命令

M O D I F Y L A B E L 命令

M O D I F Y M E M O 命令

M O D I F Y M E N U 命令

M O D I F Y P R O C E D U R E 命令

M O D I F Y P R O J E C T 命令

M O D I F Y Q U E R Y 命令

M O D I F Y R E P O R T 命令

M O D I F Y S C R E E N 命令

M O D I F Y S T R U C T U R E 命令

M O D I F Y V I E W 命令

M O D I F Y W I N D O W 命令

M O N T H 函数

M O U S E 命令

M o u s e D o w n 事件

M o u s e I c o n 属性

M o u s e M o v e 事件

M o u s e P o i n t e r 属性

M o u s e U p 事件

M o u s e W h e e l 事件

M o v a b l e 属性

M o v e 方法

M O V E P O P U P 命令

M O V E W I N D O W 命令

M o v e d 事件

M o v e r B a r s 属性

M R K B A R 函数

M R K P A D 函数

M R O W 函数

M T O N 函数

M u l t i S e l e c t 属性

M W I N D O W 函数

N a m e 属性

M O D I F Y C L A S S 命令

打开类设计器让用户修改已有的类定义或创建新的类定义

语法

M O D I F Y C L A S S C l a s s N a m e [ O F C l a s s L i b r a r y N a m e 1 ][ A S c B a s e C l a s s N a m e [ F R O M C l a s s L i b r a r y N a m e 2 ] ][ M E T H O D M e t h o d N a m e ] [ N O W A I T ] [ S A V E ]

参数描述

C l a s s N a m e指定要修改或创建的类定义名称

O F C l a s s L i b r a r y N a m e 1指定含有这个类定义的 . V C X 可视类库名称若创建新类并且 . V C X 可视类

库已经存在那么把类定义添加到库中

V C X 是可视类库的默认扩展名当指定的可视类库扩展名不是 . V C X 时应指定扩展

名

如果指定的 . V C X 可视类库位于当前 S E T C L A S S L I B 命令设置的搜索列表中那么将把

这个类库从搜索列表中移去

A S c B a s e C l a s s N a m e指定类定义的基类 c B a s e C l a s s N a m e 可以是 V i s u a l F o x P r o 基类中除

C o l u m n C u r s o r D a t a E n v i r o n m e n t H e a d e r P a g e 和 R e l a t i o n 之外的任何

类

若省略 A S cBaseClassName 参数则类定义派生于 V isual FoxPro 的 FormSet 基类

F R O M C l a s s L i b r a r y N a m e 2指定 . V C X 可视类库名该库中包含 c B a s e C l a s s N a m e 指定的用户自定义类

M E T H O D M e t h o d N a m e指定在类设计器中打开代码窗口的事件或方法 M E T H O D 子句让您

在类设计器中立即开始编辑事件或方法代码

M e t h o d N a m e 支持 Visual F o x P r o 对象语法例如用下面的命令可以立即编辑可视类

库 M y C l a s s L i b r a r y 中 M y C l a s s 类的文本框 t x t F i r s t N a m e 的 Cl ick 事件代码

M O D I F Y C L A S S M y C l a s s O F M y C l a s s L i b r a r y ;

M E T H O D t x t F i r s t N a m e . C l i c k

如果只在 M E T H O D 子句中包含了一个事件或方法则为类的事件或方法打开代码

窗口例如用下面的命令可以立即编辑可视类库 M y C l a s s L i b r a r y 中 M y C l a s s 类的

Cl ick 事件代码

M O D I F Y C L A S S M y C l a s s O F M y C l a s s L i b r a r y M E T H O D C l i c k

N O W A I T在打开类设计器后程序继续执行程序不必等待类设计器关闭而是继续执行

M O D I F Y C L A S S N O W A I T 行后面的语句若在程序中使用 M O D I F Y C L A S S命令时省略 N O W A I T 子句那么打开类设计器后程序暂停执行直到关闭

类设计器

N O W A I T 仅在程序中才有效当在命令窗口中发出 M O D I F Y C L A S S 时该项无效如

果包含了 N O W A I T 和 M E T H O D 子句一定要将 N O W A I T 放在 M E T H O D 子句之前

否则会忽略 N O W A I T

S A V E激活另一窗口后仍保持类设计器打开如果省略 S A V E 则当另一窗口激活

时类设计器随之关闭从命令窗口中发出包含 S A V E 子句的命令时将无

此作用

说明

可利用 M O D I F Y C L A S S 修改已有的类定义或创建新的类定义并存入一个 . V C X 可视

类库中可以用 S E T C L A S S L I B 打开 . V C X 可视类库并访问 . V C X 可视类库中的类定

义

请参阅

A D D C L A S S , C R E A T E C L A S S , C R E A T E C L A S S L I B , R E L E A S E C L A S S L I B ,

SET C L A S S L I B

M O D I F Y C O M M A N D 命令

打开一个编辑窗口从中可以修改或创建程序文件

语法

M O D I F Y C O M M A N D [ F i l e N a m e | ? ][ N O E D I T ][ N O M E N U ][ N O W A I T ][ R A N G E n S t a r t C h a r a c t e r , n E n d C h a r a c t e r ][ [W I N D O W W i n d o w N a m e 1 ][ I N [ W I N D O W ] W i n d o w N a m e 2 | I N S C R E E N ] ][ A S n C o d e P a g e ][ S A M E ][ S A V E ]

参数描述

F i l e N a m e指定打开或创建的程序文件名若不指定新建程序文件的扩展名 V i s u a lF o x P r o 自动指定 . P R G 为扩展名 M O D I F Y C O M M A N D 支持含有星号 *

和问号通配符的文件梗概名称与这个文件梗概匹配的每一个文件都在

编辑窗口中打开

若省略文件名将给打开的编辑窗口赋以一个初始名称程序 1 . P R G 当关闭编辑窗

口时可以用另外的文件名保存该文件

?显示打开对话框可以从中选择一个已有程序或键入要创建的新程序

名

N O E D I T指定不能对程序文件作更改但是可以查看程序文件或者将程序文件复制到剪

贴板中

N O M E N U从系统菜单栏中移去格式菜单标题可以防止用户更改字体字体大

小行间距和行缩进

N O W A I T在打开编辑窗口后继续程序的执行程序不必等待编辑窗口关闭而是继续执

行命令 M O D I F Y C O M M A N D N O W A I T 所在行的后继语句行若在程序中使

用 M O D I F Y C O M M A N D 时省略 N O W A I T 子句打开编辑窗口后程序暂停

执行直到关闭编辑窗口

N O W A I T 仅在程序中有效在命令窗口中发出 M O D I F Y C O M M A N D N O W A I T 时无

效

当用一条 M O D I F Y C O M M A N D 命令打开多个窗口时隐含使用 N O W A I T 例如

M O D I F Y C O M M A N D * . P R G .

R A N G E n S t a r t C h a r a c t e r , n E n d C h a r a c t e r指定打开编辑窗口时选择的字符范围从 n S t a r t C h a r a c t e r 位置开始一直到

但不包括 n E n d C h a r a c t e r 若 n S t a r t C h a r a c t e r 等于 n E n d C h a r a c t e r 则不选

择字符光标停在 n S t a r t C h a r a c t e r 指定的位置处

W I N D O W W i n d o w N a m e 1指定一个窗口名编辑窗口继承其特性例如如果创建该窗口时 D E F I N EW I N D O W S 含有 F L O A T 选项则编辑窗口可移动该窗口不必为活动或可

见的但必须是已定义的

I N [ W I N D O W ] W i n d o w N a m e 2指定编辑窗口打开时所在的父窗口名编辑窗口不继承父窗口的特性并且不能

移出父窗口之外父窗口移动时编辑窗口随之移动

要访问编辑窗口必须先用 D E F I N E W I N D O W 定义父窗口并且父窗口必须是可见

的

I N S C R E E N把编辑窗口放入父窗口后在 V i s u a l F o x P r o 主窗口中打开它通过包含 I NW I N D O W 子句可以将编辑窗口放在父窗口中

A S n C o d e P a g e自动转换在其他 V i s u a l F o x P r o 平台上所创建程序文件中的重音字符数值表

达式 n C o d e P a g e 指定 V i s u a l F o x P r o 平台的代码页在此代码页上创建程序文

件文件以此代码页保存除非从文件菜单中选择另存为命令将

文件以其他的代码页保存

S A M E防止编辑窗口成为活动窗口若编辑窗口为隐藏状态它将被显示但不会成为

活动窗口

S A V E在激活其他窗口后保持编辑窗口打开若省略 S A V E 则其他窗口激活后将

关闭编辑窗口在命令窗口中发出命令时包含 S A V E 则无此作用

说明

修改程序文件之后更新过的文件将写到磁盘上选取编辑菜单上的属性若

在其中的编辑属性对话框中选取制作备份复选框则创建具有 . B A K 扩展名的

备份文件在早期版本的 F o x P r o 中是通过在编辑菜单中选取参数选择项

并在出现的选择对话框中选取备份复选框创建一个带 . B A K 扩展名的备份文

件

除非在配置文件中用 T E D I T 指定一个外部编辑器否则一般使用 V i s u a l F o x P r o 的内

置编辑器

请参阅

* , & & , D O , M O D I F Y F I L E , N O T E

M O D I F Y C O N N E C T I O N 命令

显示连接设计器让您能够交互地修改当前数据库中已有的命名连接

语法

M O D I F Y C O N N E C T I O N [ C o n n e c t i o n N a m e | ? ]参数描述

C o n n e c t i o n N a m e指定要修改的连接名

?显示打开对话框从中可以选取已有的命名连接进行修改

说明

若省略可选参数将显示打开对话框从中可以指定已有的命名连接进行修改在

选定要修改的命名连接后将打开连接设计器

示例

下面的示例假定 O D B C 数据源 M y F o x S Q L N T 可用数据源的用户标识为 sa 先打

开 t e s tda ta 数据库创建名为 M y c o n n 的连接然后用 M O D I F Y C O N N E C T I O N 来显示

连接设计器并修改连接C L O S E D A T A B A S E S

O P E N D A T A B A S E ( H O M E ( 2 ) + ' d a t a \ t e s t d a t a ' )

C R E A T E C O N N E C T I O N M y c o n n D A T A S O U R C E " M y F o x S Q L N T " U S E R I D " s a "

M y c o n n & & 显示数据库中的命名连接

请参阅

C R E A T E C O N N E C T I O N , D E L E T E C O N N E C T I O N , O P E N D A T A B A S E ,

RENAME C O N N E C T I O N

M O D I F Y D A T A B A S E 命令

打开数据库设计器让您能够交互地修改当前数据库

语法

M O D I F Y D A T A B A S E [ D a t a b a s e N a m e | ? ][ N O W A I T ] [ N O E D I T ]

参数描述

D a t a b a s e N a m e指定要修改的数据库名

?显示打开对话框可从中选取数据库进行修改

N O W A I T在打开数据库设计器后继续程序的执行程序不必等待数据库设计器关闭而

是继续执行 M O D I F Y D A T A B A S E N O W A I T 之后的程序行若在程序中使用

M O D I F Y D A T A B A S E 时省略 N O W A I T 则打开数据库设计器后程序暂停

执行直到关闭数据库设计器

N O W A I T 仅在程序中有效在命令窗口中发出 M O D I F Y D A T A B A S E N O W A I T 时无

效

N O E D I T禁止修改数据库

说明

有关用数据库设计器交互式地修改数据库的详细内容请参阅帮助中的数据库设计

器和数据库设计器工具栏与用户指南的第三章将表加入数据库

示例

下面示例在数据库设计器中显示 t e s tda ta 数据库中的表C L O S E D A T A B A S E SS E T P A T H T O ( H O M E ( 2 ) + ' d a t a \ ' ) & & 设置数据库的路径

t es tda ta & & 打开 tes tdata 数据库

请参阅

A D D T A B L E , C L O S E D A T A B A S E S , C R E A T E D A T A B A S E , D B C ,

D B G E T P R O P , D B S E T P R O P , D E L E T E D A T A B A S E , D I S P L A YT A B L E S , O P E N D A T A B A S E , R E M O V E T A B L E

M O D I F Y F I L E 命令

打开编辑窗口从中可以修改或创建文本文件

语法

M O D I F Y F I L E [ F i l e N a m e | ? ][ N O E D I T ][ N O M E N U ][ N O W A I T ][ R A N G E n S t a r t C h a r a c t e r , n E n d C h a r a c t e r ][ [W I N D O W W i n d o w N a m e 1 ][ I N [ W I N D O W ] W i n d o w N a m e 2 | I N S C R E E N ] ][ A S n C o d e P a g e ][ S A M E ][ S A V E ]

参数描述

F i l e N a m e指定文本文件的文件名若未给新文本文件指定扩展名 V i s u a l F o x P r o 自动

指定扩展名为 . T X T M O D I F Y F I L E 支持包含星号 * 和问号通配符

的文件梗概每个匹配的文本文件都将出现在打开的编辑窗口中

若省略文件名打开的编辑窗口将赋给初始文件名 1 当关闭编辑窗口时可以用另外

一个文件名保存该文件

?显示打开对话框从中可以选取一个文本文件

N O E D I T指定该文本文件不能更改但可以查看或者将文本文件复制到剪贴板上

N O M E N U将格式菜单标题从系统菜单栏中移去可防止更改字体字体大小行

间距和缩进

N O W A I T在编辑窗口打开后继续程序执行程序不必等待关闭编辑窗口而是继续执行

M O D I F Y F I L E N O W A I T 之后的程序行如果在程序中发出 M O D I F Y F I L E 命令时省略 N O W A I T 编辑窗口打开后暂停执行程序直至编辑窗口关闭为

止

N O W A I T 仅在程序中有效在命令窗口中发出 M O D I F Y F I L E N O W A I T 时无效

如果用单个 M O D I F Y F I L E 命令打开多个编辑窗口将隐含地发生 N O W A I T 例如

M O D I F Y F I L E * . T X T

R A N G E n S t a r t C h a r a c t e r , n E n d C h a r a c t e r指定打开编辑窗口时选定的字符范围字符范围从 n S t a r t C h a r a c t e r 指定位置到

但不包括 n E n d C h a r a c t e r 指定位置如果 n S t a r t C h a r a c t e r 等于

n E n d C h a r a c t e r 则没有选定值光标定位于 n S t a r t C h a r a c t e r 指定的位置

W I N D O W W i n d o w N a m e 1指定一个窗口编辑窗口继承它的特性例如如果窗口是由 D E F I N EW I N D O W 的 F L O A T 子句创建的那么编辑窗口能够移动窗口不必是活动

的或可见的但必须是已定义的

I N [ W I N D O W ] W i n d o w N a m e 2指定一个父窗口编辑窗口从中打开编辑窗口不继承父窗口的特性并且不能

移出父窗口之外如果父窗口移动编辑窗口随之移动

要访问编辑窗口必须先用 D E F I N E W I N D O W 命令定义父窗口并且父窗口是可见

的

I N S C R E E N把编辑窗口放入父窗口后在 V i s u a l F o x P r o 主窗口中打开它包含 I NW I N D O W 子句可以把编辑窗口放入父窗口

A S n C o d e P a g e自动转换其他 V i s u a l F o x P r o 平台上创建的文本文件中的重音字符数值表达

式 n C o d e P a g e 指定了文本文件创建时所在的 V i s u a l F o x P r o 平台的代码页文

件以该代码页保存除非选择文件菜单中的另存为选项将文件以其

他代码页保存

S A M E防止编辑窗口成为活动窗口如果编辑窗口被隐藏它仍显示但不成为活动窗

口

S A V E激活另外一个窗口后保持编辑窗口打开若省略 S A V E 激活另外一个窗口

后编辑窗口将关闭从命令窗口发出命令时包含 S A V E 将不起作用

说明

对文本文件进行修改后更新的文件将写到磁盘上在 V i s u a l F o x P r o 中当在工

具菜单中选择选项时可以在选项对话框的编辑选项卡中选定制作备

份复选框从而创建一个带有 . B A K 扩展名的备份文件在 F o x P r o 早期版本中当

在编辑菜单中选择参数选择时可以在参数选择对话框中选定备份复

选框从而创建一个带有 . B A K 扩展名的备份文件

除非在配置文件中用 T E D I T 指定一个外部编辑器否则使用 V i s u a l F o x P r o 编辑器

请参阅

* , & & , D O , M O D I F Y C O M M A N D , N O T E

M O D I F Y F O R M 命令

打开表单设计器从中可以修改或创建表单

语法

M O D I F Y F O R M[F o r m N a m e | ? ] [M E T H O D M e t h o d N a m e ][ N O E N V I R O N M E N T ] [ N O W A I T ] [ S A V E ][ [W I N D O W W i n d o w N a m e 1 ][ I N [ W I N D O W ] W i n d o w N a m e 2 | I N S C R E E N ] ]

参数描述

F o r m N a m e指定表单的文件名若未给文件名指定扩展名 V i s u a l F o x P r o 自动指定扩展

名为 . S C X?

显示打开对话框从中可以选取已有的表单或者输入新建表单的名称

M E T H O D M e t h o d N a m e指定在表单设计器中打开代码窗口的事件或方法 M E T H O D 子句让

您在表单设计器中立即开始编辑事件或方法代码

M e t h o d N a m e 支持 Visual F o x P r o 对象语法例如用下面的命令可以立即编辑表单

f r m A d d r e s s 中文本框 t x t F i r s t N a m e 的 C l i c k 事件代码

M O D I F Y F O R M f r m A d d r e s s M E T H O D t x t F i r s t N a m e . C l i c k

如果只在 M E T H O D 子句中包含了一个事件或方法则为表单的事件或方法打开代

码窗口例如用下面的命令可以立即编辑表单 f r m A d d r e s s 的 Cl ick 事件代码

M O D I F Y F O R M f r m A d d r e s s M E T H O D C l i c k

N O E N V I R O N M E N T包含此子句是为了提供与 2 . x 屏幕的向后兼容性用以防止恢复与屏幕一起保

存的环境

在 V i s u a l F o x P r o 中通过把 A u t o O p e n T a b l e s 属性设置为真 ( .T . ) 可以恢复与 V i s u a l

F o x P r o 表单相联系的数据环境要确保释放表单后关闭表单环境可以把数据环境

A u t o C l o s e T a b l e s 属性设置为真 ( .T . ) 此属性的默认设置值为真 ( .T.)

创建或修改表单时可以将当前 V i s u a l F o x P r o 数据环境与表单定义文件一起保存保存

数据环境将在表单定义表中放置附加记录这些记录指出所有打开的表和索引文件索

引顺序以及任何表间的关系

N O W A I T在表单设计器打开后继续程序执行程序不必等待关闭表单设计器而是继续

执行 M O D I F Y F O R M N O W A I T 之后的程序行如果在程序中发出 M O D I F YF O R M 命令时省略 N O W A IT 表单设计器打开后暂停程序执行直至表单

设计器关闭为止

N O W A I T 仅在程序中有效在命令窗口中发出 M O D I F Y F O R M N O W A I T 时无效如果

包含了 N O W A I T 和 M E T H O D 子句一定要将 N O W A I T 放在 M E T H O D 子句之前否

则会忽略 N O W A I T

S A V E在程序中发出指出激活另外一个窗口后保持表单设计器从命令窗口发出

时 S A V E 将不起作用

W I N D O W W i n d o w N a m e 1指定一个窗口表单设计器采用它的特性例如如果窗口是由 D E F I N EW I N D O W 的 F L O A T 子句创建的那么表单设计器能够移动窗口不必是活

动的或可见的但必须是已定义的

表单设计器的默认大小可能比它的特性窗口大这种情况下表单设计器仍然采用该窗

口的特性表单设计器的左上角放置在特性窗口左上角坐标处但其尺寸超出窗口的边

界

I N [ W I N D O W ] W i n d o w N a m e 2指定一个父窗口表单设计器从中打开表单设计器不继承父窗口的特性并且

不能移出父窗口之外如果父窗口移动表单设计器随之移动

要访问表单设计器必须先用 D E F I N E W I N D O W 命令定义父窗口并且父窗口是可见

的

I N S C R E E N把表单设计器放入父窗口后在 V i s u a l F o x P r o 主窗口中打开它包含 I N

W I N D O W 子句可以把表单设计器放在父窗口中

说明

发出不带有任何参数的 M O D I F Y F O R M 命令将显示打开对话框关闭表单设计器时

可以用其他名称保存表单

示例

下面示例打开了表单设计器中的计时器 ( S W A T C H . S C X ) 控制示例 (HOME(2 ) + ' so l u t i on \ con t ro l s \ t ime r \ swa tch . scx ' )

请参阅

C O M P I L E F O R M , C R E A T E F O R M , D O F O R M

M O D I F Y G E N E R A L 命令

在编辑窗口中打开当前记录中的通用字段

语法

M O D I F Y G E N E R A L G e n e r a l F i e l d 1 [ , G e n e r a l F i e l d 2 . . . ][ N O M O D I F Y ][ N O W A I T ][ [W I N D O W W i n d o w N a m e 1 ]

[ I N [ W I N D O W ] W i n d o w N a m e 2 | I N S C R E E N ] ]参数描述

G e n e r a l F i e l d 1 [ , G e n e r a l F i e l d 2 . . . ]指定打开的通用字段名称若要打开非当前工作区中表的通用字段的编辑窗

口可以在字段名称中包含表别名通过包含逗号分隔的通用字段列表可以

打开当前记录中的多个通用字段

N O M O D I F Y指定不能更改通用字段中包含的 O L E 对象但可以查看或者将 O L E 对象复

制到剪贴板上

N O W A I T在通用字段编辑窗口打开后继续程序执行程序不必等待关闭编辑窗口而是

继续执行 M O D I F Y G E N E R A L N O W A I T 之后的程序行如果在程序中发出

M O D I F Y G E N E R A L 时省略 N O W A I T 编辑窗口打开后暂停执行程序直

至编辑窗口关闭为止

N O W A I T 仅在程序中有效在命令窗口中发出 M O D I F Y G E N E R A L 时无效

W I N D O W W i n d o w N a m e 1指定一个窗口通用字段编辑窗口采用它的特性例如如果窗口是由

D E F I N E W I N D O W 的 F L O A T 子句创建的那么通用字段编辑窗口能够移

动窗口不必是活动的或可见的但必须是已定义的

I N [ W I N D O W ] W i n d o w N a m e 2指定一个父窗口通用字段编辑窗口从中打开通用字段编辑窗口不继承父窗

口的特性并且不能移出父窗口之外如果父窗口移动通用字段编辑窗口随之

移动

要访问通用字段编辑窗口必须先用 D E F I N E W I N D O W 命令定义父窗口并且父窗口

是可见的

I N S C R E E N把通用字段窗口放入父窗口后在 V i s u a l F o x P r o 主窗口中打开它包含 I NW I N D O W 子句可以把通用字段编辑窗口放入父窗口

说明

当打开编辑窗口后不能插入修改或者删除一个 O L E 对象

有关 Visual F o x P r o 中的 O L E 对象的详细内容请参阅 Microsoft Visual F o x P r o 6 . 0 中

文版程序员指南的第十六章添加 O L E 中的 ”在表中添加 O L E 对象 ”

请参阅 @ … S A Y -P i c t u r e s & O L E O b j e c t s ,A P P E N D G E N E R A L

M O D I F Y L A B E L 命令

打开标签设计器从中可以修改或创建标签

语法

M O D I F Y L A B E L [ F i l e N a m e | ? ]

[ [W I N D O W W i n d o w N a m e 1 ][ I N [ W I N D O W ] W i n d o w N a m e 2 | I N S C R E E N ] ][ N O E N V I R O N M E N T ][ N O W A I T ][ S A V E ]

参数描述

F i l e N a m e指定标签的文件名若未给文件名指定扩展名 V i s u a l F o x P r o 自动指定扩展

名为 . L B X 如果指定的文件不存在或者未找到则创建一个新标签文件

?显示打开对话框从中可以选取已有的标签或者输入新建标签的名称

W I N D O W W i n d o w N a m e 1指定一个窗口标签设计器采用它的特性例如如果窗口是由 D E F I N EW I N D O W 的 F L O A T 子句创建的那么标签设计器能够移动窗口不必是活

动的或可见的但必须是已定义的

标签设计器的默认尺寸可能比它的特性窗口大这种情况下标签设计器仍然采用它所

在的窗口的特性标签设计器的左上角放置在特性窗口左上角坐标处但其尺寸超出窗

口的边界

I N [ W I N D O W ] W i n d o w N a m e 2指定一个父窗口标签设计器从中打开标签设计器不继承父窗口的特性并且

不能移出父窗口之外如果父窗口移动标签设计器随之移动

要访问标签设计器必须先用 D E F I N E W I N D O W 命令定义父窗口并且父窗口是可见

的

I N S C R E E N把标签设计器放入父窗口后在 V i s u a l F o x P r o 主窗口中打开它包含 I NW I N D O W 子句可以把标签设计器放在父窗口中

N O E N V I R O N M E N T包含此子句是为了提供与 2 . x 屏幕的向后兼容性用以防止恢复与屏幕一起保

存的环境

通过把 A u t o O p e n T a b l e s 属性设置为真 ( .T . ) 可以恢复与 V i s u a l F o x P r o 标签相联系

的数据环境要确保打印标签结束后关闭标签环境可以把数据环境 A u t o C l o s e T a b l e s 属

性设置为真 ( .T . ) 此属性的默认设置值为真 ( .T.)

创建或修改标签时可以将当前 V i s u a l F o x P r o 数据环境与标签定义文件一起保存保存

V i s u a l F o x P r o 数据环境将在标签定义表中放置附加记录这些记录指出所有打开的表和

索引文件索引顺序以及任何表间的关系

N O W A I T在标签设计器打开后继续程序执行程序不必等待关闭标签设计器而是执行

C R E A T E L A B E L N O W A I T 之后的程序行如果在程序中发出 C R E A T EL A B E L 时省略 N O W A I T 标签设计器打开后暂停执行程序直至标签设计

器关闭为止

在命令窗口中发出 C R E A T E L A B L E 时无效

S A V E激活另外一个窗口后保持标签设计器打开若省略 S A V E 激活另外一个窗口

后标签设计器将关闭从命令窗口发出时 S A V E 将不起作用

请参阅

C R E A T E L A B E L , L A B E L

M O D I F Y M E M O 命令

打开当前记录中备注字段的编辑窗口

语法

M O D I F Y M E M O M e m o F i e l d 1 [ , M e m o F i e l d 2 . . . ][ N O E D I T ][ N O M E N U ][ N O W A I T ][ R A N G E n S t a r t C h a r a c t e r , n E n d C h a r a c t e r ][ [W I N D O W W i n d o w N a m e 1 ][ I N [ W I N D O W ] W i n d o w N a m e 2 | I N S C R E E N ] ]

[ S A M E ][ S A V E ]

参数描述

M e m o F i e l d 1 [ , M e m o F i e l d 2 . . . ]指定要编辑的备注字段名若要打开非当前工作区中表备注字段的编辑窗口

可在字段名称中包含表别名

N O E D I T指定打开的备注字段不能被更改但是可以查看或者将备注字段复制到剪贴

板上

N O M E N U从系统菜单栏中移去格式菜单标题可以防止更改字体字体大小行

间距和缩进

N O W A I T在编辑窗口打开后继续程序执行程序不必等待关闭编辑窗口而是继续执行

M O D I F Y M E M O N O W A I T 之后的程序行如果在程序中发出 M O D I F YG E N E R A L 时省略 N O W A I T 编辑窗口打开后暂停执行程序直至编辑窗

口关闭为止

N O W A I T 仅在程序中有效在命令窗口中发出 M O D I F Y M E M O 时无效

R A N G E n S t a r t C h a r a c t e r , n E n d C h a r a c t e r指定打开编辑窗口时选定的字符范围字符范围从 n S t a r t C h a r a c t e r 指定位

置到但不包括 n E n d C h a r a c t e r 指定位置若 n S t a r t C h a r a c t e r 等于

n E n d C h a r a c t e r 则不选择字符光标定位于 n S t a r t C h a r a c t e r 指定的位置处

W I N D O W W i n d o w N a m e 1指定一个窗口编辑窗口采用它的特性例如如果窗口是由 D E F I N EW I N D O W 的 F L O A T 子句创建的那么编辑窗口能够移动窗口不必是活动

的或可见的但必须是已定义的

I N [ W I N D O W ] W i n d o w N a m e 2指定一个父窗口编辑窗口从中打开编辑窗口不继承父窗口的特性并且不能

移出父窗口之外如果父窗口移动了编辑窗口随之移动

要访问编辑窗口必须先用 D E F I N E W I N D O W 命令定义父窗口并且父窗口是可见

的

I N S C R E E N把编辑窗口放入父窗口后在 V i s u a l F o x P r o 主窗口中打开它包含 I NW I N D O W 子句可以把编辑窗口放在父窗口中

S A M E防止编辑窗口成为活动窗口如果编辑窗口隐藏它仍显示但不活动

S A V E激活另外一个窗口后保持编辑窗口打开若省略 S A V E 激活另外一个窗口

后编辑窗口将关闭从命令窗口发出时 S A V E 将不起作用

说明

在编辑窗口中可以查看或者更改备注字段的内容

对于在网络上以共享方式打开的表一旦开始编辑某一记录的备注字段即锁定该记录

注意在发布的运行时刻应用程序中废止备注字段编辑窗口中的语法着

色

若要在开发时启用编辑窗口中的语法着色

1 . 在编辑窗口中单击鼠标右键从快捷菜单中选择属性命令

2 . 选中语法着色复选框

示例

下面的示例在编辑窗口中打开了 e m p l o y e e 表中第一条记录的 n o t e s 备注字段并且突出

显示选定范围的字符C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' d a t a \ t e s t d a t a ' )U S E e m p l o y e e & & 打开 E m p l o y e e 表

N O T E S 1 , 1 0 & & 选定前 1 0 个字符U S E

请参阅

C L O S E M E M O

M O D I F Y M E N U 命令

打开菜单设计器从中可以修改或创建菜单系统

语法

M O D I F Y M E N U [ F i l e N a m e | ? ][ [W I N D O W W i n d o w N a m e 1 ][ I N [ W I N D O W ] W i n d o w N a m e 2 | I N S C R E E N ] ][ N O W A I T ][ S A V E ]

参数描述

F i l e N a m e指定菜单的文件名如果没有指定文件的扩展名 V i s u a l F o x P r o 自动指定扩

展名为 . M N X?

显示打开对话框从中可以选择一个已存在的菜单文件或者输入要创

建的新菜单名

W I N D O W W i n d o w N a m e 1指定一个窗口菜单设计器采用它的特性例如如果该窗口是由 D E F I N E

W I N D O W 命令的 F L O A T 选项创建的则菜单设计器可以移动此窗口不必

是活动的或可见的但必须是已定义的

I N [ W I N D O W ] W i n d o w N a m e 2指定一个父窗口菜单设计器从中打开菜单设计器不具有父窗口的特性也不

能移出父窗口如果父窗口移动菜单设计器随之移动

要访问菜单设计器必须首先用 D E F I N E W I N D O W 命令定义父窗口并且父窗口必须

是可见的

I N S C R E E N把菜单设计器放入父窗口后在 V i s u a l F o x P r o 主窗口中打开它包含 I NW I N D O W 子句可以把菜单设计器放入一个父窗口

N O W A I T打开菜单设计器之后继续执行程序程序不必等待关闭菜单设计器而是继续

执行 M O D I F Y M E N U N O W A I T 命令后面的程序行如果在程序中发出

M O D I F Y M E N U 命令时不含有 N O W A I T 子句打开菜单设计器后程序暂

停执行直到关闭菜单设计器为止

N O W A I T 子句只在程序中有效从命令窗口发出 M O D I F Y M E N U N O W A I T 时无效

如果在命令窗口中发出 M O D I F Y M E N U 时没有菜单名称和包含 N O W A I T 则不

能显示打开对话框可用新建菜单对话框指定所创建的菜单的类型标准或快

捷

S A V E在激活另一个窗口之后菜单设计器仍保持打开如果省略 S A V E 在激活另

一个窗口之后将关闭菜单设计器从命令窗口发出 M O D I F Y M E N U 命令

时 S A V E 子句不起作用

说明

有关创建菜单的详细内容请参阅 Microsoft Visual F o x P r o 6 . 0 中文版程序员指南的

第十一章设计菜单与工具栏中的创建菜单系统

请参阅

D E F I N E B A R , D E F I N E M E N U , D E F I N E P A D , D E F I N E P O P U P , S E TS Y S M E N U

M O D I F Y P R O C E D U R E 命令

打开 V i s u a l F o x P r o 文本编辑器可在其中为当前数据库创建新的内部存储过程或修

改数据库已有的内部存储过程

语法

M O D I F Y P R O C E D U R E说明

在创建或修改内部存储过程之前必须打开一个数据库内部存储过程通常是在删除插

入或更新触发器中指定的可以用 C R E A T E T R I G G E R 命令为一个数据库创建触发器

当前数据库的内部存储过程可以像其他已打开的过程文件或程序中的 V i s u a l F o x P r o 过

程一样执行有关 V i s u a l F o x P r o 搜索过程的顺序和位置的说明请参阅

P R O C E D U R E

示例

下面的示例打开 t e s tda ta 数据库并用 M O D I F Y P R O C E D U R E 命令打开 V i s u a l F o x P r o

文本编辑器在编辑器中可以创建新的内部存储过程或者修改已有的内部存储过程C L O S E D A T A B A S E SO P E N D A T A B A S E ( H O M E ( 2 ) + ' D a t a \ t e s t d a t a ' )

& &打开 V i s u a l F o x P r o 文本编辑器

请参阅

C R E A T E T R I G G E R , D I S P L A Y P R O C E D U R E S , O P E N D A T A B A S E ,

P R O C E D U R E

M O D I F Y P R O J E C T 命令

打开项目管理器从中可以修改或创建一个项目文件

语法

M O D I F Y P R O J E C T [ F i l e N a m e | ? ][ I N S C R E E N ] [ N O W A I T ] [ S A V E ][ N O S H O W ] [ N O P R O J E C T H O O K ]

参数描述

F i l e N a m e指定项目的文件名如果未指定文件的扩展名 V i s u a l F o x P r o 自动指定扩展

名为 . P I X?

显示打开对话框从中可以打开一个已存在的项目文件或者输入要创

建的新项目名称

I N S C R E E N把项目管理器放入父窗口之后在 V i s u a l F o x P r o 主窗口中打开项目管理器

包含 I N W I N D O W 子句可以把项目管理器放进一个父窗口

N O W A I T打开项目管理器之后继续执行程序程序不必等待关闭项目管理器而是继续

执行 M O D I F Y P R O J E C T N O W A I T 命令后面的程序行如果在程序中发出

M O D I F Y P R O J E C T 命令时不含有 N O W A I T 子句打开项目管理器后程序

暂停执行直到关闭项目管理器为止

N O W A I T 子句只在程序中起作用从命令窗口发出 M O D I F Y P R O J E C T 时无效

S A V E在激活另一个窗口之后仍然保持项目管理器打开如果省略 S A V E 子句

在激活另一个窗口之后将关闭项目管理器从命令窗口发出 M O D I F YP R O J E C T 命令时 S A V E 子句不起作用

N O S H O W指定当打开项目管理器 V i s i b l e 属性设置为假 ( . F . ) 时隐藏它为了

显示项目管理器可将项目管理器的 V i s ib le 属性设置为真 ( .T .)N O S H O W 允许您在项目管理器中显示一个项目之前管理它注意为了避免

与 N O S H A D O W 关键字混淆不可以将 N O S H O W 缩减为少于 5 个字符

N O P R O J E C T H O O K指定当打开项目管理器时不创建一个项目管理器对象对于由项目管理器挂

接程序通过编程管理的项目可以包含 N O P R O J E C T H O O K 关键字

说明

在一个项目中为应用程序指定它所需要的所有源文件 V i s u a l F o x P r o 将可以确保用最

新的源文件生成应用程序

项目文件是一个表它跟踪所有的源文件如程序表单菜单库报表标签

表索引和格式文件项目文件也跟踪文件之间的依赖引用和连接关系项目文件

扩展名为 . P IX 相关备注文件的扩展名为 .PJT 发出不带任何参数的 M O D I F Y

P R O J E C T 命令会显示打开对话框

注意项目中不能包含共享库 ( . f l l .m lb .d l l 和 C F M 文件 )一个项目文件有 .pjx 文件扩展名和一个有 .p j t 扩展名的相关联备注文件

不带任何参数描述的 M O D I F Y P R O J E C T 命令显示打开对话框

有关项目管理器的详细内容请参阅 Microsoft Visual F o x P r o 6 . 0 中文版程序员指南

的第十三章编译应用程序

请参阅

B U I L D A P P , B U I L D E X E , B U I L D P R O J E C T , C O M P I L E , C R E A T E P R O J E C T

M O D I F Y Q U E R Y 命令

打开查询设计器从中可以修改或创建一个查询

语法

M O D I F Y Q U E R Y [ F i l e N a m e | ? ][ [W I N D O W W i n d o w N a m e 1 ]

[ I N S C R E E N ][ N O W A I T ][ S A V E ][ A S n C o d e P a g e ]

参数描述

F i l e N a m e指定查询的文件名如果未指定扩展名 V i s u a l F o x P r o 自动指定扩展名

为 . Q P R?

显示打开对话框从中可以选择一个已存在的查询或者输入要创建的新查询

的名称

W I N D O W W i n d o w N a m e 1指定查询设计器接受的特性例如如果用 D E F I N E W I N D O W 的F L O A T 选项创建窗口就可以移动查询设计器窗口不一定是活动或可

见的但必须被定义

I N S C R E E N把查询设计器放入父窗口之后在 V i s u a l F o x P r o 主窗口中打开查询设计器

包含 I N W I N D O W 子句可以把查询设计器放进一个父窗口

N O W A I T打开查询设计器之后继续执行程序程序不必等待查询设计器关闭而是继续

执行 M O D I F Y Q U E R Y N O W A I T 命令后面的程序行如果在程序中发出

M O D I F Y Q U E R Y 命令时不含有 N O W A I T 子句打开查询设计器后程序暂停

执行直到关闭查询设计器为止

N O W A I T 子句只在程序中起作用从命令窗口发出 M O D I F Y Q U E R Y N O W A I T 时无

效

S A V E激活另一个窗口之后仍然保持查询设计器打开如果省略 S A V E 在激活另

一个窗口之后将关闭查询设计器从命令窗口发出 M O D I F Y Q U E R Y 命令

时 S A V E 子句不起作用

A S n C o d e P a g e指定查询的代码页当查询由 V i s u a l F o x P r o 的非当前代码页创建时需要包

含 A S n C o d e P a g e 打开查询时 V i s u a l F o x P r o 自动把查询转换到 V i s u a lF o x P r o 当前代码页可以用 G E T C P 函数为 n C o d e P a g e 显示代码页对

话框从中可以为查询指定一个代码页

查询关闭时它以原始代码页保存

如果省略 A S nCodePage 子句或者 nCodePage 等于 0 则查询并不转换到 Visual FoxPro 当前代

码页如果不支持 nCodePage 指定的值 Visual FoxPro 产生错误信息

在 V i s u a l F o x P r o 中可以把查询添加进一个项目也可以在项目容器中指定查询的代码

页项目容器跟踪查询的代码页但是如果用 M O D I F Y Q U E R Y 命令在项目容器以外

打开查询则应该包含 A S n C o d e P a g e 子句来指定查询的代码页

说明

有关创建查询的详细内容请参阅帮助中的用户指南第四章检索数据中的创

建查询

如果发出不带任何参数的 M O D I F Y Q U E R Y 命令将显示打开对话框如果从中选择

了新建按钮则指定查询名为查询 1 关闭查询设计器时可以用另外的名字保存该

查询

创建一个查询后它将存贮为带 . Q P R 扩展名的 V i s u a l F o x P r o 程序文件可以用 D O 命

令执行一个查询程序但查询文件名必须包含 . Q P R 扩展名

请参阅

C R E A T E Q U E R Y , D O , G E T C P

M O D I F Y R E P O R T 命令

打开报表设计器从中可以修改或创建报表

语法

M O D I F Y R E P O R T [ F i l e N a m e | ? ][ [W I N D O W W i n d o w N a m e 1 ][ I N [ W I N D O W ] W i n d o w N a m e 2 | I N S C R E E N ] ][ N O E N V I R O N M E N T ][ N O W A I T ]

[ S A V E ]参数描述

F i l e N a m e指定报表的文件名称如果没有指定文件名称的扩展名 Visual 会自

动地赋给 . f r x 扩展名

?显示打开对话框从中可以选择一个已存在的报表文件或者输入要创

建的新报表名称

W I N D O W W i n d o w N a m e 1指定一个窗口报表设计器采用它的特性例如如果窗口是由 D E F I N EW I N D O W 命令的 F L O A T 选项创建的则报表设计器可以移动窗口不必是

活动的或可见的但必须是已定义的

I N [ W I N D O W ] W i n d o w N a m e 2指定一个父窗口报表设计器将在这个窗口中打开报表设计器并不具有父窗

口的特性并且不能移出父窗口如果父窗口移动报表设计器随之移动

要访问报表设计器必须首先用 D E F I N E W I N D O W 命令定义父窗口并且父窗口必须

是可见的

I N S C R E E N把报表设计器放入父窗口之后在 V i s u a l F o x P r o 主窗口中打开报表设计器

包含 I N W I N D O W 子句可以把报表设计器放进一个父窗口

N O E N V I R O N M E N T包含此命令是为了提供对 2 . x 报表的向后兼容性此命令防止保存报表的环

境

在 V i s u a l F o x P r o 中数据环境的 A u t o O p e n T a b l e s 属性设置为默认值真 ( .T . )

时可以恢复与 V i s u a l F o x P r o 报表相关的数据环境要想确保报表打印完毕之后关闭报

表环境可以把数据环境的 A u t o C l o s e T a b l e s 属性设置为真 ( .T . ) 此属性默认值为

真 ( .T.)

当创建或修改报表时可以用报表定义文件保存当前的 V i s u a l F o x P r o 数据环境保存

V i s u a l F o x P r o 数据环境时将在报表定义表中追加记录这些记录指出所有打开的

表索引文件和索引排序以及表之间的任何关系

N O W A I T打开报表设计器之后继续执行程序程序不必等待报表设计器关闭而是继续

执行 M O D I F Y R E P O R T N O W A I T 命令后面的程序行如果在程序中发出

M O D I F Y R E P O R T 命令时不含有 N O W A I T 子句打开报表设计器后程序

暂停直到关闭报表设计器为止

N O W A I T 子句只在程序中起作用从命令窗口发出 M O D I F Y R E P O R T N O W A I T 时无

效

S A V E激活另一个窗口之后仍然保持报表设计器打开如果省略 S A V E 在激活另

一个窗口之后将关闭报表设计器从命令窗口发出 M O D I F Y R E P O R T 命令

时 S A V E 子句将不起作用

说明

如果发出 M O D I F Y R E P O R T 命令时不带任何参数将显示打开对话框如果从中

选择了新建按钮则指定报表名为报表 1 关闭报表设计器时可以用另外的名

字保存报表

有关创建和修改报表的详细内容请参阅帮助中用户指南的第七章设计报表和标

签

请参阅

_ A S C I I C O L S , _ A S C I I R O W S , C R E A T E R E P O R T , R E P O R T

M O D I F Y S C R E E N 命令

包含此命令是为了提供向后兼容性请使用 M O D I F Y F O R M 命令

M O D I F Y S T R U C T U R E 命令

显示表设计器从中可以修改表的结构

语法

M O D I F Y S T R U C T U R E说明

在 F o x P r o 的早期版本中 M O D I F Y S T R U C T U R E 命令打开表结构对话框

如果在当前选定的工作区中没有打开表则显示打开对话框以允许您选择要修改的

表

对表结构可做的更改包括添加和删除字段修改字段名称大小和数据类型添加删

除或修改索引标识指定支持 nu l l 值的字段

还可以通过界面修改表结构详细内容请参阅帮助中用户指南的第二章创建表

和索引中的修改表

注意把字段从一种数据类型更改为另一种数据类型并不完全转换字段的内

容或者根本不转换例如如果将日期类型的字段转换成数值类

型则字段内容不转换

在更改表结构之前 V i s u a l F o x P r o 自动备份当前表当修改完之后将备份表中包含的

数据追加到新修改的表结构中如果表有一个备注字段也将创建一个备注备份文件

表备份文件的扩展名为 . B A K 备注备份文件的扩展名是 . T B K

如果接受对结构的更改然后中断数据复制过程则新表不包含原表的所有记录

记住 V i s u a l F o x P r o 为原表文件创建一个 . B A K 文件并且为原备注文件如果存在

创建一个 . T B K 备份文件如果使用 M O D I F Y S T R U C T U R E 命令时出现问题可以删

除新文件并且把 . B A K 文件和 . T B K 文件改回为原文件扩展名 . D B F 和 . F P T

当修改一个具有备注字段的表结构时备注文件的块大小设置为当前的块大小可以用

S E T B L O C K S I Z E 命令指定备注文件的块大小

请参阅

A L T E R T A B L E -S Q L , C R E A T E , C R E A T E T A B L E -S Q L , S E TB L O C K S I Z E

M O D I F Y V I E W 命令

显示视图设计器从中可以修改已存在的 S Q L 视图

语法

M O D I F Y V I E W V i e w N a m e [ R E M O T E ]参数描述

V i e w N a m e指定要修改的视图名称

R E M O T E指定该视图是一个使用远程表的远程视图如果省略 R E M O T E 子句可以修

改一个基于本地表的视图

说明

使用 C R E A T E S Q L V I E W 命令创建 S Q L 视图

请参阅

C R E A T E S Q L V I E W , O P E N D A T A B A S E

M O D I F Y W I N D O W 命令

修改用户自定义窗口或 V i s u a l F o x P r o 主窗口

语法

M O D I F Y W I N D O W W i n d o w N a m e | S C R E E N[ F R O M n R o w 1 , n C o l u m n 1 T O n R o w 2 , n C o l u m n 2| A T n R o w 3 , n C o l u m n 3 S I Z E n R o w 4 , n C o l u m n 4 ][ F O N T c F o n t N a m e [ , n F o n t S i z e ] ]

[ S T Y L E c F o n t S t y l e ][ T I T L E c T i t l e T e x t][ H A L F H E I G H T ][ D O U B L E | P A N E L | N O N E | S Y S T E M ][ C L O S E | N O C L O S E ][ F L O A T | N O F L O A T ][ G R O W | N O G R O W ][ M I N I M I Z E | N O M I N I M I Z E ][ Z O O M | N O Z O O M ][ I C O N F I L E F i l e N a m e 1 ][ F I L L F I L E F i l e N a m e 2 ][ C O L O R S C H E M E n S c h e m e N u m b e r| C O L O R C o l o r P a i r L i s t]

参数描述

W i n d o w N a m e指定要修改的用户自定义窗口要修改的窗口必须先用 D E F I N E W I N D O W 命令创建

S C R E E N指定要修改 V i s u a l F o x P r o 主窗口 S C R E E N 不能缩写否则 V i s u a l F o x P r o 会产生错误信息要想将 V i s u a l F o x P r o 主窗口返回到它启动时的配置发出下

面的命令并且不带任何附加子句

M O D I F Y W I N D O W S C R E E N

提示可以用 M O D I F Y W I N D O W S C R E E N N O C L O S E 命令防止意外地过早终止

V i s u a l F o x P r o有关 M O D I F Y W I N D O W 子句的详细内容请参阅 D E F I N E W I N D O W 命令

说明

M O D I F Y W I N D O W 命令更改一个已存在的用户自定义窗口该窗口用 D E F I N E

W I N D O W 命令创建或 V i s u a l F o x P r o 主窗口的属性 M O D I F Y W I N D O W 命令不能用

来更改 V i s u a l F o x P r o 系统窗口例如命令窗口和浏览窗口的属性

可以使用 M O D I F Y W I N D O W 命令更改用户自定义的窗口或 V i s u a l F o x P r o 主窗口的位

置默认字体标题边框控制图标壁纸或颜色可以包含前面列出的子句从而

更改这些属性注意如果您想更改颜色必须先用 C L E A R 命令使颜色的更改生

效

例如要想指定用户自定义窗口或 V i s u a l F o x P r o 主窗口的新位置和大小需要包含

F R O M 和 T O 或者 A T 和 S I Z E 子句要想防止用户自定义窗口或 V i s u a l F o x P r o 主窗口

被移动需要包含 N O F L O A T 关键字

示例

下面的示例更改 V i s u a l F o x P r o 主窗口标题栏的内容M O D I F Y W I N D O W S C R E E N T I T L E '应用程序 '

请参阅

D E F I N E W I N D O W , _ S C R E E N

M O N T H 函数

返回给定日期表达式中的月份

语法

M O N T H ( d E x p r e s s i o n | t E x p r e s s i o n )返值类型

数值型

参数描述

d E x p r e s s i o n指定的日期表达式用 M O N T H 函数返回其月份值

t E x p r e s s i o n指定的日期时间表达式用 M O N T H 函数返回其月份值

说明

M O N T H 函数返回从 1 到 1 2 的一个数一月是 1 十二月是 1 2

示例

C L E A R? D A T E & & 显示今天的日期? D A T E & & 显示月份的序号S T O R E { ^ 1 9 9 8 - 0 5 - 0 3 } T O g d B u yS T O R E g d B u y + 3 1 T O g d M o n t h? g d M o n t h & & 显示 6

请参阅

C M O N T H , D A Y , S Y S 函数概览 , Y E A R

M O U S E 命令

单击双击移动或拖动鼠标

语法

M O U S E [ C L I C K | D B L C L I C K ] [ A T n R o w 1 , n C o l u m n 1 ]| D R A G T O n R o w 2 , n C o l u m n 2 , n R o w 3 , n C o l u m n 3 . . . ]

[ P I X E L S ][W I N D O W c W i n d o w N a m e ][ L E F T | M I D D L E | R I G H T ][ S H I F T ] [ C O N T R O L ] [ A L T ]

参数描述

C L I C K | D B L C L I C K指定单击或双击鼠标如果省略 A T 子句则在鼠标指针的当前位置单击或双

击鼠标

A T n R o w 1 , n C o l u m n 1指定在哪里单击或双击鼠标或者是把鼠标指针移动到哪里如果省略

C L I C K 或 D B L C L I C K 则鼠标指针移动到 n R o w 1 n C o l u m n 1 指定的位置

除非指定一个窗口否则 n R o w 1 n C o l u m n 1 指定的位置相对于 V i s u a l F o x P r o 主窗口

并且由 V i s u a l F o x P r o 主窗口的字体决定大部分字体可以按一系列大小显示有一些能

按比例安排间隔一行对应于当前字体的高度一列对应于当前字体的字母平均宽度

不能用 A T 子句选择一个 V i s u a l F o x P r o 菜单标题使用 S Y S ( 1 5 0 0 ) – 激活系统目录

项命令代替

D R A G T O n R o w 2 , n C o l u m n 2 , n R o w 3 , n C o l u m n 3 . . . ]指定把鼠标指针拖动到一个或一系列位置

当拖动鼠标指针时按下一个鼠标键并保持不放直到鼠标指针到达目标位置后释放鼠

标键如果省略 L E F T M I D D L E 和 R I G H T 子句则默认按下左鼠标键主键并保持

不放

D R A G 子句接受多组的 nRow n C o l u m n 坐标从而将鼠标指针拖动到多个位置如果包

含了 C L I C K 或 D B L C L I C K 子句则在当前位置单击或双击鼠标然后将鼠标指针拖动

到指定位置

P I X E L S指定在 A T 和 D R A G T O 子句中包含的位置是以像素为单位

如果省略 P I X E L S 子句则位置由 V i s u a l F o x P r o 主窗口或用 c W i n d o w N a m e 指定窗口的

字体决定大部分字体可以按一系列尺寸显示有一些能按比例安排间隔一个行对应

于当前字体的高度一个列对应于当前字体的字母平均宽度

W I N D O W c W i n d o w N a m e指定一个窗口 A T 和 D R A G T O 子句的坐标相对于这个窗口如果不包含

W I N D O W 子句和一个活动窗口名则 A T 和 D R A G T O 子句的坐标相对于

V i s u a l F o x P r o 主窗口

若想指定一个系统窗口和一个工具栏应把整个系统窗口或工具栏名称括在引号中

L E F T | M I D D L E | R I G H T指定当单击双击或拖动鼠标时按下哪个鼠标键如果省略 L E F TM ID D L E 和 R I G H T 子句默认按下左鼠标键主键

[ S H I F T ] [ C O N T R O L ] [ A L T ]指定当单击双击或拖动鼠标时按下的一个键 S H I F T 指定 S H I F T 键 C T R L指定 C T R L 键 A L T 指定 A L T 键

可以指定 S H I F T C T R L 和 A L T 键的任意组合

说明

M O U S E 命令通常用来自动测试交互的应用程序或者创建演示程序

示例

下面的示例中第一个命令在 Visual F o x P r o 主窗口中的第三行和列单击鼠标第二个

命令在 Visual F o x P r o 主窗口中的第三行和列单击鼠标然后拖动鼠标指针到

Visual 主窗口中的第十行和列第三个命令从当前位置拖动鼠标指针到第二十行

和列第四个命令在当前位置双击鼠标再拖动鼠标指针到第三十行和列最后一个命

令从当前位置拖动鼠标指针到第十行和列然后是第二十行和列再到第三十行和列M O U S E C L I C K A T 3 , 3M O U S E C L I C K A T 3 , 3 D R A G T O 1 0 , 1 0M O U S E D R A G T O 2 0 , 2 0M O U S E D B L C L I C K D R A G T O 3 0 , 3 0M O U S E D R A G T O 1 0 , 1 0 , 2 0 , 2 0 , 3 0 , 3 0

请参阅

M C O L , M D O W N , M R O W , S Y S ( 1 5 0 0 )

M o u s e D o w n 事件

当用户按下一个鼠标键时发生

语法

P R O C E D U R E O b jec t .M o u s e D o w n[ L P A R A M E T E R S n I n d e x , n B u t t o n , n S h i f t , n X C o o r d , n Y C o o r d ]–或者 –

L P A R A M E T E R S n B u t t o n , n S h i f t , n X C o o r d , n Y C o o r d参数描述

必须在事件过程中包含 L P A R A M E T E R S 或 P A R A M E T E R S 语句并且为每个参数指定一

个名称 Visual FoxPro 按下列顺序把 5 个参数中的 4 个传送给 M o u s e D o w n 事件

n I n d e x存放一个数它唯一标识控件数组中的一个控件仅当控件是控件数组的一部

分时才传送 n I n d e x 参数

n B u t t o n存放一个数它指定为触发事件需要按下哪个键 1 (左 ) 2 (右 ) 或 4 (中 )

n S h i f t存放一个数它指定当按下用 n B u t t o n 设置的键时 S H I F T C T R L 和 A L T 键的状

态

下表列出了单独修改键在 n S h i f t 中返回的值

n S h i f t 的修改键值

W i n d o w s 键值

S H I F T 1

C T R L 2

A L T 4

如果按下了一个键就设置一个位 nShif t 参数是这些位的和低位对应于 S H I F T 键 0

位 C T R L 键 1 位 A L T 键 2 位这些位分别对应于 1 2 和 4 nShift 参数表明这

些键的状态部分全部或没有设置三个位表明部分全部或没有按下三个键例如

如果 C T R L 和 A L T 键全部按下那么 nShif t 的值为 6

n X C o o r d , n Y C o o r d存放表单中鼠标指针当前的水平 ( n X C o o r d ) 和垂直 ( n Y C o o r d ) 位置这些坐标

总是以 S c a l e M o d e 属性设置值为度量单位按照指定表单的坐标系统表达

的

说明

用 M o u s e D o w n 过程指定按下鼠标键时发生的动作与 C l i c k 和 D b l C l i c k 事件不同可

以用 M o u s e D o w n 事件区别左右中鼠标键也可以为使用 S H I F T C T R L 和 A L T 键的

鼠标 -键盘组合编写代码

注意可以用 M o u s e M o v e 事件响应由鼠标移动引起的事件 M o u s e D o w n 和M o u s e U p 使用的 n B u t t o n 参数与 M o u s e M o v e 使用的 n B u t t o n 参数不

同对于 M o u s e D o w n 或 M o u s e U p 每个事件中 n B u t t o n 参数确切地指

明一个键对于 M o u s e M o v e 它表明了所有键的当前状态

应用于

复选框组合框命令按钮命令组容器对象控件对象编辑框表单表格标

头图像标签线条列表框选项按钮选项组页面页框形状微调文本

框工具栏

请参阅

C l i c k 事件 , D b l C l i c k 事件 , M i d d l e C l i c k 事件 , M o u s e M o v e 事件 , M o u s e P o i n t e r

属性 , M o u s e U p 事件 , M o u s e W h e e l 事件

M o u s e I c o n 属性

指定当鼠标指针位于一个对象上时所显示的鼠标指针图标设计和运行时可用

语法

O b j e c t.M o u s e I c o n [ = c F i l e N a m e]参数描述

c F i l e N a m e指定当鼠标指针位于一个对象上时所显示的文件可以指定鼠标图标 ( .i c o )文件一个鼠标指针 ( . c u r ) 文件或一个动画鼠标指针 (. a n i ) 文件

说明

设置 M o u s e P o i n t e r 属性为 9 9 自定义可以显示鼠标图标

应用于

复选框组合框命令按钮命令按钮组容器对象控件对象编辑框

表单表格图片标签线条列表框 O L E 绑定型控件 O L E 容器控

件选项按钮选项按钮组 _ S C R E E N 图形微调文本框工具栏

请参阅



当用户在一个对象上移动鼠标时发生

语法

P R O C E D U R E O b jec t .M o u s e M o v e , [ L P A R A M E T E R S n I n d e x , n B u t t o n , n S h i f t ,n X C o o r d , n Y C o o r d ]–或者 –

L P A R A M E T E R S n B u t t o n , n S h i f t , n X C o o r d , n Y C o o r d参数描述

必须在事件过程中包含 L P A R A M E T E R S 或 P A R A M E T E R S 语句并且为每个参数指定

一个名称 V i s u a l F o x P r o 按下列顺序把 5 个参数中的 4 个传送给 M o u s e M o v e 事件

n I n d e x存放一个数它唯一标识控件数组中的一个控件仅当控件是控件数组的一部

分时才传送 n I n d e x 参数

n B u t t o n存放一个数它以位总和的形式指定鼠标键的状态如下表所示

对 n B u t t o n 的鼠标按钮值

W i n d o w s n B u t t o n V a l u e

左鼠标键 1

右鼠标键 2

中鼠标键 4

如果按下了一个键则设置一个位 n B u t t o n 参数表明设置了哪个位 0 位相应于左鼠标

键 1 位相应于右鼠标键 2 位相应于中鼠标键对于三种情况 n B u t t o n 分别取值为 1

2 4 它表明了鼠标键的各种状态部分全部或不设置三个位表明部分全部或

没有鼠标键按下可能的取值从 0 到 7 单个鼠标键相应于下列值 1 (左 ) 2 (右 ) 和 4

(中 ) 例如如果左和右鼠标键都按下了则 n B u t t o n 的值为 3

n S h i f t存放一个数它指定在 V i s u a l F o x P r o f o r W i n d o w s 中移动鼠标时 S H I F T

C T R L 和 A L T 键的状态

下表列出了单独修改键在 n S h i f t 中返回的值



S H I F T 1

C T R L 2

A L T 4

如果按下鼠标时有多于一个的修改键也被按下则 n S h i f t 参数是这些修改键的和例

如在 Visual F o x P r o f o r W i n d o w s 中如果按下鼠标按钮时也按下 C T R L 键那么

nSh i f t 的值为 2 但是如果 C T R L 和 A L T 键全部按下那么 n S h i f t 的值为 6

n X C o o r d , n Y C o o r d存放表单中鼠标指针当前的水平 ( n X C o o r d ) 和垂直 ( n Y C o o r d )位置这些坐标

总是以 S c a l e M o d e 属性的设置值为度量单位按照指定的表单坐标系统表达

的

当鼠标指针在对象之间移动时连续触发 M o u s e M o v e 事件

注意可以用 M o u s e D o w n 和 M o u s e U p 事件响应由按下和释放鼠标键引起的事

件

M o u s e M o v e 使用的 n B u t t o n 参数与 M o u s e D o w n 和 M o u s e U p 使用的 n B u t t o n参数不同对于 M o u s e M o v e n B u t t o n 参数表明了所有键的当前状

态一个单独的 M o u s e M o v e 事件可以表明部分全部或没有按下任何

键对于 M o u s e D o w n 或 M o u s e U p 每个事件中 n B u t t o n 参数确切地指

明一个键

要避免在 M o u s e M o v e 事件过程中移动一个窗口这会引起级联事件并产生

运行错误例如堆栈溢出当窗口在指针下移动时会触发 M o u s e M o v e事件这样即使鼠标静止时也会触发一个 M o u s e M o v e 事件

应用于

复选框列组合框命令按钮命令组容器对象控件对象编辑框表单表

格标头图像标签线条列表框选项按钮选项组页面页框形状微

调文本框工具栏

请参阅

C l i c k 事件 , D b l C l i c k 事件 , M i d d l e C l i c k 事件 , M o u s e P o i n t e r 属性 , M o u s e D o w n事件 , M o u s e U p 事件 , M o u s e W h e e l 事件


指定运行时鼠标在一个对象的特定位置之上时鼠标指针的形状设计和运行时该属

性均可用

语法

O b j e c t.M o u s e P o i n t e r [ = n T y p e ]参数描述

n T y p eM o u s e P o i n t e r 属性的设置有

设置说明

0 (默认值 )由对象决定的形式

1 箭头

2 十字标一个十字指针

3 I 型标

4 图标一个黑块中的一个小白块

5 尺寸调整标指向东西南北的四箭头

6 东北 -西南方向尺寸调整标指向东北和西南的双箭头

7 南北方向尺寸调整标指向南北的双箭头

8 西北 -东南方向尺寸调整标指向西北和东南的双箭头

9 东西方向尺寸调整标指向东西的双箭头

1 0 向上的箭头

1 1 沙漏

1 2 禁止停放

1 3 隐藏指针

1 4 箭头

注意用属性单设置 M o u s e P o i n t e r 属性时下拉列表显示了应用于 V i s u a lF o x P r o f o r W i n d o w s 的设置名称

说明

MousePointer 属性可以用来表明当鼠标指针经过表单或对话框上的控件时功能的变化例

如可以把 MousePointer 属性设置为 11 (沙漏 ) 表明用户需要等待某过程的结束

应用于

复选框组合框命令按钮命令组容器对象控件对象编辑框表单表格图

像标签线条列表框 O L E 绑定型控件 O L E 容器控件选项按钮选项组

_ S C R E E N 形状微调文本框工具栏

请参阅


M o u s e U p 事件

当用户释放一个鼠标键时发生

语法

P R O C E D U R E O b jec t .M o u s e U p[ L P A R A M E T E R S n B u t t o n , n S h i f t , n X C o o r d , n Y C o o r d ]–或者 –L P A R A M E T E R S n I n d e x , n B u t t o n , n S h i f t , n X C o o r d , n Y C o o r d参数描述

必须在事件过程中包含 L P A R A M E T E R S 或 P A R A M E T E R S 语句并且为每个参数指定一

个名称 Visua l FoxPro 按下列顺序把 5 个参数中的 4 个传送给 M o u s e U p 事件

n I n d e x存放一个数它唯一标识控件数组中的一个控件

n B u t t o n存放一个数它指定为引发事件而释放哪个键 1 (左 ) 2 (右 )和 4 (中 )

n S h i f t存放一个数它指定当释放 n B u t t o n 参数指定的键时 S H I F T C T R L 和 A L T 键的状

态 1 ( S H I F T ) 2 ( C T R L ) 4 ( A L T )下表列出了单独修改键在 n S h i f t 中返回的值



S H I F T 1

C T R L 2

A L T 4

如果按下鼠标时有多于一个的修改键也被按下则 n S h i f t 参数是这些修改键的和例

如在 Visual F o x P r o f o r W i n d o w s 中如果按下鼠标按钮时也按下 C T R L 键那么

nSh i f t 的值为 2 但是如果 C T R L 和 A L T 键全部按下那么 n S h i f t 的值为 6

n X C o o r d , n Y C o o r d存放鼠标指针在表单中当前的水平 ( n X C o o r d ) 和垂直 ( n Y C o o r d ) 位置这些坐

标总是以 S c a l e M o d e 属性的设置值为度量单位按照指定的表单坐标系统表

达的

说明

可用 M o u s e U p 过程指定释放鼠标键时发生的动作与 C l i c k 和 D b l C l i c k 事件不同可

以用 M o u s e U p 事件区别左右中鼠标键也可以为使用 S H I F T C T R L 和 A L T 键的鼠

标 -键盘组合编写代码

可以用 M o u s e M o v e 过程响应由移动鼠标引起的事件

注意 M o u s e D o w n 和 M o u s e U p 使用的 n B u t t o n 参数与 M o u s e M o v e 使用的

n B u t t o n 参数不同对于 M o u s e D o w n 或 M o u s e U p 每个事件中的

n B u t t o n 参数确切地指明一个键对于 M o u s e M o v e 它表明了所有键

的当前状态

应用于

复选框组合框命令按钮命令组容器对象控件对象编辑框表单表格标

头图像标签线条列表框选项按钮选项组页面页框形状微调文本

框工具栏

请参阅

C l i c k 事件 , D b l C l i c k 事件 , M i d d l e C l i c k 事件 , M o u s e D o w n 事件 , M o u s e M o v e事件 , M o u s e P o i n t e r 属性 , M o u s e W h e e l 事件 , S c a l e M o d e 属性

M o u s e W h e e l 事件

当用户在一个具有轮的鼠标设备上滚动鼠标轮时发生

语法

P R O C E D U R E O b jec t .M o u s e W h e e lL P A R A M E T E R S [ n I n d e x , ] n D i r e c t i o n , n S h i f t , n X C o o r d , n Y C o o r d参数描述

在事件过程中必须包含一个 L P A R A M E T E R S 或 P A R A M E T E R S 语句并且指定每个参

数的名称 V i s u a l F o x P r o 按以下顺序向 M o u s e W h e e l 事件传递四或五个参数

n I n d e x如果一个控件在一个控件数组中则本参数唯一标识该控件只有当一个控件

在一个控件数组中时才传递 n I n d e x 参数

n D i r e c t i o n包含了一个依靠鼠标设备的数它表示了鼠标球转动的方向负值表示鼠标球

向后转动而正值表示鼠标球向前转动

n S h i f t包含一个指定当鼠标轮滚动时修饰键的状态有效的修饰键有 S H I F T C T R L和 A L T 键

下表列出了 n S h i f t 的单个修饰键的返回值

值键

1 S H I F T

2 C T R L

4 A L T

如果当鼠标轮滚动时按下了多个修饰键则 nShi f t 参数包含各修饰键的值的和例如

在 Visual F o x P r o f o r W i n d o w s 中如果按下鼠标按钮时也按下 C T R L 键那么 n S h i f t 的

值为 2 但是如果 C 中文版中文版 T R L 和 A L T 键全部按下那么 n S h i f t 的值为 6

n X C o o r d , n Y C o o r d包含鼠标指针在表单中的当前水平 (n X C o o r d ) 和垂直 ( n Y C o o r d ) 位置这些

坐标是按表单的坐标系统表达的度量单位由 S c a l e M o d e 属性的设置确定

应用于

复选框列组合框命令按钮命令按钮组容器对象控件对象编辑框表单

表格标头图像标签线条列表框选项按钮选项按钮组页面页框形

状微调文本框工具栏

请参阅

C l i c k 事件 , M i d d l e C l i c k 事件 , M o u s e P o i n t e r 属性 , M o u s e D o w n 事件 ,MouseUp 事件

M o v a b l e 属性

指定用户是否可以在运行时移动一个对象设计时可用运行时可读写

语法

O b j e c t.M o v a b l e [ = l E x p r]参数描述

l E x p rM o v a b l e 属性的设置有

设置说明

真

( .T . )

(默认值 )可以移动对象对 V i s u a l F o x P r o f o r W i n d o w s 中的表单 , 在

控件菜单中添加 M o v e 命令

假

( .F.)

不能移动对象对于表格列不能人工直接移动表格列但是如

果更改了列的 C o l u m n O r d e r 属性或者把另一个列移动到它上面就

可以移动列

应用于

列表单 _ S C R E E N 工具栏

请参阅

S i z a b l e 属性

M o v e 方法

移动一个对象

语法

O b j e c t.M o v e ( n L e f t [ , n T o p [ , n W idth [ , n H e i g h t] ] ] )参数描述

n L e f t指定对象左边沿的水平坐标 n L e f t 是一个单精度值

n T o p指定对象上边沿的垂直坐标 n T o p 是一个单精度值

n W idth指定对象的新宽度 n W i d t h 是一个单精度值

n H e i g h t指定对象的新高度 n H e i g h t 是一个单精度值

说明

只有 nLe f t 参数是必需的但是如果想要包含任何其他的参数也必需包含语法中该

参数前的所有参数例如不能指定了 n W i d t h 而不指定 nLe f t 和 n T o p 任何未指定的

后继参数将保持不变

在屏幕上移动表单或在表单中移动控件时都是相对于原点 (0 0 ) 原点位于左上

角当在容器中移动控件时使用容器的坐标系

应用于

复选框组合框命令按钮命令组容器对象控件对象编辑框表单表格图

像标签线条列表框 O L E 绑定型控件 O L E 容器控件选项按钮选项组页

框 _ S C R E E N 形状微调文本框工具栏

请参阅

T o p 属性 , W i d t h 属性

M O V E P O P U P 命令

把用 D E F I N E P O P U P 命令创建的用户自定义菜单移动到新位置

语法

M O V E P O P U P M e n u N a m e T O n R o w 1 , n C o l u m n 1 | B Y n R o w 2 , n C o l u m n 2参数描述

M e n u N a m e指定要移动的菜单

在 V i s u a l F o x P r o 中不能移动系统菜单

T O n R o w 1 , n C o l u m n 1在用户自定义窗口或 V i s u a l F o x P r o 主窗口中把菜单移动到由 n R o w 1n C o l u m n l 指定的新位置

B Y n R o w 2 , n C o l u m n 2相对于当前位置移动菜单数值表达式 n R o w 2 指定了移动菜单的行数如果

n R o w 2 是正值就向下移动如果是负值就向上移动数值表达式 n C o l u m n 2指定了移动菜单的列数如果 n C o l u m n 2 是正值就向右移动如果是负值就

向左移动

说明

可以把菜单移动到指定位置或者相对它的当前位置移动菜单只要菜单已定义就可

以移动它它不必是活动或可见的

示例

下面的示例定义并激活了一个菜单然后移动和更改其大小C L O S E D A T A B A S EC L E A RD E F I N E P O P U P p o p M o v I n F R O M 2 , 2 T O 7 , 1 4 P R O M P T F I L E S L I K E * . P R G ;

T I T L E ' P r o g r a m s 'A C T I V A T E P O P U P p o p M o v I n N O W A I T= C H R S A W ( 2 )

p o p M o v I n 5 , 5 & & 下移菜单

= C H R S A W ( 2 )S I Z E P O P U P p o p M o v I n B Y 5 , 5 & & 扩大菜单= C H R S A W ( 2 )S I Z E P O P U P p o p M o v I n B Y - 5 , - 5 & & 收缩菜单= C H R S A W ( 2 )

p o p M o v I n - 5 , - 5 & & 上移菜单= C H R S A W ( 2 )D E A C T I V A T E P O P U P p o p M o v I nR E L E A S E P O P U P p o p M o v I n

请参阅

A C T I V A T E P O P U P , D E F I N E P O P U P , S I Z E P O P U P

M O V E W I N D O W 命令

把窗口移动到新位置该窗口可以是用 D E F I N E W I N D O W 命令创建的用户自定义窗

口或者是 V i s u a l F o x P r o 系统窗口例如命令窗口或浏览窗口

语法

M O V E W I N D O W W i n d o w N a m e T O n R o w 1 , n C o l u m n 1| B Y n R o w 2 , n C o l u m n 2 | C E N T E R

参数描述

W i n d o w N a m e指定要移动的窗口名

T O n R o w 1 , n C o l u m n 1在 V i s u a l F o x P r o 主窗口或用户自定义窗口中把窗口移动到由 n R o w 1 ,n C o l u m n 1 指定的位置

B Y n R o w 2 , n C o l u m n 2相对当前位置移动窗口数值表达式 n R o w 2 指定了移动窗口的行数如果

n R o w 2 是正值就向下移动如果是负值就向上移动数值表达式 n C o l u m n 2指定了移动窗口的列数如果 n C o l u m n 2 是正值就向右移动如果是负值就向

左移动

C E N T E R在 V i s u a l F o x P r o 主窗口或父窗口中居中放置窗口

说明

可以把窗口移动到指定位置也可以相对它的当前位置移动窗口只要窗口已定义就

可以移动它不必是活动或可见的

若要移动一个系统窗口和 / 或一个工具栏在 V i s u a l F o x P r o 中应把整个系统窗口名

称或工具栏名称括在引号中例如 , 若要在 V i s u a l F o x P r o 中移动报表控制工具栏还未

停放可以用下面命令M O V E W I N D O W " R e p o r t C o n t r o l s " B Y 1 , 1

示例

在下面的示例中定义并激活了窗口 w E n t e r 后移动窗口D E F I N E W I N D O W w E n t e r F R O M 1 0 , 4 T O 1 5 , 5 4 S Y S T E M ;

T I T L E " N o m a d i c W i n d o w "A C T I V A T E W I N D O W w E n t e rW A I T W I N D O W ' P r e s s a n y k e y t o m o v e t h e w i n d o w '

w E n t e r 2 0 , 1 5W A I T W I N D O W ' P r e s s a n y k e y t o c e n t e r t h e w i n d o w '

w E n t e r W A I T W I N D O W ' P r e s s a n y k e y t o r e l e a s e t h e w i n d o w 'R E L E A S E W I N D O W w E n t e r

请参阅

A C T I V A T E W I N D O W

M o v e d 事件

当对象移动到新位置时或者以编程方式更改容器对象的 T o p 或 Le f t 属性设置时发

生

语法

P R O C E D U R E O b j e c t.M o v e d

说明

当对象移动到新位置时或者在代码中更改 T o p 或 Le f t 属性时发生

应用于

列容器对象控件对象表单表格 O L E 绑定型控件 O L E 容器控件页框工

具栏

请参阅

C o l u m n O r d e r 属性 , L e f t 属性 , T o p 属性

M o v e r B a r s 属性

指定是否在 L i s t B o x 控件中显示移动钮一栏设计时可用运行时可读写

语法

L i s t B o x .M o v e r B a r s [ = l E x p r]参数描述

l E x p rM o v e r B a r s 属性的设置有

设置说明

真

( .T . )

显示移动钮栏用户可以交互地重新排序控件中的内容

假

( .F.)

(默认值 )不显示移动钮栏

说明

仅当 R o w S o u r c e T y p e 属性设置为 0 或 1 时 M o v e r B a r s 属性才可用

应用于

列表框

请参阅

R o w S o u r c e T y p e 属性 , S c r o l l B a r s 属性

M R K B A R 函数

确定是否已标记用户自定义菜单或 V i s u a l F o x P r o 系统菜单中的一个菜单项

语法

M R K B A R (c M e n u N a m e , n M e n u I t e m N u m b e r | c S y s t e m M e n u I t e m N a m e )返值类型

逻辑值

参数描述

c M e n u N a m e指定包含该菜单项的菜单名称菜单可以是 V s i a u l F o x P r o 系统菜单例如

_ M F I L E M E D I T 或 _ M D A T An M e n u I t e m N u m b e r

指定用户自定义菜单中菜单项的编号用 D E F I N E B A R 命令创建菜单项时

就确定了菜单项的编号

c S y s t e m M e n u I t e m N a m e指定 V i s u a l F o x P r o 系统菜单项名称例如下面的命令显示一个逻辑值该

值指定是否标记文件菜单上的新建菜单项

? M R K B A R ( ' _ M F I L E ' , _ M F I _ N E W )

说明

可用 S E T M A R K O F 命令添加或移去一个菜单项的标记

如果标记了指定菜单项 M R K B A R 函数返回真 ( .T.) 否则 M R K B A R 函

数返回假 (.F.)

有关 M R K B A R 函数的例子请参阅 C N T B A R

请参阅

M R K P A D , S E T M A R K O F , S E T M A R K T O

M R K P A D 函数

确定是否已标记了用户自定义菜单或 V i s u a l F o x P r o 系统菜单栏中的一个菜单标题

语法

M R K P A D (c M e n u B a r N a m e , c M e n u T i t l e N a m e)返值类型

逻辑值

参数描述

c M e n u B a r N a m e指定包含该菜单标题的菜单栏名称

c M e n u T i t l e N a m e指定菜单标题名称

说明

用 S E T M A R K O F 命令可以添加或移去一个菜单标题的标记

如果标记了指定的菜单标题 M R K P A D 函数返回真 ( .T . ) 否则 M R K P A D

函数返回假 ( .F.)

示例

下面的程序示例 M A R K P A D . P R G 在选择了菜单标题时使用 M R K P A D 来切换

其标记字符

用 S E T S Y S M E N U S A V E 将当前的系统菜单栏保存到内存中并且用 S E T S Y S M E N U

T O 删除所有的系统菜单项

用 D E F I N E P A D 创建几个系统菜单项当选中了一个菜单项时执行 c h o i c e 过程

c h o i c e 显示所选的菜单项和菜单栏名称用 S E T M A R K O F 和 M R K P A D 来显示或

删除菜单项的标记字符如果选择了退出菜单标题则恢复最初的 Visual F o x P r o

系统菜单* * * 给该程序命名为 M A R K P A D . P R G * * *C L E A RS E T S Y S M E N U S A V ES E T S Y S M E N U T OS E T M A R K O F M E N U _ M S Y S M E N U T O C H R ( 4 )P U B L I C g l M a r k P a dg l M a r k P a d = . T .D E F I N E P A D p a d S y s O F _ M S Y S M E N U P R O M P T ' \ < S y s t e m ' C O L O R S C H E M E 3 ;

K E Y A L T + S , ' 'D E F I N E P A D p a d E d i t O F _ M S Y S M E N U P R O M P T ' \ < E d i t ' C O L O R S C H E M E 3 ;

K E Y A L T + E , ' 'D E F I N E P A D p a d R e c o r d O F _ M S Y S M E N U P R O M P T ' \ < R e c o r d ' C O L O R S C H E M E 3 ;

K E Y A L T + R , ' 'D E F I N E P A D p a d W i n d o w O F _ M S Y S M E N U P R O M P T ' \ < W i n d o w ' C O L O R S C H E M E 3 K E Y A L T + W , ' '

D E F I N E P A D p a d R e p o r t O F _ M S Y S M E N U P R O M P T ' R e \ < p o r t s ' C O L O R S C H E M E 3 ;K E Y A L T + P , ' '

D E F I N E P A D p a d E x i t O F _ M S Y S M E N U P R O M P T ' E \ < x i t ' C O L O R S C H E M E 3 ;K E Y A L T + X , ' '

O N S E L E C T I O N M E N U _ M S Y S M E N U ;D O c h o i c e I N m a r k p a d W I T H P A D , M E N U

P R O C E D U R E c h o i c eP A R A M E T E R g c P a d , g c M e n uW A I T W I N D O W ' Y o u c h o s e ' + g c P a d + ;

' f r o m m e n u ' + g c M e n u N O W A I TS E T M A R K O F P A D ( g c P a d ) O F _ M S Y S M E N U T O ;

! ' _ M S Y S M E N U ' , g c P a dg l M a r k P a d = ! g l M a r k P a dI F g c P a d = ' P A D E X I T '

S E T S Y S M E N U T O D E F A U L TE N D I F

请参阅

M R K B A R , S E T M A R K O F

M R O W 函数

返回 V i s u a l F o x P r o 主窗口或用户自定义窗口中鼠标指针的行位置

语法

M R O W ( [ c W i n d o w N a m e [ , n S c a l e M o d e ] ] )返值类型

数值型

参数描述

c W i n d o w N a m e指定一窗口名 M R O W 函数返回鼠标指针在其中的行位置

n S c a l e M o d e设定 M R O W 返回值所使用的度量单位 n S c a l e M o d e 的设置是

n S c a l e M o d e 说明

0 默认 Foxe l s f o x e l 的大小是当前表单中字型宽与高的平均值

当开发可在字符平台和图形平台上跨平台运行的应用程序时 f o x e l

十分有用

续表

3 像素像素是屏幕和打印机的最小分辨单位在不同的屏幕中像素

的大小不同

说明

如果没有活动的用户自定义窗口并且省略了 c W i n d o w N a m e 可选参数则 M R O W 函

数返回鼠标指针在 V i s u a l F o x P r o 主窗口中的行位置

如果有一个活动的用户自定义窗口并且省略了 c W i n d o w N a m e 可选参数 M R O W

函数返回相对于该用户自定义窗口的鼠标指针行坐标如果鼠标指针指在用户自定义窗

口之外 M R O W 函数返回 -1 如果没有加载鼠标驱动程序并且没有输出窗口

M R O W 函数返回 -1

请参阅

A M O U S E O B J , C O L , G r i d H i t T e s t 方法 , I S M O U S E , M C O L ,

R O W , W C O L S , W R O W S

M T O N 函数

由货币型表达式返回一个数值型的值

语法

M T O N (m E x p r e s s i o n )返值类型

数值型

参数描述

m E x p r e s s i o n指定的一个货币型表达式 M T O N 函数返回它的值 m E x p r e s s i o n 计算结

果必须是有效的货币值否则 V i s u a l F o x P r o 产生错误

在数值型值前面加一个美元符号 ( $ ) 的前缀就可以创建一个货币型值

说明

M T O N 函数返回一个带四位小数的数值型值

示例

下面的示例创建了一个货币型变量 g y M o n e y T Y P E 显示 Y 表示此变量是货币

型用 M T O N 转换变量为数值型现在 T Y P E 显示 N 表示此变量转换后是

数值型S T O R E $ 2 4 . 9 5 T O g y M o n e y & & 创建一个货币型变量C L E A R? " g y M o n e y i s t y p e : "? ? T Y P E ( ' g y M o n e y ' ) & & 显示 Y , 货币型值

g y M o n e y = g y M o n e y & & 将 g y M o n e y 转化为数值型值? " g y M o n e y i s n o w t y p e : "? ? T Y P E ( ' g y M o n e y ' ) & & 显示 N , 数值型值

请参阅

N T O M

M ul t iSe lec t 属性

指定用户是否可以在一个列表框控件中作多项选择以及如何选择设计时可用运行

时可读写

语法

L i s t B o x .M u l t i S e l e c t [ = n C h o i c e ]参数描述

n C h o i c e下表列出了 M u l t i S e l e c t 属性的设置

设置说明

0 (默认值 )不允许做多项选择

1 允许做多项选择若要做多项选择按下 C T R L 键的同时单击各项

说明

为使用户能在列表中作多项选择需把 M u l t i S e l e c t 设置为真 (.T . ) 可以用 Se l ec t ed

属性确定选择了哪些项

示例

在下面的示例中创建了一个列表框它的 M u l t i S e l e c t 属性设置为真 ( .T.) 允许在列

表框中作多项选择出现在列表框上的项来源于一个数组这个数组是用

R o w S o u r c e T y p e 和 R o w S o u r c e 属性指定的

在 F O R . . . E N D F O R 循环中用 L i s t C o u n t 属性来显示列表框中已选择的一个或多个选

项用 S e l e c t e d 属性确定要选择的项用 L i s t 属性返回这些项C L E A R



f r m M y F o r m = C R E A T E O B J E C T ( ' F o r m ' ) & & 创建一个表单

f r m M y F o r m . C l o s a b l e = . f . & & 使控件菜单框失效


f r m M y F o r m . A d d O b j e c t ( ' c m b C o m m a n d 1 ' , ' c m d M y C m d B t n ' ) & & 添加退出命令按钮

f r m M y F o r m . A d d O b j e c t ( ' l s t L i s t B o x 1 ' , ' l s t M y L i s t B o x ' ) & & 添加列表框控件

f r m M y F o r m . l s t L i s t B o x 1 . R o w S o u r c e T y p e = 5 & & 指定一个数组

f r m M y F o r m . l s t L i s t B o x 1 . R o w S o u r c e = ' g a M y L i s t A r r a y ' & & 数组包含列表框选项

f r m M y F o r m . c m b C o m m a n d 1 . V i s i b l e = . T . & & 退出命令按钮可见

f r m M y F o r m . l s t L i s t B o x 1 . V i s i b l e = . T . & & 列表框可见

f r m M y F o r m . S H O W & & 显示表单R E A D E V E N T & & 开始事件过程

D E F I N E C L A S S c m d M y C m d B t n A S C o m m a n d B u t t o n & & 创建命令按钮

C a p t i o n = ' \ < Q u i t ' & & 命令按钮上的标题

C a n c e l = . T . & & 默认的取消命令按钮 (ESC)L e f t = 1 2 5 & & 命令按钮的列

T o p = 2 1 0 & & 命令按钮的行

H e i g h t = 2 5 & & 命令按钮的高度

P R O C E D U R E C l i c kC L E A R E V E N T & & 结束事件过程关闭表单

C L E A R & & 清除 V i s u a l F o x P r o 主窗口E N D D E F I N E

D E F I N E C L A S S l s t M y L i s t B o x A S L i s t B o x & & 创建列表框控件

L e f t = 1 0 & & 列表框的列

T o p = 1 0 & & 列表框的行

= . T . & & 允许选择多项

P R O C E D U R E C l i c k

A C T I V A T E S C R E E NC L E A R? "Se lec ted i t ems : "? "- - - - - - - - - - - - - - -"F O R n C n t = 1 T O T h i s F o r m . l s t L i s t B o x 1 . L i s t C o u n t

I F T h i s F o r m . l s t L i s t B o x 1 . S e l e c t e d ( n C n t ) & & 选择了这个项吗

? S P A C E ( 5 ) + T h i s F o r m . l s t L i s t B o x 1 . L i s t ( n C n t ) & & 显示该选项E N D I F

E N D F O R

E N D D E F I N E

应用于

列表框

请参阅

A d d I t e m 方法 , C l e a r 方法 , L i s t 属性 , L i s t C o u n t 属性 , N e w I t e m I D 属性 ,

R e m o v e I t e m 方法 , S e l e c t e d 属性 , T o p I t e m I D 属性

M W I N D O W 函数

返回鼠标指针所在的窗口名称

语法

M W I N D O W ( [ cW i n d o w N a m e ] )返值类型

字符型 , 逻辑值

参数描述

c W i n d o w N a m e指定一窗口名如果鼠标指针在它上面 M W I N D O W 函数返回真

( .T .) 否则 M W I N D O W 函数返回假 ( . F . )

说明

如果省略可选的窗口名称 M W I N D O W 函数返回鼠标指针所在的窗口名称或者

一个空字符串如果鼠标指针位于 V i s u a l F o x P r o 主窗口上

请参阅

M C O L , M D O W N , M R O W , W O N T O P , W O U T P U T

N a m e 属性

指定在代码中引用对象时所用的名称设计时可用运行时可读写

语法

O b j e c t.N a m e [ = c N a m e ]参数描述

c N a m e指定在代码中引用对象时所用的名称

说明

新建对象的默认名称是该对象的类型加上一个唯一的整数例如第一个新建表单对象

的名称是 F o r m l 而表单上创建的第三个文本框为 Tex t3

注意若对象为分层结构中的第一个对象 (即最外层容器 ) 应使用对象变量代

替 N a m e 属性来引用该对象

对于一个项目对象 N a m e 属性包含该项目的名称和路径并且在设计时和运行时只

读

对于一个文件对象 N a m e 属性包含该文件的名称和路径并且在设计时和运行时只

读

应用于

A c t i v e D o c 对象复选框列组合框命令按钮命令组容器对象控件对象临

时表自定义数据环境文件对象编辑框表单表单集表格标头图像标

签线条列表框 O L E 绑定型控件 O L E 容器控件选项按钮选项组页面页

框项目对象项目挂接对象关系 _ S C R E E N 形状微调文本框计时器工

具栏

请参阅

C a p t i o n 属性 , N e w I n d e x 属性 , N e w I t e m I D 属性 , S e r v e r N a m e 属性 ,T y p e L i b N a m e 属性

· 4 getlatestversion 方法 获得源代码管理器中项目的一个文件的最新版本...

Documents

· 4 getlatestversion 方法获得源代码管理器中项目的一个文件的最新版本...