w01.qxd
10/25/2006
1:07 PM
Page 9
1. fejezet • A Word kulisszái mögött
9
egyként viselkedik. Az ehhez hasonló kellemetlen helyzeteket könnyen elkerülhetjük, ha hozzászokunk a bekezdésjelek megjelenítéséhez.
1.10. ábra A bekezdésjelek láthatóvá tételével pillanatok alatt világossá válnak a gondok
2. fogás • Utazás a makrók birodalmába Gyorstalpaló tanfolyam, amelynek során meggyõzõdhetünk arról, milyen sokat segíthetnek a makrók a fárasztó és idõrabló feladatok automatizálásában. A Word 6-os és azutáni változataiban lehetõségünk van makrók, vagyis rövid, feladatok megoldását automatizáló programok írására, rögzítésére és lejátszására. Maga a makró kifejezés a makróparancs elnevezésbõl ered, ami parancsok egy ütemben végrehajtott sorozatára utal. Jellemzõen rögzítünk egy parancssorozatot, nevet adunk neki, majd újra és újra visszajátsszuk, amikor szükség van rá. Természetesen a Word makrói is használhatók ezen a módon, de ennél jóval többre is képesek. A Word makrók nyelve a Visual Basic for Applications, vagy VBA. Ez azt jelenti, hogy a program a rögzített makrókat erre a nyelvre fordítja, így késõbb megvizsgálhatjuk és szerkeszthetjük õket. A VBA a BASIC programnyelvek családjába tartozik, következésképpen könnyebben kezelhetõ, mint sok más nyelv, például a C vagy a Java. Más nyelvekhez hasonlóan azonban ahhoz, hogy igazán elsajátítsuk a használatát, sokat kell gyakorolnunk. Könyvünk szûkre szabott keretei nem adnak teret egy teljes VBA-bevezetõ kurzusnak; mindössze arra vállalkozhatunk, hogy bemutassuk, hogyan készíthetünk a késõbbiekben látottakhoz hasonló makrókat. Tipp
A Word makrók kimerítõ tárgyalását megtalálhatjuk az O’Reilly gondozásában megjelent Writing Word Macros címû könyvben.
2
w01.qxd
10
10/25/2006
1:07 PM
Page 10
Word mesterfogások
Építõkockák A könyvben megjelenõ, valamint a rögzített makrók legtöbbje az eljárásokra (Sub) épül. Ezek mindegyike az alábbi sorral kezdõdik: Sub MakróNév
A MakróNév itt értelemszerûen a makró neve. Az eljárások kivétel nélkül a következõ sorral érnek véget: End Sub
A Word számára kiadott utasítások e két sor között kapnak helyet. Minderre a fõzés folyamata nagyszerû párhuzamot kínál. Gondoljunk úgy a makrókra, mint receptekre! Az elején felsoroljuk a hozzávalókat, majd a teendõk következnek, amelyekkel a hozzávalók halmazából valami ehetõt varázsolunk az asztalra. Egyes esetekben receptünket több kisebb receptre oszthatjuk – egy a hús elkészítéséhez, egy a szószhoz –, így egyszerûbbé válik a mûveletek követése. A makrók hasonlóképpen mûködnek. Figyeljük meg az alábbi példa elején a „hozzávalók” felsorolását, majd a kódot, ami ezek segítségével elvégzi a teendõket: Sub Dim Dim Dim
CountCommentsByBob( ) oComment As Comment iCommentCount As Integer doc As Document
iCommentCount = 0 Set doc = ActiveDocument For Each oComment In doc.Comments If oComment.Author = "Bob" Then iCommentCount = iCommentCount + 1 End If Next oComment MsgBox "Bob made: " & iCommentCount & " comments" End Sub
Ennyi elmélet után lássuk végre, hogyan is mûködnek makróink a Word dokumentumokban!
Helló, Világ!
2
A számítástechnikai könyvekben hagyománnyá vált, hogy az elsõ egyszerû példaprogram a „Helló, Világ!” kiáltással adja tudtára a világnak létezését. A Word VBA-ban ez a programocska valahogy így fest: Sub HelloWorld MsgBox "Hello, World" End Sub
w01.qxd
10/25/2006
1:07 PM
Page 11
1. fejezet • A Word kulisszái mögött
11
E makró létrehozásához nyissuk meg a Makrók párbeszédablakot az Eszközök, Makró, Makrók paranccsal. Az ablak alján található Makró helye lenyíló listában megszemlélhetjük, mely dokumentumok és sablonok vannak megnyitva – ezekben tárolhatjuk makróinkat (lásd az 1.11. ábrát). A Minden aktív sablon és dokumentum választásával makrónkat a Normal.dot sablonba mentjük.
1.11. ábra Válasszuk ki, hol tároljuk a makrót
Ez után írjuk be a Makrónév mezõbe a HelloWorld nevet, és a Létrehozás gombra kattintva hozzuk létre új makrónkat (lásd az 1.12. ábrát).
1.12. ábra Hozzunk létre új makrót a Makrók párbeszédablakban
2
w01.qxd
12
10/25/2006
1:07 PM
Page 12
Word mesterfogások
E gomb megnyomása után a Word három mûveletet végez: 1. Készít egy NewMacros nevezetû új modult a Normal sablonban, amely makrónk kódját tartalmazza majd. 2. Elindítja a Visual Basic szerkesztõt (Visual Basic Editor). 3. A Word automatikusan megadja a makró elsõ és utolsó sorát, valamint néhány megjegyzést is készít a makróhoz. (Ezek a megjegyzések másoknak nyújtanak segítséget a program megértésében. A VBA-ban a megjegyzések mindig aposztróffal kezdõdnek.) A Visual Basic szerkesztõben már láthatjuk is makrónk vázát (1.13. ábra). A jobb felsõ részen elhelyezkedõ projektböngészõben (Project Explorer) megjelenik minden megnyitott dokumentum és sablon, köztük az esetleges bõvítmények is (ilyen például az MSWordXML ToolBox [92. fogás]). Vegyük észre, hogy a program kiemeli a Normal sablon Modules részében a NewMacros modult.
1.13. ábra A Visual Basic szerkesztõ
A makró elkészítéséhez vigyük a kurzort az End Sub feletti üres sorba, és írjuk be a következõt: MsgBox "Hello, World!"
2
Most már futtathatjuk makrónkat az eszköztár Lejátszás gombjával (zöld háromszög). Eredményként az 1.14. ábrán látható párbeszédablakot kapjuk.
w01.qxd
10/25/2006
1:07 PM
Page 13
1. fejezet • A Word kulisszái mögött
13
1.14. ábra Üdvözlet elsõ makrónktól
Ha a Normal sablonban, ugyanebben a modulban további makrókat szeretnénk készíteni, egyszerûen kezdjünk egy új sort az End Sub után, és írjuk be a kódot. Ha más makrókból szeretnénk kódot beilleszteni, a Visual Basic szerkesztõ erre is lehetõséget ad.
A makrók rendszerezése és hibáinak megkeresése Amennyiben makróink rendezéséhez újabb modult szeretnénk létrehozni, jelöljük ki a projektböngészõben azt a sablont vagy dokumentumot, ahová a modult helyezni szeretnénk, majd válasszuk az Insert, Module (Beszúrás, Modul) menüpontot. Az így készített modulok Module1, Module2 és ezekhez hasonló nevet kapnak (lásd az 1.15. ábrát). Ha más nevet szeretnénk nekik választani, a projektböngészõ alatt található Properties (Tulajdonságok) ablakban megtehetjük (lásd az 1.13. ábrát).
1.15. ábra Új modult illesztettünk a Normal sablonba
Ha meg szeretnénk szüntetni – vagy legalábbis észrevehetõvé tenni – a programhibák elsõ számú forrását, az elgépelést, modulunkat feltétlenül kezdjük az alábbi sorral: Option Explicit
Ez a kódsor arra utasítja a Wordöt, hogy gyõzõdjön meg arról, valóban meghatároztuk-e a kódban használt változókat. Visszatérve a fõzéshez,
2
w01.qxd
14
10/25/2006
1:07 PM
Page 14
Word mesterfogások
ez olyan, mint mikor a receptet átolvasva meggyõzõdünk arról, hogy minden, amit felhasználtunk, megjelenik a hozzávalók listájában. Ha futtatni próbálunk egy makrót, amelynek egyik változóját elírtuk, a Word figyelmeztet, és kiemeli a szóban forgó változót (1.16. ábra).
1.16. ábra A Word segíthet makróink hibáinak felkutatásában
Ha végeztünk a makró szerkesztésével, a File, Close and Return to Microsoft Word (Bezárás és visszatérés a Wordbe) menüponttal térjünk vissza a Wordhöz.
Makrók futtatása Ha futtatni szeretnénk egy makrót a Wordbõl, válasszuk az Eszközök, Makró, Makrók menüpontot, válasszuk ki makrónkat a kapott listából, majd nyomjuk meg az Indítás gombot (lásd az 1.17. ábrát).
2
Ha gyakrabban használunk egy makrót, érdemes eszköztárgombot vagy billentyûkombinációt rendelni hozzá. Ehhez válasszuk az Eszközök, Testreszabás menüpontot, kattintsunk a Parancsok fülre, és válasszuk a Kategóriák oszlop Makrók pontját (1.18. ábra). Keressük meg makrónkat a Parancsok oszlopban, majd húzzuk át egy eszköztárra vagy menüre. Miután elhelyeztük, jobb gombbal rákattintva megváltoztathatjuk a nevét, illetve képet rendelhetünk az eszköztárgombjához (lásd az 1.19. ábrát).
w01.qxd
10/25/2006
1:07 PM
Page 15
1. fejezet • A Word kulisszái mögött
15
1.17. ábra Makró futtatása a Wordbõl
1.18. ábra A Makrók kategória kiválasztása a Testreszabás párbeszédablakban
1.19. ábra Az eszköztárra vagy menübe helyezett makró gombfeliratának megváltoztatása
2
w01.qxd
16
10/25/2006
1:07 PM
Page 16
Word mesterfogások
Ha olyan makrócsaládot használunk, illetve hozunk létre, ami rendszeresen segít a munkánkban, érdemes elhelyeznünk õket egy Macros sablonban [50. fogás], amelyet a Word indulásakor automatikusan betölt.
A sz e r k e sz t õ a p r ó se g í t sé g e i A Visual Basic szerkesztõ teljes értékû fejlesztõkörnyezet, amely különféle módokon segíti VBA kódunk szerkesztését. IntelliSense. A VBA kód írása közben a szerkesztõ segít az utasítások nevének kiegészítésében (lásd az 1.20. ábrát).
1.20. ábra A Visual Basic szerkesztõ felgyorsíthatja a kód beírását
A lehetõségek listája általában automatikusan megjelenik a kód beírása közben, de a CTRL+SZÓKÖZ billentyûkombinációval bármikor külön kérhetjük is ezt a listát. Az Immediate ablak. Az Immediate ablakban lehetõségünk van egyes utasítások azonnali végrehajtására. Ha egy utasítás elé a kódban kérdõjelet írunk, eredménye megjelenik az Immediate ablakban (lásd az 1.21. ábrát).
1.21. ábra Az Immediate ablak használata
2
w01.qxd
10/25/2006
1:07 PM
Page 17
1. fejezet • A Word kulisszái mögött
17
Az Immediate ablak rendkívül jól használható a makrók tesztelésénél. Írjuk be például az alábbi sort egy makró kódjába: Debug.Print KiírandóKarakterlánc
A KiírandóKarakterlánc kifejezést helyettesítsük egy karakterlánccal vagy egy karakterlánc értékû változóval, amelyen rajta szeretnénk tartani a szemünket. A változó aktuális értéke megjelenik az Immediate ablakban. Ezt a módszert mutatja be az 1.22. ábra. Kódellenõrzés lépésrõl lépésre. Makrónk tesztelésekor lehetõségünk van arra is, hogy lépésrõl lépésre futtassuk a kódot. A Word ilyenkor egy kódsor végrehajtása után jelzésünkre vár a továbbhaladáshoz. Ezzel lelassítjuk a makró futását, így könnyebben értelmezhetjük az eseményeket. Ha ilyenkor egy változó fölé helyezzük az egérmutatónkat, a Word egy buborékban megjeleníti a változó aktuális tartalmát. A lépésrõl lépésre haladáshoz helyezzük el valahol a mutatót a makró kódjában, és nyomjuk le az F8 billentyût. Ettõl kezdve az F8 megnyomásával léphetünk a következõ sorra. A következõ végrehajtandó sort a program sárgával jelöli, ráadásként baloldalt egy nyíl is megjelenik a kód mellett (lásd az 1.22. ábrát).
1.22. ábra A Visual Basic szerkesztõben lépésenként is követhetjük makróink mûködését
2
w01.qxd
18
10/25/2006
1:07 PM
Page 18
Word mesterfogások
A Word objektummodell je A Word VBA-ban a Word minden alkotórészének megfelel valamilyen objektum. Objektumok a dokumentumok, a bekezdések, sõt a betûtípusok nevei is. Ráadásul ezek az objektumok kapcsolatban állnak egymással – vizsgálatuk és módosításuk a makróprogramozás valódi alapja. A Word objektummodelljének böngészéséhez válasszuk a Visual Basic szerkesztõben a View, Object Browser (Megjelenítés, Objektumböngészõ) menüpontot. Az Object Browser elsõ látásra ijesztõ lehet, de ahogy belejövünk a makróprogramozásba, láthatjuk majd, milyen nélkülözhetetlen segítséget nyújt a Word összetevõinek szabályozásában és feladatainak automatizálásában. Az Object Browsert az 1.23. ábrán mutatjuk be.
1.23. ábra A VBA Object Browser használata
2
w04.qxd
154
10/25/2006
4:06 PM
Page 154
Word mesterfogások
43. fogás • Automatikus kereszthivatkozások A Kereszthivatkozás párbeszédablak használata – különösen hosszabb dokumentumokban – nem valami kényelmes, hiszen egyidejûleg csak pár címsort láthatunk. A következõkben megmutatjuk, hogyan készíthetünk kereszthivatkozásokat anélkül, hogy fel kellene keresnünk ezt a szûkös párbeszédablakot. Akárki is találta ki, hogy a Word Kereszthivatkozás párbeszédablaka (Beszúrás, Kereszthivatkozás vagy Beszúrás, Hivatkozás, Kereszthivatkozás) egyszerre csak kilenc elemet jeleníthet meg, nem igazán gondolkodott felhasználóbarát módon. A hosszabb dokumentumok ugyanis általában kilencnél több címsort, feliratot, vagy más, hivatkozásra csábító elemet tartalmaznak. A kereszthivatkozás létrehozása sokszor annyiból áll, hogy egy statikus szövegrészletet kijelölünk, majd dinamikus hivatkozássá alakítjuk úgy, hogy a Kereszthivatkozás párbeszédablak megfelelõ elemével helyettesítjük (lásd a 4.26. ábrát). Mivel azonban egyszerre csak kilenc elemet láthatunk a párbeszédablakban, hamar görgetõrobotnak érezhetjük magunkat. Ráadásul a helyzet a dokumentum terjedelmének növekedtével csak romlik, hiszen egyre több kereszthivatkozásra van szükség, és ezek megtalálása egyre hosszadalmasabb ebben az alulméretezett párbeszédablakban.
4.26. ábra A Kereszthivatkozás párbeszédablakban egyszerre csak kilenc elemet tekinthetünk meg
43
A következõkben bemutatjuk, miként készíthetünk a VBA segítségével automatikus kereszthivatkozásokat a címsorokra. Programunk összehasonlítja a kijelölt szövegrészletet a dokumentum címsoraival, és ha egyezést talál, létrehoz egy kereszthivatkozást.
w04.qxd
10/25/2006
4:06 PM
Page 155
4. fejezet • A szerkesztés nagyágyúi
155
Hivatkozás Word-módra A következõkben bemutatott eljárás a Word VBA GetCrossReferenceItems függvényét használja, amely megadja a hivatkozások lehetséges célpontjait a dokumentumban. Mivel a Word folyamatosan frissíti és indexeli ezt a listát, elérése igen gyors. Mindennek eredményeképpen az itt bemutatott makró gyorsabb, mint a következõ részben készített eljárás – a sebességnek azonban ára van: csak olyan elemekre hivatkozhatunk, amelyeket a Word erre alkalmasnak tart (például a beépített címsorstílusokkal formázott címsorokra). Ha azonban saját címsorstílusokat is alkalmazunk, mondjuk a keretes anyagokban, az itt feltüntetett címek kívül esnek a Word látókörén. Helyezzük el az alábbi makrót egy szabadon választott sablonban [50. fogás], majd indítsuk el az Eszközök, Makró, Makrók párbeszédablakról (de elhelyezhetjük a megfelelõ parancsot egy eszköztáron vagy menüben is [1. fogás]). Ha aktuális kijelölésünk egynél több bekezdést tartalmaz, a makró egyszerûen kilép, nem végez semmilyen mûveletet. Sub InsertAutoXRef( ) Dim Dim Dim Dim Dim
sel As Selection doc As Document vHeadings As Variant v As Variant i As Integer
Set sel = Selection Set doc = Selection.Document ' Kilép, ha a kijelölésben több bekezdés szerepel If sel.Range.Paragraphs.Count <> 1 Then Exit Sub ' Összezárja a kijelölést, ha szóköz vagy bekezdésjel áll ' valamelyik végén sel.MoveStartWhile cset:=(Chr$(32) & Chr$(13)), _ Count:=sel.Characters.Count sel.MoveEndWhile cset:=(Chr$(32) & Chr$(13)), _ Count:=-sel.Characters.Count vHeadings = doc.GetCrossReferenceItems(wdRefTypeHeading) i = 1 For Each v In vHeadings If Trim (sel.Range.Text) = Trim (v) Then sel.InsertCrossReference _ referencetype:=wdRefTypeHeading, _ referencekind:=wdContentText, _
43
w04.qxd
156
10/25/2006
4:06 PM
Page 156
Word mesterfogások
referenceitem:=i Exit Sub End If i = i + 1 Next v MsgBox "Couldn't match: " & sel.Range.Text End Sub
Makrónknak két lényeges gyengéje is van. Elõször is, ha több címsor is megfelel a kijelölt szövegnek, a kód hivatkozást hoz létre az elsõhöz, a többit pedig figyelmen kívül hagyja. Ez gondot okozhat, ha több, azonos szövegû címsorunk is van – ilyen például e könyv majdnem minden fogásánál az „A kód” címsor. Másodszor, a kód semmiféle védelmet nem biztosít az önhivatkozások ellen. Ha a talált egyezés éppen a kijelölt szöveg, a hivatkozás helyettesíti a hivatkozó részt, így végül megszakadt hivatkozást kapunk (lásd a 4.27. ábrát).
4.27. ábra Az önhivatkozás eredménye egy megszakadt hivatkozás
A szöveg akaratlan törlése ilyen módon a Word Kereszthivatkozás párbeszédablakában is fenyeget. Önhivatkozás készítésénél a Word üzenetben értesít arról, hogy hivatkozásunk üres – de csak miután már törölte a szövegrészletet.
Egy hatékonyabb hivatkozási módszer Az alábbi eljárás sebességében nem veheti el a versenyt a fenti kóddal, de rugalmassága miatt alkalmasabb kiindulópont lehet saját ötleteink megvalósításához. Kódunk nem ragad le a Word beépített címsorstílusainál – minden bekezdést átvizsgál a kijelölt szöveggel való egyezést keresve. Ez viszont azt jelenti, hogy olyan címekre is hivatkozhatunk, amelyeket felhasználói stílussal formáztak.
43
Az eljárás, eltérõen az elõzõtõl, ellenõrzi azt is, hogy az egyezés nem maga a kijelölt szöveg, így kizárja az önhivatkozás lehetõségét.
w04.qxd
10/25/2006
4:06 PM
Page 157
4. fejezet • A szerkesztés nagyágyúi
157
A kód öt eljárásra bontható: a MakeAutoXRef makróra és ennek támogató eljárásaira, amelyek a hivatkozás készítéséhez szükséges mûveleteket végzik el. Helyezzük el mind az öt eljárást egy szabadon választott sablonban [50. fogás], és a mûvelet elvégzéséhez futtassuk a MakeAutoXRef makrót. Kezdjük a MakeAutoXRef bemutatásával, amely – a késõbb megadott eljárásokra támaszkodva – átvizsgálja a dokumentum összes bekezdését. Ha talál olyan bekezdést, amely megegyezik a kijelölt szövegrészlettel, létrehoz az egyezés körül egy könyvjelzõt, és a kijelölt szöveget egy hivatkozással helyettesíti erre a könyvjelzõre. Ha az egyezõ bekezdésre már más is hivatkozik, a meglevõ könyvjelzõt veszi használatba. Sub Dim Dim Dim Dim Dim Dim Dim
MakeAutoXRef( ) sel As Selection rng As Range para As Paragraph doc As Document sBookmarkName As String sSelectionText As String lSelectedParaIndex As Long
Set sel = Selection Set doc = sel.Document If sel.Range.Paragraphs.Count <> 1 Then Exit Sub lSelectedParaIndex = GetParaIndex(sel.Range.Paragraphs.First) sel.MoveStartWhile cset:=(Chr$(32) & Chr$(13)), _ Count:=sel.Characters.Count sel.MoveEndWhile cset:=(Chr$(32) & Chr$(13)), _ Count:=-sel.Characters.Count sSelectionText = sel.Text For Each para In doc.Paragraphs Set rng = para.Range rng.MoveStartWhile cset:=(Chr$(32) & Chr$(13)), _ Count:=rng.Characters.Count rng.MoveEndWhile cset:=(Chr$(32) & Chr$(13)), _ Count:=-rng.Characters.Count If rng.Text = sSelectionText Then If Not GetParaIndex(para) = lSelectedParaIndex Then sBookmarkName = GetOrSetXRefBookmark(para) If Len(sBookmarkName) = 0 Then MsgBox "Couldn't get or set bookmark" Exit Sub End If sel.InsertCrossReference _ referencekind:=wdContentText, _
43
w04.qxd
158
10/25/2006
4:06 PM
Page 158
Word mesterfogások
referenceitem:= _ doc.Bookmarks(sBookmarkName), _ referencetype:=wdRefTypeBookmark, _ insertashyperlink:=True Exit Sub Else MsgBox "Can't self reference!" End If End If Next para End Sub
A kód félkövérrel kiemelt része felelõs a hivatkozás elkészítéséért. Vegyük észre a hasonlóságot az elõzõ részben bemutatott eljárással. A segédeljárások. Az alábbi függvény eltávolít az átadott karakterláncból minden olyan karaktert, ami nem szerepelhet a Word könyvjelzõiben (a szóközöket kivéve – ezeket egy másik eljárás aláhúzásokra cseréli): Dim i As Integer For i = 33 To 255 Select Case i Case 33 To 47, 58 To 64, 91 To 96, 123 To 255 str = Replace(str, Chr (i), vbNullString) End Select Next i RemoveInvalidBookmarkCharsFromString = str End Function
A következõ függvény az átadott karakterláncból egy érvényes könyvjelzõnevet készít, az XREF elõtaggal, valamint egy az egyediséget biztosító ötjegyû véletlen számmal [68. fogás] kiegészítve. Így például az „Ez egy cím” címsorból valami ilyesmi lesz: „XREF56774_Ez_egy_cím”. Ezzel sokkal könnyebb dolgozni, mint a Word kereszthivatkozó könyvjelzõinél alkalmazott „_Ref45762234” és hasonló nevekkel.
43
Function ConvertStringRefBookmarkName(ByVal str As String) _ As String str = RemoveInvalidBookmarkCharsFromString(str) str = Replace(str, Chr$(32), "_") str = "_" & str str = "XREF" & CStr(Int(90000 * Rnd + 10000)) & str ConvertStringRefBookmarkName = str End Function
w04.qxd
10/25/2006
4:06 PM
Page 159
4. fejezet • A szerkesztés nagyágyúi
159
A következõ függvény egyszerûen meghatározza a bekezdés sorszámát a dokumentumban (vagyis például a dokumentum második bekezdésének sorszáma 2): Function GetParagraphIndex(para As Paragraph) As Long GetParagraphIndex = _ para.Range.Document.Range(0, _ para.Range.End).Paragraphs.Count End Function
Végezetül, utolsó függvényünk kereszthivatkozó könyvjelzõt hoz létre azokban a bekezdésekben, amelyek nem tartalmaznak könyvjelzõt, és visszatér e könyvjelzõ nevével. Ha a bekezdés már rendelkezik könyvjelzõvel, a függvény ennek nevét adja vissza. Function GetOrSetXRefBookmark(para As Paragraph) As String Dim i As Integer Dim rng As Range Dim sBookmarkName As String If para.Range.Bookmarks.Count <> 0 Then For i = 1 To para.Range.Bookmarks.Count If InStr(1, para.Range.Bookmarks(i).Name, "XREF") _ Then GetOrSetXRefBookmark = _ para.Range.Bookmarks(i).Name Exit Function End If Next i End If Set rng = para.Range rng.MoveEnd unit:=wdCharacter, Count:=-1 sBookmarkName = ConvertStringRefBookmarkName(rng.Text) para.Range.Document.Bookmarks.Add _ Name:=sBookmarkName, _ Range:=rng GetOrSetXRefBookmark = sBookmarkName End Function
Futtatás Makrónk nem sok idõt takarít meg, ha eléréséhez egy menüben kell keresgélnünk, ezért érdemes egy ügyes billentyûkombinációt rendelnünk hozzá. Ehhez válasszuk az Eszközök, Testreszabás menüpontot, és nyomjuk meg a Billentyûparancs gombot. Változtatásainkat mentsük ugyanabba a sablonba, ahol a kódot is elhelyeztük. Válasszuk a Kategóriák oszlop Makrók pontját, majd a Parancsok oszlopban keressük ki a MakeAutoXRef makrót. Ez után már csak ki kell választanunk a párbeszédablakban a kívánt billentyûkombinációt, és hozzárendelnünk a makróhoz.
43
w04.qxd
160
10/25/2006
4:06 PM
Page 160
Word mesterfogások
44. fogás • Rugalmasabb kereszthivatkozások A Word kereszthivatkozásokat kezelõ felülete meglehetõsen szûk körû lehetõségeket kínál. A következõkben bemutatjuk, hogyan tágíthatjuk a mozgásterünket. A Word Kereszthivatkozás párbeszédablaka nem túl sok dokumentumelemhez enged kereszthivatkozást készíteni – lehetõségeink teljes listáját a 4.28. ábra mutatja.
4.28. ábra A Word beépített kereszthivatkozási típusai
De mi a helyzet akkor, ha olyan elemekre szeretnénk hivatkozni, amelyek nem találhatók meg a listában? Ha olyan sablonnal dolgozunk, amely számos különbözõ címsortípust alkalmaz, köztük olyanokat is, amelyek nem szerepelnek a Word beépített stílusai között, igen nehéz dolgunk lesz, ha hivatkozni szeretnénk rájuk. A következõkben bemutatjuk, miként készítsük el saját kereszthivatkozási párbeszédablakunkat, valami olyasmit, mint amit a 4.29. ábrán láthatunk. A bal oldali oszlop felsorolja a dokumentum összes bekezdésstílusát, a jobb oldali pedig azokat a bekezdéseket, amelyek az adott stílust alkalmazzák. Amellett, hogy többféle stílusú bekezdésre enged hivatkozni, új párbeszédablakunk darabszámban is több elemet képes megjeleníteni, ami rengeteg görgetéstõl kímélhet meg. Tipp
Ha más Word dokumentumra mutató kereszthivatkozást szeretnénk létrehozni, lapozzuk fel a Kereszthivatkozások dokumentumok között [78. fogás] címszót.
A párbeszédablak felépítése
44
Az alábbiakban bemutatjuk, hogyan készíthetjük el a 4.29. ábrán látható párbeszédablakot. Az egyszerûség kedvéért a „díszítõ elemeket”, mint a listamezõk címeit, most elhagytuk, így ez a párbeszédablak mindössze az alap, amelybõl kiindulva elkészíthetjük a nekünk tetszõ változatot.
w04.qxd
10/25/2006
4:06 PM
Page 161
4. fejezet • A szerkesztés nagyágyúi
161
Mindenekelõtt válasszuk az Eszközök, Makró, Visual Basic Editor menüpontot. Jelöljünk ki egy szabadon választott sablont [50. fogás] a Project Explorerben, és válasszuk az Insert, UserForm (Beszúrás, Felhasználói ûrlap) menüpontot.
4.29. ábra Egy jobb párbeszédablak a kereszthivatkozások kezelésére
A Properties (Tulajdonságok) ablakban adjuk az ûrlapnak az „ufXRefs” nevet, címsora pedig legyen „Cross Reference” (Kereszthivatkozás). A bal alsó sarokban található méretezõfogantyút megragadva méretezzük át az ûrlapot úgy, hogy nagyjából 380 képpont széles és 260 képpont magas legyen. Ezt követõen az eszközkészketbõl (Toolbox) húzzunk két listamezõt az ûrlapra, a 4.30. ábrán látható módon. A Properties ablakban adjuk a bal oldalinak az „lbStyles”, a jobb oldalinak pedig az „lbParas” nevet. Végül helyezünk el az elsõ listamezõ alatt két CommandButton gombot. Legyen a nevük „cmbInsert” és „cmbCancel”, feliratuk pedig Insert (Beszúrás) és Cancel (Mégse).
A kód Kódunk néhány, az Automatikus kereszthivatkozások [43. fogás] fogásnál megismert segédfüggvényre épül, nevezetesen az alábbiakra: • GetOrSetXRefBookmark • ConvertStringToXRefBookmarkName • GetParagraphIndex
44
w04.qxd
162
10/25/2006
4:06 PM
Page 162
Word mesterfogások
Fontos, hogy ezek az eljárások ugyanabban a sablonban legyenek, ahol a felhasználói ûrlap.
4.30. ábra Az ufXrefs ûrlapra magunk rajzolhatjuk fel a listamezõket
Továbbra is nyitva tartva a felhasználói ûrlapot, a View, Code (Nézet, Kód) menüponttal lépjünk be az ûrlap kódmoduljába, és helyezzük el benne az alábbi kódot: Option Explicit Private colParagraphData As Collection Private Sub cmbCancel_Click( ) Unload Me End Sub Private Sub UserForm_Initialize( ) Dim v As Variant Dim sty As Style For Each sty In ActiveDocument.Styles If sty.Type = wdStyleTypeParagraph Then lbStyles.AddItem sty.NameLocal End If Next sty lbStyles.Selected(0) = True End Sub Private Sub lbStyles_Change( ) Dim col As Collection Dim para As Paragraph Dim k As Integer Set colParagraphData = New Collection lbParas.Clear
44
k = 1 For Each para In ActiveDocument.Paragraphs If para.Style = lbStyles.Value Then
w04.qxd
10/25/2006
4:06 PM
Page 163
4. fejezet • A szerkesztés nagyágyúi
163
Set col = New Collection col.Add Key:="Index", Item:=k col.Add Key:="Text", Item:=Left(para.Range.Text, _ para.Range.Characters.Count - 1) colParagraphData.Add Item:=col lbParas.AddItem (col("Text")) Set col = Nothing End If k = k + 1 Next para End Sub Private Sub cmbInsert_Click( ) Dim lSelectedParaIndex As Long Dim sBookmarkName As String Dim para As Paragraph lSelectedParaIndex = colParagraphData(lbParas.ListIndex + _ 1)("Index") Set para = ActiveDocument.Paragraphs(lSelectedParaIndex) sBookmarkName = GetOrSetXRefBookmark(para) If Len(sBookmarkName) = 0 Then MsgBox "Couldn't get or set bookmark" Unload Me End If Selection.InsertCrossReference _ referencekind:=wdContentText, _ referenceitem:=ActiveDocument.Bookmarks(sBookmarkName), _ referencetype:=wdRefTypeBookmark, _ insertashyperlink:=True Unload Me End Sub
Ahogy új stílust választunk az lbStyles listamezõben, a program kiüríti a colParagraphData gyûjteményt, majd feltölti azon bekezdések adataival, amelyek ezt az új stílust használják. Példánkban ezek az adatok: a bekezdés helyzete a dokumentumban (sorszáma), valamint a bekezdés szövege.
Futtatás Helyezzük el az alábbi sorokat az egyik kódmodulban, a felhasználói ûrlapot tartalmazó sablonban: Sub ShowBetterCrossReferenceDialog ufXRefs.Show End Sub
44
w04.qxd
164
10/25/2006
4:06 PM
Page 164
Word mesterfogások
A párbeszédablak megjelenítéséhez futtassuk a ShowBetterCrossReferenceDialog makrót az Eszközök, Makró, Makrók menübõl, vagy helyezzük el egy menüben vagy eszköztáron [1. fogás]. Ha kijelölünk egy bekezdést, és az Insert gombra kattintunk, a program egy könyvjelzõt hoz létre e bekezdés körül, és az aktuális kijelölést egy erre a könyvjelzõre mutató kereszthivatkozással helyettesíti. A könyvjelzõt és a hivatkozást a 4.31. ábrán láthatjuk, továbbá az ábra alján megfigyelhetjük a megfelelõ mezõkódot is.
4.31. ábra Kódunk ilyen könyvjelzõt és hivatkozást hoz létre
Ha a bekezdés, amelyre hivatkozni szeretnénk, már szerepel hivatkozásban, a meglevõ könyvjelzõt használjuk, új nem jön létre.
44
