「マクロの記録」を卒業しよう。選択した図形からページ番号を突き止める、VBA思考の第一歩
こんにちは。CorelDRAWの自動化の世界へようこそ。
「マクロの記録」機能を使って、ボタン一つで作業を自動化することに成功した。そんな喜びを感じている方も多いでしょう。しかし、記録されたコードを眺めてみて、「なぜこの長い命令が必要なんだろう?」「もっとスマートに書けないのかな?」と疑問に思ったことはありませんか?
もしそう感じたなら、あなたはすでに「ただのユーザー」から「エンジニア」への入り口に立っています。
今日は、プログラミング初学者が最初にぶつかる「オブジェクトの壁」を乗り越えながら、「今選んでいる図形が、何ページ目にあるのかを教えてくれる」という、シンプルながらも極めて重要なマクロを一緒に作っていきましょう。
ここをクリアすれば、CorelDRAW VBAの基本構造(オブジェクトモデル)が驚くほどクリアに見えてくるはずですよ。
1. なぜ「マクロの記録」だけでは足りないのか?
マクロの記録は、あなたがマウスで行った操作をすべて「ログ」として書き出します。
例えば「図形を選択して、ページ番号を確認する」という動作を記録すると、CorelDRAWは「どのツールを使い、どの座標を触り、どのコマンドを叩いたか」という膨大な手順を記録してしまいます。
しかし、私たちが本当にやりたいことは「図形というオブジェクトが持っている『ページ番号』という情報を取り出すこと」です。
効率的なコードを書くためには、手順を追うのではなく、「オブジェクトの親子関係(階層構造)」を理解する必要があります。
2. CorelDRAWの「家系図」を理解する
VBAをマスターする最大の鍵は、CorelDRAWが持つオブジェクトの階層構造(Hierarchy)を理解することです。
図形(Shape)は、どこからともなく存在するわけではありません。必ず誰かの「子供」として存在しています。その家系図を簡略化すると、以下のようになります。
1. Application(CorelDRAWソフトそのもの)
2. ┗ Document(開いているファイル)
3. ┗ Page(ページ)
4. ┗ Layer(レイヤー)
5. ┗ Shape(図形・オブジェクト)
私たちが今回やりたいのは、「Shape(図形)から、その親であるPage(ページ)へ、さかのぼって情報を聞きに行く」という行為です。
「君、何ページ目のレイヤーに属しているんだい?」と図形に尋ねるイメージですね。
3. 実践:ページ番号を特定するコード
それでは、実際にコードを書いてみましょう。初心者の方がそのままコピペして使えるよう、かつ「プロの作法」であるエラー回避処理を組み込んだ決定版です。
Option Explicit
' =================================================================
' マクロ名: GetSelectedShapePageNumber
' 概要: 現在選択中のオブジェクトが所属するページ番号をポップアップ表示する
' 作成者: あなたの専属エンジニア
' =================================================================
Sub GetSelectedShapePageNumber()
' --- 1. 変数の宣言(メモリの準備) ---
Dim s As Shape
Dim pgIndex As Integer
' --- 2. エラーハンドリング(何も選んでいない時の対策) ---
' 選択していない状態で実行するとエラーで止まってしまうため、
' 「選択されている図形の数」をまずチェックするのがプロの鉄則です。
If ActiveSelection.Shapes.Count = 0 Then
MsgBox "図形が選択されていません。図形を選んでから実行してください。", vbExclamation, "警告"
Exit Sub ' ここで処理を終了させる
End If
' --- 3. メイン処理(オブジェクトの階層を辿る) ---
' 現在選択されている最初の図形を変数 s に格納します
Set s = ActiveSelection.Shapes(1)
' 【ここが核心!】
' 図形(s) -> その所属するページ(Page) -> そのページの番号(Index)
' という順番で、親へとさかのぼって情報を取得します
pgIndex = s.Page.Index
' --- 4. 結果の表示 ---
MsgBox "現在選択中のオブジェクトは、" & vbCrLf & _
"【 " & pgIndex & " 】ページ目にあります。", vbInformation, "ページ特定完了"
End Sub
4. コードの徹底解剖:ここがエンジニアの視点
コードのどこに「知恵」が詰まっているのか、解説します。
① `ActiveSelection.Shapes.Count = 0` の重要性
プロのコードには必ず「例外処理(エラー対策)」があります。
もし図形を一つも選んでいない状態で「図形のページを教えて!」と命令すると、CorelDRAWは「えっ、どの図形のこと?」とパニックを起こし、VBAはエラーで強制終了してしまいます。
`If … Then Exit Sub` を入れることで、ユーザーに優しく「選んでくださいね」と伝えることができるのです。
② `s.Page.Index` という「さかのぼり」
ここが今回のハイライトです。
`s` は図形(Shape)です。
`s.Page` と書くことで、その図形が住んでいる「ページ」というオブジェクトにアクセスしています。
そして、そのページが持つプロパティである `Index`(インデックス番号)を呼び出しているのです。
この「ドット(.)で繋いで、より詳細な情報へ潜っていく」感覚こそが、APIを操作する醍醐味です。
5. ステップアップのためのアドバイス
このマクロを動かせたら、次はこんな改造に挑戦してみてください。これが上達への近道です。
- ページ番号ではなく「ページ名」を表示してみる
`s.Page.Index` を `s.Page.Name` に変えてみてください。数字ではなく、あなたが付けた「表紙」や「デザイン案A」といった名前が表示されるはずです。
- 複数の図形を選択したときに、全図形のページを表示する
今は `Shapes(1)`(最初の一個)だけを見ていますが、`For Each` という構文を使えば、選択したすべての図形をスキャンできるようになります。
おわりに
CorelDRAW VBAは、単なる「自動記録ツール」ではありません。
オブジェクトの親子関係という「世界の構造」を理解して命令を下す、非常に論理的で美しい言語です。
今日学んだ「オブジェクトをさかのぼる」という考え方は、どんなに複雑な自動化マクロを作る際にも必ず役に立つ、一生モノの基礎知識です。
一歩ずつ、着実に。
次回のレッスンでも、またお会いしましょう!
