microsoft word 对象
目 录
运用application对象
运用document对象
运用range对象
运用selection对象
运用find和replacement对象
运用table, column, row,和 cell对象
运用其他普通对象
判断对象是否有效
修改word 命令
运用事件
使用自动宏
使用自动化
visual basic支持一个对象集合,该集合中的对象直接对应于microsoft word 97中的元素,并且通过用户界面,用户熟悉这些元素中的绝大多数。例如,document 对象代表了一个打开的文档,bookmark对象代表了一个文档中的书签,而selection对象则代表了在一个文档窗口窗格中的选定内容。在word中,每一类元素-文档、表格、段落、书签、域等等-都可以用visual basic的对象来表示。要在word中自动执行任务,可以使用这些对象的方法和属性。
关于理解和使用microsoft office 97对象模型的一般性内容,请参阅本书的第二章“理解对象模型”。在microsoft office 97中的对象模型相当丰富,其中包含了大约180个对象。要查看word对象模型的层次关系图,请参阅“帮助”中的“microsoft word 对象”。要获得对某种特定对象的详细描述,可以在此图中单击该对象的名字,或是在“帮助”的索引中对特定对象进行搜索。
怎样显示word visual basic帮助
要使用word visual basic帮助,必须在安装过程中选择“自定义”的安装方式,并且为word选中“visual basic在线帮助”复选框。否则,安装程序不会安装visual basic帮助。如果用户已经安装好了word,那么可以再次运行setup程序来安装visual basic帮助。
要查看word visual basic 帮助,可以在“visual basic 编辑器里的“帮助”菜单中点击“目录和索引”一项。在“帮助主题”对话框的“目录”一表中,双击“microsoft word visual basic 参考”,然后再双击“visual basic 参考”。“帮助主题”对话框会重新出现,显示出microsoft word visual basic的目录和索引。
运用application 对象
在用户启动一个word 时段的同时,也创建了一个application对象。用户可以使用application 对象的属性或方法来控制或返回应用程序范围内的特性、控制应用程序窗口的外观或者调整word 对象模型的其他方面。可以使用application属性来返回word application 对象。以下的示例从视图状态切换到打印预览状态。
application. printpreview = true
application对象的一些属性控制着应用程序的外观。例如,如果displaystatusbar属性为true(真),那么状态栏是可见的,如果windowstate属性值为wdwindowstatemaximize,那么应用程序窗口处于最大化状态。以下的示例设置了屏幕上应用程序窗口的大小。
with application
.windowstate = wdwindowstatenormal
.height = 450
.width = 600
end with
application对象的属性也可以访问处于对象层次中较低级的对象,比如windows集合(代表了当前所有打开的窗口)和documents集合(代表了当前所有打开的文档)。用户可以使用属性,有时候也叫做访问者,从对象层次中最高一级的application对象向下访问到较低级的对象(document对象、window对象、 selection对象等等)。可以使用以下两个示例之一来打开mydoc.doc。
application. documents. open filename :="c:\docs\mydoc.doc"
documents. open filename :="c:\docs\mydoc.doc"
因为document属性是共用的,所以application属性是可选的。共用属性和方法无需application 对象限定符。要在“对象浏览器”中浏览共用属性和方法的列表,可以在“类别”栏中单击“<共用>”。共用项就会列在“成员”栏中。
注释 option对象包含了控制word 共用行为的一些属性。许多option对象的属性对应于option对话框中的各项(tools 菜单)。使用application 对象的option属性可以返回option 对象。以下的示例设置了三个应用程序范围内的选项(因为option属性是共用的,所以在本示例中无需application属性)。
with application.options
.allowdraganddrop = true
.confirmconversions = false
.measurementunit = wdpoints
end with
运用document对象
当用户在word中打开或创建一个文件的同时,也创建了一个document对象。用户可以使用document对象或documents集合的属性或方法来打开、创建、保存、激活或者关闭文件。
返回document对象
用户可以使用语法documents (index)来返回作为一个document对象的任何打开的文档,在这里index是该文档的名字或索引号。在以下的示例中,变量mydoc包含一个document对象,该对象代表名为“report.doc”的打开的文档。
set mydoc = documents ("report.doc")
索引号代表了文档在documents集合中的位置。在以下的示例中,变量mydoc包含了一个document对象,该对象代表documents集合中的第一个文档。
set mydoc = documents(1)
注释 因为当用户添加或关闭多个文档时,某个特定文档的索引号会发生改变,所以最好使用文档的名字来对documents集合中的document对象进行索引。
除了通过文档的名字或索引号来引用文档,还可以使用activedocument属性来返回一个引用活动文档(当前着眼的文档)的document对象。以下的示例显示产活动文档的名字;如果没有打开的文档,则该示例显示一条消息。
if documents. count >= 1 then
msgbox activedocument. name
else
msgbox "no documents are open"
end if
打开文档
要打开一个已经存在的文档,可以使用open方法。open方法应用于通过document属性返回的documents集合。以下的示例打开了文件test.doc(从当前文件夹)并且启动了更改跟踪。
set mydoc = documents. open (filename :="test.doc")
mydoc. trackrevisions = true
注意到在上例中open方法的返回值是一个document对象,该对象表示刚被打开的文档。在此示例中的文件名不包含路径;因此,是假定了该文件在当前的文件夹中。但这会导致出现一个运行时错误,因为一旦用户创建了与当前文件夹不同的文件夹,visual basic就再也找不到该文件了。但是,用户可以通过指明完整的路径,就如同下表所示的那样,来确保打开正确的文件。
操作系统
filename参数
windows
filename :="c:\documents\temporary file.doc"
macintosh
filename :="hard drive:documents:temporary file"
如果用户的宏只用于一种文件系统,那么可以在filename参数中指定路径分隔符(“\”或者“:”),就如同上表所示的那样。以下示例显示了与文件系统无关的代码,可以用来打开sales.doc,并且假定sales.doc已经保存在word 的程序文件夹中。
programpath = options. defaultfilepath (wdprogrampath)
documents. open filename :=programpath & application. pathseparator & "sales.doc"
pathseparator属性返回当前文件系统(例如,“\”用于ms-dos/windows的文件分配表,或者“:”用于macintosh)的正确的文件分隔符。defaultfilepath属性返回文件的位置,比如文档所在文件夹的路径、程序文件夹或者当前文件夹。
如果所指定的文件名既没有在当前文件夹(如果没有指定路径)出现也没有在指定的文件夹(如果指定了路径)中出现,那么就会发生错误。以下的示例使用filesearch对象的属性和方法来判断名为“test.doc”的文件是否存在于用户的默认文档文件夹中。如果找到了该文件(foundfiles. count = 1),那么就打开它;否则,显示一条消息。
defaultdir = options. defaultfilepath (wddocumentspath)
with application. filesearch
.filename = "test.doc"
.lookin = defaultdir
.execute
if .foundfiles. count = 1 then
documents. open filename :=defaultdir & application. pathseparator & "test.doc"
else
msgbox "test.doc file was not found"
end if
end with
也可以允许用户选择要打开的文件,而不是定死open方法的filename参数值。如同以下示例所示的那样,可以使用带有wddialogfileopen常量的dialogs属性来返回一个dialog 对象,该对象表示“打开”对话框(在“文件”菜单中)。show方法可以显示并且执行在“打开”对话框中完成的动作。
dialogs (wddialogfileopen). show
display 方法只是用来显示特定的对话框而不作任何更多的操作。以下的示例检查display方法的返回值。如果用户单击“确定”来关闭对话框,返回值-1并且打开所选择的文件,该文件的名字保存在变量fselected中。
set dlg = dialogs (wddialogfileopen)
abutton = dlg. display
fselected = dlg. name
if abutton = -1 then
documents. open filename :=fselected
end if
要对如何显示word对话框作进一步了解,请参阅“帮助”中的“显示内置word 对话框”一节的内容。
要判断某个特殊的文档是否打开,可以使用一条for each…next语句来对documents集合进行列举。如果名为“sample.doc”的文档已经被打开了,以下的示例就激活它;如果它尚未被打开,则该示例会打开它。
docfound = true
for each adoc in documents
if instr (1, adoc. name, "sample.doc", 1) then
adoc. activate
exit for
else
docfound = false
end if
next adoc
if docfound = false then documents. open _
filename :="c:\documents\sample.doc"
可以使用count属性来确定当前打开文档的数目。count属性应用于documents集合,可以使用document属性返回该集合。如果没有已打开的文档,以下的示例会显示一条消息。
if documents. count = 0 then msgbox "no documents are open"
创建和保存文档
要创建一个新文档,可以对documents集合应用add 方法。以下的示例创建了一个新文档。
documents. add
add方法返回了仅作为一个document对象而创建的文档。当用户添加一个文档时,可以设置add 方法的返回值是一个对象变量,以便用户可以在自己的代码中引用该新文档。以下的示例创建了一个新文档,并且设置它的上边距为1.25英寸。
dim mydoc as document
set mydoc = documents. add
mydoc. pagesetup. topmargin = inchestopoints(1.25)
第一次保存新文档时,可以随document对象使用saveas方法。以下的示例将名为“temp.doc”的活动文档保存在当前文件夹中。
activedocument. saveas filename :="temp.doc"
在文档被保存之后,用户可以使用它的文档名来调整document对象。以下的示例创建了一个新文档并且立刻把它保存为“1996 sales.doc”。然后,该示例使用新名字来作documents集合中的该文档的索引,并且向该文档添加一张表格。
documents. add.saveas filename :="1996 sales.doc"
documents ("1996 sales.doc").tables.add _
range :=selection. range, numrows :=2, numcolumns :=4
要保存对一个已经存在的文档所进行的更改,可以随同document对象使用save方法。以下的指令保存了名为“sales.doc”的文档。
documents ("sales.doc"). save
如果用户随同一个尚未保存的文档或模板使用save方法,将会显示“另存为”对话框来提示用户为该文件取名。要保存所有打开的文档,可以对documents集合应用save方法。以下的示例保存了所有打开的文档,但没有提示用户为文件取名。
documents. save noprompt :=true
激活一个文档
要使另一个文档成为活动文档,可以对document对象应用activate方法。以下的示例激活了打开的文档(mydocument.doc)。
documents ("mydocument.doc"). activate
以下的示例打开了两个文档,然后激活其中的第一个文档(sample.doc)。
set doc1 = documents. open (filename :="c:\documents\sample.doc")
set doc2 = documents.open (filename :="c:\documents\other.doc")
doc1. activate
打印一个文档
要打印一个文档,可以对document对象应用printout 方法,如以下示例所示。
activedocument. printout
要通过程序来设置那些也可以在“打印”对话框(在“文件”菜单中)里进行设置的打印选项,可以使用printout 方法的参数来实现。用户可以使用options 对象的属性来设置打印选项,这些选项也可以在“选项”对话框(在“工具”菜单中)“打印”一表里进行设置。以下示例设置活动文档打印隐藏的文字,并且只打印出前三页。
options. printhiddentext = true
activedocument. printout range :=wdprintfromto, from :="1", to :="3"
关闭文档
要关闭一个文档,可以对document对象应用close方法。以下的示例关闭了名为“sales.doc”的文档。
documents ("sales.doc"). close
如果对文档进行过修改,word会显示出一条消息来询问用户是否要保存所进行的修改。用户可以随savechanges参数使用wddonotsavechanges或 wdsavechanges常量来使该提示不再出现。以下的示例保存并且关闭了sales.doc。
documents ("sales.doc"). close savechanges :=wdsavechanges
要关闭所有已打开的文档,可以对documents集合应用close方法。以下的示例没有保存修改就关闭了所有的文档。
documents. close savechanges :=wddonotsavechanges
访问文档中的对象
用户可以从document对象来访问返回对象的一系列属性和方法。要查看在document对象中所能使用的对象的层次关系图,可以参阅“帮助”中的“microsoft word对象(documents)”。例如,table属性,它能够返回一个table对象的集合,可以在document对象中使用。随着一个集合对象使用的count属性能够判断在该集合中所包含的项数。以下的示例显示一条消息来指出在活动文档中有多少表格。
msgbox activedocument. tables. count & " table(s) in this document"
使用table(index)可以返回一个单张表格对象,这里的index是索引号。在以下的示例中,mytable代表“sales.doc”文档里的第一张表格。
set mytable = documents ("sales.doc"). tables(1)
关于返回一个特殊对象的信息可以从“帮助”中的对象主题本身 (例如,“table 对象”)和相应的集合对象主题(例如,“table集合对象”)中获得。
向文档添加对象
可以使用随着能在document对象中访问的集合对象的add方法来向文档添加诸如脚注、备注或表格这样的对象。例如,以下命令在myrange变量(myrange是一个包含了一个range对象的对象变量)所指定的位置上添加了一张3×3的表格。
activedocument. tables. add range :=myrange, numrows :=3, numcolumns :=3
以下的示例在myrange变量所指定的位置上添加了一个脚注。
activedocument. footnotes. add range :=myrange, text :="the willow tree"a
要获得支持add方法的集合对象列表,请参阅“帮助”中的“add 方法”。
运用range对象
当使用visual basic时一个常见的任务就是在文档中指定一块区域,然后对它进行处理,比如插入文字或应用格式等。例如,用户可能想编写一个宏,来对文档中某个部分里的某个单词或短语进行定位。那就可以使用一个range对象来表示想在其中搜索特定单词或短语的部分文档。在确定range对象后,用户能够应用该对象的方法和属性来修改相应范围中的内容。
一个range对象代表了文档中的一块连续的区域。每一个range对象都由一个起始字符位置和一个终止字符位置来定义。与用户在文档中使用书签的方法类似,可以在visual basic中使用range对象来识别一个文档的特定部分。一个range对象既可以和插入点一样小,也可以和整个文档一样大。但是,与书签不同,range对象仅仅在定义它的过程正在运行时才存在。
range对象同选定内容相互独立;也就是说,可以定义和修改范围而不会改变选定内容。用户也可以在文档中定义多个范围,而此时每个文档窗格中仅有一个选定内容。
start、end和storytype属性唯一地确定了一个range对象。start和end属性分别返回或者设置range对象的起始和结束字符的位置。每个文档构成部分起始处的字符位置是0 (zero),而第一个字符之后的位置是1,依此类推。storytype 属性的wdstorytype常量可以表示十一种不同的文档构成部分类型。例如,如果在注脚区域中有一个range对象,那么storytype属性返回wdfootnotesstory。要对文档构成部分作进一步了解,请参阅本节后面的“运用文档构成部分”一节的有关内容。
使用range对象来代替selection对象
宏录制器会经常创建一个使用selection属性来控制操纵selection对象的宏。但是,用户通常可以用一个或几个range对象来以很少的命令完成相同的任务。以下的示例是用宏录制器创建的。该宏对文档中的前两个单词进行加粗。
selection. homekey unit :=wdstory
selection. moveright unit :=wdword, count:=2, extend :=wdextend
selection. font.bold = wdtoggle
以下的示例没有使用selection对象而完成了相同的任务。
activedocument. range (start:=0, end :=activedocument. words(2). end) .bold = true
以下的示例对文档中的前两个单词进行加粗,然后插入一个新的段落。
selection. homekey unit :=wdstory
selection. moveright unit :=wdword, count :=2, extend :=wdextend
selection. font.bold = wdtoggle
selection. moveright unit :=wdcharacter, count:=1
selection. typeparagraph
以下的示例没有使用selection对象就完成了上述示例中的同样任务。
set myrange = activedocument. range(start:=0, end :=activedocument. words(2). end)
myrange. bold = true
myrange. insertparagraphafter
前面的两个示例改变了活动文档中的格式但没有改变选定内容。在大多数的场合下,range对象比selection对象更可取,原因如下:
用户可以定义和使用多个range对象,而在每个文档窗口中只能有一个selection对象。
控制管理range对象不会改变所选择的文字内容。
控制管理range对象比运用selection对象速度要快。
使用range方法返回range对象
可以使用range方法在特定文档中创建一个range对象。range方法(可以从document对象使用)返回一个range对象,该对象定位于主文档构成部分中,有给定的起始点和结束点。以下示例创建了一个range对象,并且赋给myrange变量。
set myrange = activedocument. range (start :=0, end :=10)
在上述示例中,myrange表示活动文档中的前十个字符。当对保存在myrange变量中的range对象应用一种属性或方法时,就可以看到已经创建的range对象。以下的示例对活动文档中的前十个字符进行加粗。
set myrange = activedocument. range(start :=0, end :=10)
myrange. bold = true
当用户需要对一个range对象进行多次引用时,可以使用set语句来设置一个等价于range对象的变量。但是,如果用户需要在一个对象上执行一次操作,那么就没有必要将对象保存到变量中。用户可以使用一条确定范围并且改变bold属性的命令来取得同样的结果;如以下示例所示。
activedocument. range(start :=0, end :=10). bold = true
和书签类似,一个范围能够在文档中横跨一组字符,也可以标记其中的一个位置。在以下的示例中,range对象的起始和终止点相同,并且该范围内不包含任何文字。该示例在活动文档的起始处插入文字。
activedocument. range(start :=0, end :=0). insertbefore text :="hello "
用户可以通过使用如上述示例所示的字符位置数字,或者随同selection对象、bookmark对象或range对象使用start属性和end属性,来定义一个范围的起始和终止位置。以下示例创建了一个range对象,来表示活动文档中的第三和第四个句子。
set mydoc = activedocument
set myrange = mydoc. range (start :=mydoc. sentences(3). start, _
end :=mydoc. sentences (4). end)
技巧 range对象在文档中的表示不可见。但是,用户可以使用select方法来选定一个range对象,以保证range对象表示正确的文字范围。在以下示例中的range对象表示活动文档中的前三个段落。在该宏运行完毕之后,选定内容是指包含在arange变量中的文字范围。
set arange = activedocument.range (start :=0, _
end :=activedocument. paragraphs (3). range. end)
arange. select
使用range属性来返回一个range对象
在许多对象都可以使用range属性-例如,paragraph对象、bookmark对象、endnote对象以及cell对象-range属性用来返回一个range对象。以下的示例返回了一个range对象,该对象表示活动文档的第一段。
set myrange = activedocument.paragraphs (1). range
在创建了对range对象的引用之后,用户可以使用它的任何属性或方法来修改该范围。以下的示例复制了活动文档中的第一段。
set myrange = activedocument. paragraphs (1). range
myrange. copy
以下的示例复制了活动文档中表格一的第一行。
activedocument. tables(1). rows(1). range. copy
以下的示例显示了活动文档中由第一个书签标记的文字。range属性可以在bookmark对象中使用。
msgbox activedocument. bookmarks (1). range. text
如果用户需要对同一个range对象应用多种属性或方法,那么可以使用with…end with语句。以下的示例为活动文档的第一段设定了文字的格式。
set myrange = activedocument. paragraphs (1). range
with myrange
.bold = true
.paragraphformat. alignment = wdalignparagraphcenter
.font. name = "arial"
end with
要获得关于返回range对象的其他示例,请参阅“帮助”中的“range属性”。
修改文档的一部分
visual basic包含了一些对象,可以使用它们来修改以下类型的文档元素:字符、单词、句子、段落以及节。下面的表格包含了对应于这些文档元素的属性和属性所返回的对象。
表 达 式
返 回 的 对 象
word (index)
range对象
characters (index)
range对象
sentences (index)
range对象
paragraphs (index)
paragraph对象
sections (index)
section对象
当用户不带index来使用这些属性时,就返回一个同名的集合-例如,paragraphs属性返回paragraphs集合。但是,如果用户使用index来确定在某个集合中的一项,就返回上述表格第二列中的对象-例如,words(1)返回一个range对象。用户可以使用任何范围属性或方法来修改range对象,如以下示例所示,该示例将选定内容中的第一个单词复制到剪贴板中。
selection. words (1). copy
在paragraphs集合以及sections集合中的集合项分别是paragraph对象和section对象,而不是range对象。但是,在paragraph对象和section对象中都可以使用range属性(它返回一个range对象)。以下的示例将获得文档中的第一段复制到剪贴板中。
activedocument. paragraphs(1). range. copy
上述表格中所有的文档元素属性都可以在document对象、selection对象以及range对象中使用,如以下三个示例所示。
本例设置活动文档中第一个单词的大小写。
activedocument. words(1). case = wduppercase
本例设置选中的第一节的下边距为0.5英寸。
selection.sections(1). pagesetup. bottommargin = inchestopoints(0.5)
本例设置活动文档中的文字为两倍行距(content属性返回一个range对象,该对象表示主文档构成部分)。
activedocument. content. paragraphformat. space2
修改一组文档元素
要修改由一组文本元素(字符、单词、句子、段落或节)构成的范围,可以创建一个包含文档元素的range对象。随同range对象使用start和end属性,用户可以新建一个range对象,该对象引用了一组文档元素。以下的示例创建了一个range对象(myrange),该对象引用了活动文档中的前三个单词,然后将这些单词的字体改为arial。
set doc = activedocument
set myrange = doc.range (start :=doc. words(1). start, end :=doc. words(3). end)
myrange. font. name = "arial"
以下的示例创建了一个range对象,该对象起始于第二段的开头,到第四段之后结束。
set mydoc = activedocument
set myrange = mydoc. range (start :=mydoc. paragraphs(2). range. start, _
end :=mydoc. paragraphs(4). range. end)
以下的示例创建了一个range对象(arange),该对象起始于第二段的开头,到第三段之后结束。paragraphformat属性用来访问诸如spacebefore和spaceafter这样的设置段落格式的属性。
set doc = activedocument
set arange = doc. range (start :=doc. paragraphs(2). range. start, _
end :=doc. paragraphs(3). range. end)
with arange. paragraphformat
.space1
.spaceafter = 6
.spacebefore = 6
end with
返回或设置范围中的文字
可以使用text属性来返回或设置一个range对象中的内容。以下的示例返回了活动文档中的第一个单词。
strtext = activedocument. words(1). text
以下示例将活动文档中的第一个单词改为“hello”。
activedocument. words(1). text = "hello"
可以使用insertafter 方法或者insertbefore方法在一个范围的前面或后面插入文字。以下的示例在活动文档的第二段之前插入文字。
activedocument. paragraphs(2). range. insertbefore text :="in the beginning "
在使用insertafter 方法或者insertbefore方法之后,范围随之扩大,包含新的文字。但是,也可以使用collapse方法将范围折叠到起始位置或终止位置。以下的示例在现有文档之前插入单词“hello”,然后将范围折叠到它的起始位置(在单词“hello”之前)。
with activedocument.paragraphs(2).range
.insertbefore text:="hello "
.collapse direction:=wdcollapsestart
end with
设置范围中文字的格式
可以使用font属性来取得设置字符格式的属性和方法,而使用paragraphformat属性来取得设置段落格式的属性和方法。以下的示例设置了活动文档中第一段的字符格式和段落格式。
with activedocument. paragraphs(1). range. font
.name = "times new roman"
.size = 14
.allcaps = true
end with
with activedocument. paragraphs(1). range. paragraphformat
.leftindent = inchestopoints(0.5)
.space1
end with
重新定义range对象
可以使用setrange方法来重新定义一个已经存在的range对象。以下的示例定义myrange为当前的选定内容。setrange方法重新定义myrange,使它表示当前的选定内容加上随后的十个字符。
set myrange = selection. range
myrange. setrange start :=myrange. start, end :=myrange. end + 10
要获得重新定义range对象的其他信息和示例,请参阅“帮助”中“setrange方法”。
用户也可以通过改变start属性和end属性的值,或者使用movestart方法或moveend方法来重新定义一个range对象。以下的示例重新定义myrange对象,使它表示当前的选定内容加上随后的十个字符。
set myrange = selection. range
myrange. end = myrange. end + 10
以下的示例使用moveend方法扩展了myrange,使它包含下一段。
set myrange = activedocument. paragraphs(2)
myrange. moveend unit :=wdparagraph, count :=1
在范围内的段落中循环
可以通过几种不同的方法在范围内的段落中进行循环。本节包含使用for each…next语句和next属性及方法在范围内的段落中进行循环的内容。也可以使用同样的技术在范围内的字符、单词或句子中进行循环。
使用for each…next语句
建议在范围内进行段落循环时使用for each…next语句,另外建议在集合内进行循环时也同样使用该语句。以下的示例在获得文档的前五段中进行循环,在每段之前添加文字。
set mydoc = activedocument
set myrange = mydoc.range (start:=mydoc. paragraphs(1). range. start, _
end :=mydoc. paragraphs(5). range. end)
for each para in myrange. paragraphs
para.range. insertbefore "question:" & vbtab
next para
假定用户想修改上述的代码,在范围内对用户选定的段落进行循环。可以使用selection属性来表示选定内容中的各个段落。以下的示例在选定内容的段落中进行循环,去除加粗格式。
for each para in selection. paragraphs
para.range. bold = false
next para
使用next属性或方法
用户也可以使用next属性和方法在范围的段落中进行循环。以下的示例说明了怎样在范围的单词中进行循环,将每个单词增大一点字号。
set myrange = activedocument.words(1)
for i = 1 to 5
myrange. font. size = myrange. font. size + i
set myrange = myrange. next(unit :=wdword, count :=1)
next i
以下的示例在范围的段落中进行循环,将范围的对齐方式由居中改为左对齐。该示例也使用next属性重新定义了myrange,使它表示下一段。
set myrange = activedocument. paragraphs(1). range
for i = 1 to 5
if myrange. paragraphs(1). alignment = wdalignparagraphcenter then
myrange. paragraphs(1). alignment = wdalignparagraphleft
end if
set myrange = myrange. paragraphs(1). next. range
next i
将range对象赋值给变量
可以通过几种途径来把一个已经存在的range对象赋给一个变量。在以下示例中,变量range1和变量range2都表示range对象。在该示例中命令把活动文档中第一和第二个单词分别赋值给变量range1和range2。
set range1 = activedocument. words(1)
set range2 = activedocument. words(2)
设置一个range对象变量等价于另一个range对象变量
以下的示例创建变量range2,并且与range1相同。
set range2 = range1
现在就有两个变量表示着同样的范围。当用户调整range2的起始位置、终止位置或者文字时,所做的更改也同样会影响到range1,反之亦然。
以下的示例将range1默认属性 (text属性)的值赋给range2的默认属性。在此示例中的代码等价于range2. text = range1. text,它没有改变range对象实际所表示的内容,它仅仅改变range2的contents (text)。
range2 = range1
这两个范围(range2和range1)包含有相同的内容,但是它们可能指向文档中的不同位置,或者干脆是不同的文档。
使用duplicate属性
以下的示例创建了一个新复制的range对象,range2,该对象有着和range1一样的起始位置、终止位置以及文字内容。
set range2 = range1. duplicate
如果改变了range1的起始位置或是终止位置,这种改变并不会影响到range2,反之亦然。但是,因为这两个范围指向文档的相同位置,改变一个范围中的文字内容也会同时改变另一个范围的文字内容。
运用文档构成部分
一个文档构成部分是文档中的一个区域,该区域中的文字区别于文档中的其他区域。例如,如果一个文档包含了正文文字、脚注和页眉,则该文档就包含了文档正文部分、脚注部分和页眉部分。
可以使用storytype属性来返回指定范围、选定内容或书签的文档构成部分。如果在脚注部分中包含了选定内容,那么下例将关闭活动窗口中的脚注窗格。
activewindow. view. type = wdnormalview
if selection. storytype = wdfootnotesstory then activewindow. activepane. close
storyranges集合包含了一个文档中每种有效的文档构成部分类型的第一个过程部分范围。可以使用nextstoryrange方法来返回以后的文档构成部分。以下的示例搜索活动文档中的每个文档过程部分来找出文字“microsoft word”。该示例也将它每次找到的文字全部设置为斜体。
for each mystoryrange in activedocument. storyranges
mystoryrange. find. execute findtext :="microsoft word", forward :=true
while mystoryrange. find. found
mystoryrange. italic = true
mystoryrange. find.execute findtext :="microsoft word", _
forward :=true, format :=true
wend
while not (mystoryrange. nextstoryrange is nothing)
set mystoryrange = mystoryrange. nextstoryrange
mystoryrange. find.execute findtext :="microsoft word", forward :=true
while mystoryrange. find. found
mystoryrange. italic = true
mystoryrange. find.execute findtext :="microsoft word", _
forward :=true, format :=true
wend
wend
next mystoryrange
运用selection对象
当用户使用word中的某个文档时,通常会先选择文字,然后再执行一项操作,比如设定以有文字的格式,或是键入新文字。在visual basic中,通常没有必要在修改文字之前先选定该文字;而是创建一个表示文档特定部分的range对象并对其进行操作。但是,当用户想要自己的代码对选定内容作出响应或是改变选定内容,就可以通过selection对象来完成任务。
可以使用selection属性来返回selection对象。在文档窗口的每个窗格中只能有一个selection对象,在任何时刻,也只能有一个活动的selection对象。选定内容可以包含文档的一块区域,也可以被折叠到一个插入点。以下的示例改变了选定内容中各个段的段落格式。
selection. paragraphs. spacebefore = inchestopoints (0.25)
selection属性可以在application对象、window对象和pane对象中使用。如果随同application对象使用selection属性,则该selection对象表示活动的选定内容。
selection. insertafter text :="next text"
也可以随同一个window对象或pane对象使用selection属性来返回一个在特定窗口或窗口窗格中selection对象。以下的示例随同window对象使用selection属性,在文档窗口“document2”中插入文字。
windows ("document2"). selection.insertafter text :="new text"
以下的示例随同pane对象使用selection属性,在主页眉窗格中插入文字。
with activewindow
.view. type = wdpageview
.view. seekview = wdseekprimaryheader
.activepane. selection. insertafter text :="header"
end with
在使用insertafter方法或insertbefore方法之后,选定内容随之扩大,包括了新的文字。但是,用户也可以使用collapse方法将选定内容折叠到它的起始或终止位置。以下的示例在选定内容的文字之后插入单词“hello”,任何将选定内容折叠到单词“hello”之后的插入点。
selection. insertafter text :="hello"
selection. collapse direction :=wdcollapseend
移动和扩展选定内容
用户可以通过几种方法来移动或扩展由selection对象所表示的选定内容(例如,move和moveend)。以下的示例将选定内容移动到下一段的开头。
selection. movedown unit :=wdparagraph, count :=1, extend :=wdmove
用户也可以通过改变selection对象的start属性及end属性的值,或者通过movestart和moveend方法来移动或扩展选定内容。以下的示例通过把终止位置移动到段尾来对选定内容进行扩展。
selection. moveend unit :=wdparagraph, count :=1
因为在一个文档窗口或窗格中只能有一个选定内容,用户也可以通过选定另一个对象来移动选定内容。可以使用select方法,选择文档的一项。在使用select方法之后,就可以使用selection属性返回一个selection对象。以下的示例选定了活动文档中的第一个单词,然后把该单词变为“hello”。
activedocument. words(1). select
selection. text = "hello "
用户也可以通过gotonext方法、gotoprevious方法或goto方法来移动选定内容。以下的示例将选定内容移动到文档中的第四行。
selection. goto what :=wdgotoline, which :=wdgotoabsolute, count :=4
以下的示例将选定内容恰好移动到活动文档中的下一个域之前。
selection. gotonext what :=wdgotofield
在selection对象使用的对象
可以在range对象和document对象中使用的许多其他对象也能在selection对象中使用,这使得用户可以在一个选定内容中控制操纵对象。要获得能在selection对象使用的对象的完整列表,请参阅“帮助”中的“microsoft word 对象(selection)”,或者“selection对象”。
以下的示例更新了选定内容中各个域的结果。
if selection. fields. count >= 1 then selection. fields. update
以下的示例将一节中的各个段落缩进了0.5英寸。
selection. paragraphs. leftindent = inchestopoints (0.5)
用户可以使用for each…next语句在选定内容中的单个对象上进行循环操作,来代替对选定内容中的所有对象逐个进行控制操纵。以下的示例在选定内容的每个段落上进行循环操作,将找到的任何居中的段落变为左对齐。
for each para in selection. paragraphs
if para. alignment = wdalignparagraphcenter then para. alignment = _
wdalignparagraphleft
next para
以下的示例显示出选定内容中每个书签的名字。
for each abook in selection. bookmarks
msgbox abook. name
next abook
selection对象的属性和方法
本节突出介绍selection对象的一些常用属性和方法。
返回或设置选定内容中的文字
可以使用text属性来返回或设置一个selection对象的内容。以下的示例返回所选的文字。
strtext = selection. text
以下的示例将所选文字改为“hello world”。
selection. text = "hello world"
可以insertbefore 方法或insertbefore方法,在选定内容之前或之后插入文字。以下的示例在选定内容之前插入了文字。
selection. insertbefore text :="and furthermore "
为许多文字设定格式
可以使用font属性来访问设置字符格式的属性和方法,也可以使用paragraphformat属性来访问设置段落格式的属性和方法。以下的示例设置了选定内容的字符和段落格式。
with selection. font
.name = "times new roman"
.size = 14
end with
selection. paragraphformat. leftindent = inchestopoints (0.5)
返回一个range对象
如果一种方法或属性是在range对象而不是selection对象中使用的(例如,checkspelling方法),那么可以使用range属性来从selection对象返回一个range对象。以下的示例对所选单词进行拼写检查。
selection. range. checkspelling
返回关于选定内容的信息
可以使用information属性来返回关于选定内容的信息。例如,用户可以判断当前页的页码、文档的总页数,或是判断选定内容是否在一个页眉或注脚中。information属性可取三十五种不同的常量(wdactiveendpagenumber, wdnumberofpagesindocument 和 wdinheaderfooter等等),用户可以使用它们来返回关于选定内容的不同信息。举个例子,如果选定内容处于一张表格中,那么以下的示例将显示表格中的行号或列号。
if selection. information (wdwithintable) = true then
msgbox "columns = " & selection. information (wdmaximumnumberofcolumns) _
& vbcr & "rows = " & selection. information (wdmaximumnumberofrows)
end if
要获得可以随information属性一起使用的常量的完整列表和说明,请参阅“帮助”中的“information属性”。
判断文字是否被选定
可以使用type属性来设置或返回选定内容在文档中被指定的方式。例如,可以使用wdselectionblock常量来判断一个文字块是否被选定。如果选定内容是一个插入点,那么以下的示例选定包含该插入点的段落。
if selection. type = wdselectionip then
selection. paragraphs(1). range. select
end if
运用find和replacement对象
可以使用find和replacement对象来查找并且替换文档中文字的特定范围。find对象可以在selection对象或range对象中使用(根据find对象是从selection对象还是从range对象返回的,查找操作也略有不同)。
使用selection.find
如果是在selection对象中使用find对象,那么当找到符合选择条件的文本后选定内容将会改变。以下的示例选定下一次出现的单词“hello”。如果在找到单词“hello”之前已经到达了文档的末尾,那么停止搜索。
with selection. find
.forward = true
.wrap = wdfindstop
.text = "hello"
.execute
end with
find对象包含与“查找”和“替换”对话框(在“编辑”菜单中)里的选项有关的属性。用户既可对find对象的属性逐一进行设置,也可以随同execute方法使用参数来进行设置,如果以下示例所示。
selection. find. execute findtext :="hello", forward :=true, wrap :=wdfindstop
使用range.find
如果是在range对象中使用find对象,选定内容不会改变,但是当找到符合选择条件的文本时范围会被重新定义。以下的示例确定活动文档中第一次出现的单词“blue”的位置。如果查找操作成功,将重新定义范围并且设置单词“blue”的格式为粗体。
with activedocument. content. find
.text = "blue"
.forward = true
.execute
if .found = true then .parent.bold = true
end with
以下的示例执行了和上述示例相同的操作,只是使用了execute方法的参数。
set myrange = activedocument. content
myrange. find. execute findtext :="blue", forward :=true
if myrange. find. found = true then myrange. bold = true
使用replacement对象
replacement对象表示查找-替换操作的替换条件。replacement对象的属性和方法对应于“查找”和“替换”对话框(在“编辑”菜单中)里的选项。
可以在find对象中使用replacement对象。以下的示例将所有出现单词“hi”的地方替换为“hello”。当找到符合选择条件的文本时,选定内容将会改变,因为代码从selection对象返回find对象。
with selection. find
.clearformatting
.text = "hi"
.replacement. clearformatting
.replacement. text = "hello"
.execute replace :=wdreplaceall, forward :=true, wrap :=wdfindcontinue
end with
以下的示例去除了活动文档中所有的粗体格式。bold属性对find对象为true(真),对replacement属性为false(假)。要查找和替换格式,需设置查找和替换文本为空字符串(“”),并且设置execute方法的format参数为true(真)。选定内容保持不变,因为代码在range对象中返回find对象(content属性返回一个range对象)。
with activedocument. content. find
.clearformatting
.font. bold = true
with .replacement
.clearformatting
.font. bold = false
end with
.execute findtext :="", replacewith :="", format :=true, replace :=wdreplaceall
end with
运用table、column、row和cell对象
word对象模型包含了表格对象,也包含了表格中各种不同元素的对象。可以随同document对象、range对象、selection对象使用table属性来返回table集合。table(index)返回了一个单独的table对象,在这里index是表格的索引号。索引号代表在选定内容、范围或文档中表格的位置。以下的示例将选定内容中的第一个表格转换为文本。
if selection. tables. count >= 1 then
selection. tables(1). converttotext separator :=wdseparatebytabs
end if
可以随同column对象、 range 对象、row对象或 selection对象使用cells属性来返回cells集合。用户可以通过使用table对象的cell方法或是索引cells集合来获得一个cell对象。以下的两条语句都能够设置mycell为一个cell 对象,该cell对象代表活动文档中表格一的第一个单元格。
set mycell = activedocument. tables(1). cell(row :=1, column :=1)
set mycell = activedocument. tables(1). columns(1). cells(1)
注释 要在一个表格的一个单元格中插入文字,可以使用text属性、insertafter方法或者随range对象使用insertbefore方法。可以随cell对象使用range属性来返回一个range对象。以下的示例在表格一的每一个单元格中插入连续的单元格序号。
i = 1
for each c in activedocument. tables(1). range. cells
c. range. insertbefore text :="cell " & i
i = i + 1
next c
可以随同table对象、range对象或selection对象使用column属性来返回columns集合。columns(index)返回了一个单独的column对象,在这里index是索引号。以下的示例选择了表格一的第一列。
activedocument. tables(1). columns(1). select
可以随同table对象、range对象或selection对象使用row属性来返回rows集合。rows(index)返回了一个单独的row对象,在这里index是索引号。以下的示例给表格一的第一行加底纹。
activedocument. tables(1). rows(1). shading. texture = wdtexture10percent
修改图形表格的行与列
当用户试图使用在一个图形表格(或者任何表格,其中有两个以上相邻的单元格被合并,但是行与列没有统一)中某一单独的行或列时,就可能出现一个运行时错误。如果活动文档中的第一个表格的每列含有不一致的行号,以下的示例就会出错。
activedocument. tables(1). rows(1). borders.enable = false
用户可以首先使用selectcolumn或selectrow方法来选定某个特定行或列的单元格,以此避免这样的错误。当用户选好了行或列,再随selection对象使用cells属性。以下的示例选定了活动文档中表格一的第一行。该示例使用cells属性返回所选的单元格(在第一行中所有单元格),以便可以删除边框。
if activedocument. tables(1). uniform = false
activedocument. tables(1). cell(1, 1). select
with selection
.selectrow
.cells. borders. enable = false
end with
end if
以下的示例选定了表格一的第一列。该示例使用了一个for each…next循环来向选定内容(第一列的所有单元格)中的每个单元格添加文字。
if activedocument. tables(1). uniform = false
activedocument. tables(1). cell(1, 1). select
selection. selectcolumn
i = 1
for each ocell in selection. cells
ocell.range. text = "cell " & i
i = i + 1
next ocell
end if
运用其他普通对象
本节提供了关于运用一些普通word对象的信息和技巧。
使用headerfooter对象
headerfooter对象既可以表示一个页眉也可以表示一个注脚。headerfooter对象是headerfooter集合的一个成员,它可以在section对象中使用。headers(index)或footer(index)属性返回了一个单独的headerfooter对象,在这里index是wdheaderfooterindex常量的一个值。
以下的示例创建了一个range对象(arange),该对象表示活动文档第一节的主要注脚。在该示例设置range对象之后,它删除了已有的注脚文本。它还向注脚添加了author域以及两个表和filename域。
set orange = activedocument. sections(1). footers (wdheaderfooterprimary). range
with orange
.delete
.fields. add range :=orange, type :=wdfieldfilename, text :="\p"
.insertafter text :=vbtab
.insertafter text :=vbtab
.collapse direction :=wdcollapsestart
.fields.add range :=orange, type :=wdfieldauthor
end with
注释 pagenumbers集合仅仅能在headerfooter对象中使用。可以对pagenumbers集合应用add方法来向一个页眉或注脚添加页码。
使用styles集合
styles集合可以在document对象中使用。以下的示例改变了活动文档中“标题1”样式的格式。
activedocument. styles (wdstyleheading1). font. name = "arial"
styles集合不能在template对象中使用。如果想修改一个模板中的样式,可以使用openasdocument方法按文档来打开模板,这样用户就可以对样式进行修改。以下的示例改变了活动文档所附的模板中“标题1”样式的格式。
set adoc = activedocument. attachedtemplate. openasdocument
with adoc
.styles(wdstyleheading1). font. name = "arial"
.close savechanges :=wdsavechanges
end with
指定commandbars
在使用commandbars集合(表示菜单栏和工具栏)之前,可以使用customizationcontext属性来设置保存着对菜单栏和工具栏的更改的template或document对象。以下的示例给“格式”工具栏添加了“双下划线”命令。因为自定义更改保存在normal模板中,所有的文档都会受到影响。
customizationcontext = normaltemplate
commandbars ("formatting"). controls. add type :=msocontrolbutton, _
id :=60, before :=7
要了解关于菜单栏和工具栏的更改范围的更多信息,请参阅第八章,“菜单栏和工具栏”。
使用dialogs集合
可以使用dialogs属性返回dialogs集合,该集合表示内置word对话框(例如,“打开”和“保存”对话框等)。用户不能新建内置对话框,也不能向dialogs集合添加内置对话框。要了解关于创建用activex控件创建自定义对话框的内容,请参阅第十二章,“activex 控件和对话框”。
返回mailmerge和mailmerge对象
可以使用document对象的mailmerge属性来返回一个mailmerge对象。无论所指定的文档是否是一个邮件合并文档,都可以使用mailmerge属性。在用户使用execute方法执行合并之前,可以使用state属性来确定邮件合并操作的状态。如果活动文档是附加了数据源的主文档,那么以下的示例将执行邮件合并。
set mymerge = activedocument.mailmerge
if mymerge. state = wdmainanddatasource then mymerge. execute
使用document对象的envelope属性可以返回一个envelope对象。无论用户是否向所指定的文档添加了一个信封,都可以使用envelope对象。但是,如果用户使用以下属性而没有向文档添加信封,那么会出现错误:address属性, addressfromleft属性, addressfromtop属性,feedsource属性, returnaddress属性,returnaddressfromleft属性, returnaddressfromtop属性或 updatedocument属性。
以下的示例使用on error goto语句来捕获用户没有向活动文档添加信封的错误。但是,如果用户已经向文档添加了信封,将显示收件人地址。
on error goto errorhandler
msgbox activedocument. envelope. address
errorhandler:
if err = 5852 then msgbox "envelope is not in the specified document"
在文档中添加和编辑域
用户可以通过对field集合应用add方法来给文档添加域。以下的示例添加了一个date域来替换选定内容。
activedocument. fields. add range:=selection. range, type :=wdfielddate
在添加一个域之后,用户可以通过使用result或code属性来返回或设置域结果和域代码,这两种属性都可以返回一个range对象。以下的示例更改选定内容的第一个域代码,更新该域,然后显示域结果。
if selection. fields. count >= 1 then
with selection. fields (1)
.code. text = "createdate \*mergeformat"
.update
msgbox . result. text
end with
end if
inlineshape对象同shape对象的对比
一个shape对象代表图形层的一个对象,诸如自选图形、任意多边形、ole对象、activex控件、图片等。shape对象锁定于文本范围内,但是能够任意移动,使用户可以将它们定位于页面的任何位置。要了解运用shape对象的信息,请参阅第十章,“形状和图形层”,也可以参阅“帮助”中的“shape对象”。
一个inlineshape对象代表文档文字层的一个对象。一个嵌入式形状可能是图片、ole对象或activex控件。可以将inlineshape对象视为字符,并将其象字符一样放在一行文本中。要了解关于inlineshape对象的信息,请参阅“帮助”中的“inlineshape集合对象”或“inlineshape对象”。
在word窗体中使用formfield对象
用户可以创建一个word在线窗体,该窗体包含复选框、文本文本框和下拉式列表框。使用“窗体”工具栏可以插入这些窗体元素。对应的visual basic对象是checkbox, textinput, 和dropdown。所有这些对象都可以在formfields集合的任何一个formfield对象中使用;但是,用户应当使用按照窗体域的类型使用相应的对象。例如,以下命令从活动文档的“check1”域中选择复选框。
activedocument. formfields ("check1").checkbox. value = true
除了“窗体”工具栏中的窗体元素之外,用户还可以向一个在线窗体添加activex控件。使用“控件工具箱”可以插入activex控件。用户可以把控件插入文字层或图形层;控件将分别由一个inlineshape 对象或一个shape对象来表示。要了解关于运用activex控件的更多内容,请参阅第十二章,“activex控件和对话框”。
判断对象是否有效
可以通过在用户代码中包含判断语句来判断由一个表达式返回的特定对象或者一个变量所引用的对象是否有效,以此避免代码在运行时的错误。本节讨论了一些检查表达式返回值或变量保存值有效性的技术。
用户可以随同一个变量或表达式使用typename函数来确定对象的类型。如果selection. nextfield返回了一个field对象,那么以下的示例将在状态栏中显示一条消息。
if typename (selection. nextfield) = "field" then statusbar = "a field was found"
以下示例的功能等价于上述示例;不同之处仅在于它使用一个对象变量(myfield)来保存nextfield方法的返回值。
set myfield = selection. nextfield
if typename (myfield) = "field" then statusbar = "a field was found"
如果指定的变量或表达式不代表一个对象,它对nothing求值。如果nextfield方法没有返回nothing(也就是说,如果nextfield方法返回了一个field对象,它只是其他的可能返回值),那么以下的示例将对myfield应用update方法。
set myfield = selection. nextfield
if not (myfield is nothing) then myfield. update
word包含共用的isobjectvalid属性。可以使用该属性来判断一个被某个变量所引用的对象是否有效。如果变量所引用的对象已经被删除了,那么该属性返回false。以下的示例向活动文档添加一个表格,并且把它赋值给变量atable。该示例从文档中删除了第一个表格。如果atable引用的表格不是文档中的第一个表格(也就是说,如果atable仍然是一个有效的对象),那么该示例删除表格的边框。
set atable = activedocument. tables. add(range :=selection. range, numrows :=2, _
numcolumns:=3)
activedocument. tables(1).delete
if isobjectvalid (atable) = true then atable. borders. enable = false
修改word命令
用户可以通过把命令转变为宏来对绝大多数word命令进行修改。例如,可以“文件”菜单中的“打开”命令,使word显示当前文件夹中的每一个文件,而不是只显示word文档文件列表(在windows中,控制名为.doc的文件)。
要在“宏”对话框(在“工具”菜单中)里显示内置word命令的列表,可以在该对话框中“宏的位置”一栏里选中“word 命令”。在该对话框中就会列出每一个可用的菜单、工具栏或快捷键命令。每个菜单命令用与该命令关联的菜单名开头。例如,在“文件”菜单中的“保存”命令显示为“filesave”。
用户可以通过给宏取和word命令相同的名字来用一个宏替换一条word命令。例如,如果用户创建了一个名为“filesave”的宏,当用户:在“文件”菜单中单击“保存”、在“常用”工具栏中单击“保存”按钮或按下给filesave指定的快捷键时,word将运行该宏。
修改word命令
在“工具”菜单中,用鼠标指向“宏”,然后单击“宏的位置”。
在“宏的位置”一栏中,单击“word 命令”。
在“宏名”一栏中,选中要修改的word命令(例如,filesave)。
在“宏的位置”一栏中,选择要保存宏的模板或文档的位置。例如,单击normal.dot(共用模板)来创建一个共用宏(filesave命令将会自动地对所有文档进行修改)。
单击“创建”。
visual basic编辑器被打开,其中显示出一个模块,该模块包含有一个与刚才被选中的命令同名的新过程。如果选中了filesave命令,那么就出现filesave宏,如以下示例所示。
sub filesave()
filesave macro
saves the active document or template
保存活动文档或模板
activedocument.save
end sub
用户可以添加附加的命令或删除已有的activedocument. save命令。filesave命令每次运行时,filesave宏都将word命令来执行。要恢复原来的filesave命令,需要更改filesave宏的名字或删除它。
注释 用户还可以通过创建与word命令(例如,filesave)同名的代码模块来用一个名为“main”的子例程替换一条word命令。
运用事件
一个事件既可以是一个被对象识别的操作(比如,打开一个文档或者从应用程序退出),也可以是一个能够编写代码来响应的操作。一个用户的操作或一段程序代码都可以导致事件的发生,事件也可以由系统引起。word所支持的事件均列在下表中,该表还列出了activex控件事件,它们将在第十二章“activex控件和对话框”中进行讨论。
要了解关于运用word事件的信息,请参阅下列“帮助”主题:“使用document对象的事件”、“使用activex控件的事件”以及“使用application对象的事件”。
document事件
当用户打开或关闭一个已经存在的文档时,或者用户在新建一个文档时,就发生了文档事件,如以下示例所示。
事件描述
当关闭一个文档时发生close事件。
当创建一个基于模板的新文档时发生new事件。
当打开一个文档时发生open事件。
一个文档事件过程的范围取决于它保存的位置。如果在一个文档中保存open或close事件过程,那么该过程仅当用户关闭或打开该文档时才发生;如果在一个模板中保存open或close事件,那么当打开或关闭基于该模板的文档或该模板本身时,该过程才发生。一个新事件过程必须保存在模板中;一个保存在文档中新事件过程决不会运行,因为文档只能基于模板来创建。
以下的示例在打开文档时将word应用程序的窗口扩至最大状态。
private sub document_open()
application. windowstate = wdwindowstatemaximize
end sub
activex控件事件
word为word文档中的activex控件执行lostfocus 和 gotfocus事件。
事件描述
在焦点移开嵌入式 activex 控制时发生lostfocus事件。
当焦点移至内嵌式 activex 控制时发生gotfocus事件。
以下的示例保持commandbutton1处于禁用状态,直到用户在textbox1中键入一个值。
private sub textbox1_lostfocus()
if textbox1. value = "" then
commandbutton1. enabled = false
else
commandbutton1. enabled = true
end if
end sub
其他activex控件事件的文档在“microsoft 窗体帮助”中。有关在自定义对话框和文档中使用activex控件的内容,请参阅第十二章“activex控件和对话框”。
application事件
当用户退出应用程序或焦点移至另一个文档时发生application事件。但是,与document和activex控件事件不同,application事件默认事件处于禁用状态。在用户随同application对象使用事件之前,必须新建一个类模块并声明一个包含事件的 application 类型对象。用户可以在visual basic编辑器中使用类模块命令(插入菜单)的形式来新建一个类模块。
启用application对象的事件,最好向类模块中添加以下声明。
public withevents app as application
定义了包含事件的新对象后,它将出现在类模块的“对象”下拉列表框中,然后可为新对象编写事件过程。(在“对象”框中选定新对象后,其有效事件将出现在“过程”下拉列表框中。)
但是在过程运行之前,必须将类模块中的已声名对象和 application 对象相连接。要完成上述任务,可以在任何模块中使用下列声明(在这里“eventclass”是用户创建的用来启用事件的类模块的名字)。
public x as new eventclass
当用户已经创建了x对象变量后(eventclass类的一个实例),可以设置enventclass类的app对象于word application对象等价。
sub initializeapp()
set x. app = application
end sub
在用户运行initializeapp过程之后,eventclass类模块中的app对象指向了word application对象,而且只要事件发生,类模块中的事件过程也将会运行。
在用户禁用application对象的事件之后,可以为下表中的事件创建事件过程。
事件描述
当新建一个文档、打开一个已有文档或使另一个文档成为活动文档时documentchange事件发生。
当用户退出word时quit事件发生。
以下的实例确保了在用户退出word之前,“常用”工具栏和“格式”工具栏均为可见。结果,当重新启动word时,这些工具栏将不会出现。
private sub app_quit()
commandbars ("standard"). visible = true
commandbars ("formatting"). visible = true
end sub
使用自动宏
通过给一个宏赋予一个特殊的名字,用户可以在执行诸如启动word或打开一个文档这样的操作时自动运行它。word将下列名称识别为自动宏,或者“自动”宏。
宏 名
运 行 时 刻
autoexec
每次启动word或装载一个全局模板时
autonew
每次新建一个文档时
autoopen
每次打开一个已有文档时
autoclose
每次关闭一个文档时
autoexit
每次退出word或卸载一个全局模板时
关于使用自动宏的详细信息,请参阅“帮助”中的“自动宏”。
使用自动化
在运用word数据之外,用户还可能想让自己的应用程序同其他的应用程序,比如microsoft excel, microsoft powerpoint, 或microsoft access交换数据。用户可以通过使用自动化(以前的ole自动化)来同其他应用程序进行通信。
从另一个应用程序中对word进行自动化
自动化运行用户通过引用另一个应用程序的对象、属性和方法来返回、编辑和输出数据。用户能够在另一个应用程序中进行引用的application对象称为自动化对象。使word能够被另一个应用程序所使用的第一步,就是创建对word类型库的一个引用。要创建对word类型库的引用,可以在“visual basic编辑器”里,单击 “工具”菜单中的“引用”,然后在“microsoft word 8.0 object library”旁边的复选框内打上钩。
下一步,声明一个引用word application对象的对象变量,如下例所示。
dim appwd as word. application. 8
使用带有word ole程序标识符的visual basic createobject函数或getobject函数,如下例所示。如果想看到word时段,设置visible属性为true(真)。
dim appwd as word. application. 8
set appwd = createobject ("word. application.8")
appwd. visible = true
createobject函数返回一个word application对象,并且将它赋给appwd。通过使用word application对象的对象、属性和方法,用户可以用该变量对word进行控制。以下的实例新建一个word文档。
appwd. documents. add
createobject函数启动一个word时段,当引用application对象的对象变量失效时,该时段内的自动化不会关闭。设置该对象引用nothing关键字也不会关闭word。而是使用quit方法来关闭word。以下的microsoft excel示例把“工作表1”中a1:b10单元格里的数据插入到一个word新文档中,然后调整表格中的数据。如果使用了createobject函数,则该示例使用quit方法来关闭word的新实例。如果getobject函数返回错误429,那么该示例使用createobject来启动一个word新实例。
dim appwd as word. application
err.number = 0
on error goto notloaded
set appwd = getobject (, "word. application.8")
notloaded:
if err. number = 429 then
set appwd = createobject ("word. application.8")
theerror = err. number
end if
appwd. visible = true
with appwd
set mydoc = .documents. add
with .selection
for each c in worksheets ("sheet1"). range ("a1:b10")
.insertafter text :=c.value
count = count + 1
if count mod 2 = 0 then
.insertafter text :=vbcr
else
.insertafter text :=vbtab
end if
next c
.range. converttotable separator :=wdseparatebytabs
.tables(1). autoformat format :=wdtableformatclassic1
end with
mydoc. saveas filename :="c:\temp.doc"
end with
if theerror = 429 then appwd. quit
set appwd = nothing
从word对另一个应用程序进行自动化
要通过从word使用自动化来和另一个应用程序交换数据,必须首先在“引用”对话框(在“工具”菜单中)里设置对另一个应用程序的类类型库的一个引用。在这之后,另一个应用程序的对象、属性和方法都将出现在“对象浏览器”中,并且会在编译时自动对语法进行检查。用户也可以获得这些对象、属性和方法的内容敏感型帮助。
下一步,声明一个引用另一个应用程序中的特定类型对象的对象变量。以下示例声明了一个变量,该变量指向microsoft excel application对象。
dim xlobj as excel.application.8
用户可以通过使用createobject 或 getobject函数来获得automation对象。然后,通过使用另一个应用程序的对象、属性和方法,用户可以添加、更改或删除信息。当用户完成更改后,关闭应用程序。以下word的示例判断microsoft excel是否正在运行。如果指定的microsoft excel任务存在,该示例使用getobject函数;否则,它使用createobject函数。然后该示例将选定的文字传送给活动的microsoft excel工作簿里“工作表1”的a1单元格中。在任务完成以后,使用带有nothing关键字的set语句来清除automation对象变量。
dim xlobj as excel. application. 8
if tasks.exists ("microsoft excel") = true then
set xlobj = getobject (, "excel. application. 8")
else
set xlobj = createobject ("excel. application. 8")
end if
xlobj. visible = true
if xlobj. workbooks. count = 0 then xlobj. workbooks. add
xlobj. worksheets ("sheet1").range("a1").value = selection. text
set xlobj = nothing
以下word的示例判断powerpoint是否正在运行。如果存在powerpoint任务,那么该示例使用getobject函数;否则,它使用createobject函数。然后该示例创建一个新演示文稿,文稿的第一个文本框包含活动word文档的名称,第二个文本框包含活动文档第一段的文字。在任务完成后,使用带有nothing关键字的set语句来清除automation对象变量。
dim pptobj as powerpoint. application.8
if tasks. exists ("microsoft powerpoint") = true then
set pptobj = getobject (, "powerpoint. application.8")
else
set pptobj = createobject ("powerpoint. application.8")
end if
pptobj. visible = true
set pptpres = pptobj. presentations. add
set aslide = pptpres. slides. add(index :=1, layout :=pplayouttext)
aslide. shapes(1). textframe. textrange. text = activedocument.name
aslide. shapes(2). textframe. textrange. text = activedocument.paragraphs(1). range. text
set pptobj = nothing
要了解关于对microsoft access进行自动化的信息,请参阅第三章“microsoft access对象”。要了解关于word中data access 对象(dao)的使用,请参阅“帮助”中的“在microsoft word中使用dao”。
同内嵌word对象进行通信
以后可以使用任何word对象的application属性来返回word application 对象。这有助于从内嵌在另一个应用程序中的word文档里方法word application对象。以下的在microsoft excel中运行的示例,将一个对象变量设置为word application对象。(为了使该示例能够运行,在活动工作表中的形状一必须是一个内嵌word文档。)该示例中最后一条命令在内嵌word文档的开头添加文字。
dim appwrd as word. application
set embeddeddoc = activesheet. shapes(1)
set appwrd = embeddeddoc. oleformat. object. object. application
appwrd. activedocument. range(start :=0, end :=0). insertbefore text :="new text "
以下在powerpoint中运行的示例,将一个对象变量设置为word application对象。(为了使该示例能够运行,在演示文稿中的幻灯片一必须是一个内嵌word文档。)该示例的最后一条命令显示了在内嵌word文档中的文字。
dim appwrd as word. application
set embeddeddoc = presentations(1). slides(1). shapes(1)
embeddeddoc. oleformat. activate
set appwrd = embeddeddoc.oleformat. object. application
msgbox appwrd. activedocument. content.text