オブジェクトの探索方法（オートシェイプのTextを探して）
VBAを書き進めて行くと、どうしてもオブジェクトの扱い時に分からないことがでてきます、
何が分からないかというと、オブジェクトの中の目的の要素をどのように指定したら良いのかということです、
オブジェクトの中を調べて、目的の要素にたどり着く方法を説明します。
イミディエイトウィンドウ、オブジェクトブラウザー、ヘルプも使います。
ローカルウィンドウの使い方
VBAのエディター、VBEにはいくつかのウィンドウがあります、その中で、ローカルウィンドウの使い方の説明です、これが使えないと、配列やオブジェクトを扱ったVBAのデバッグに困ることになります。サンプルコードは、以下の表を使っています。まずは、配列でのローカルウィンドウの使い方について。
VBEの使い方：ローカル ウィンドウ・ローカル ウィンドウの表示 ・ローカル ウィンドウの基本的な使い方 ・ローカル ウィンドウの制限 ・ローカル ウィンドウの最後に
こちら見てください。
オブジェクト探索の説明で使う例題
以下の例を使って説明します。
オートシェイプで、四角の中にテキストを書きました。
これを、左端に番号順に並べます。
以下のように並べるという事です。
分かってしまえば簡単なコードです。
もちろん、VBAの書き方はいろいろありますが、
いずれにしろ、たったこれだけです。
このようなオートシェイプをVBAで扱ったことが無いと、なにやら分からないことだらけではないでしょうか。
そもそも、
・オートシェイプを動かすには
・オートシェイプの文字を取得するには
分からないことだらけで、最初から、どうしたらよいのか途方に暮れます。
オートシェイプで、四角の中にテキストを書きました。
以下のように並べるという事です。
Sub sample()
Dim i As Long
Dim sp As Shape
Dim posTop As Single
For i = 1 To 3
For Each sp In ActiveSheet.Shapes
If sp.TextFrame.Characters.Text = "TEST" & i Then
sp.Top = posTop
sp.Left = 0
posTop = posTop + sp.Height
End If
Next
Next
End Sub
もちろん、VBAの書き方はいろいろありますが、
いずれにしろ、たったこれだけです。
このようなオートシェイプをVBAで扱ったことが無いと、なにやら分からないことだらけではないでしょうか。
・オートシェイプを動かすには
・オートシェイプの文字を取得するには
分からないことだらけで、最初から、どうしたらよいのか途方に暮れます。
自動記録を使ってオートシェイプの概要を知る
そこで、誰もがやるであろう自動記録を使って、オートシェイプを動かしてみると、
まず目にとまるのは、
Shapes
オートシェイプのオブジェクトらしいという事です。
このくらいの想像力はVBAをやるなら必要ですね。
そして、複数系なのでコレクションであろうことも理解してください。
Shapes以外は無視しましょう。
ShapeRangeやIncrementは、ちょっと想像しづらいですからひとまず置いときましょう。。
ここまでが分からない場合は、
ExcelマクロVBA入門
コレクションについては、
第58回.コレクションとは
つまり、オートシェイプは、
Shapeオブジェクトであり、Shapesコレクションに含まれるという事ですね。
ここまで分かると、以下のコードが書けます。
Sub Macro1()
'
' Macro1 Macro
'
'
ActiveSheet.Shapes.Range(Array("Rectangle 2")).Select
Selection.ShapeRange.IncrementLeft -165
Selection.ShapeRange.IncrementTop -57
End Sub
まず目にとまるのは、
Shapes
オートシェイプのオブジェクトらしいという事です。
このくらいの想像力はVBAをやるなら必要ですね。
そして、複数系なのでコレクションであろうことも理解してください。
Shapes以外は無視しましょう。
ShapeRangeやIncrementは、ちょっと想像しづらいですからひとまず置いときましょう。。
ExcelマクロVBA入門
・VBA学習の進め方について ・1. VBAの基礎・基本：VBA入門 ・2. VBA入門に必要なVBEの基本的使い方 ・3. VBAプログラミングの基礎・基本 ・4. Excel各種機能とオブジェクトの理解：VBA入門 ・5. VBA初級からVBA中級を目指して ・6. VBA入門の後日追加記事 ・7. VBA入門その後の学習について ・「VBA入門」の記事を学校の授業もしくは企業研修でお使いになる場合
こちらで勉強してください。コレクションについては、
第58回.コレクションとは
・コレクションの中から単一オブジェクトを指定する場合 ・セルであるRangeオブジェクトのコレクションは？ ・コレクションの要素数 ・Collectionオブジェクト
つまり、オートシェイプは、
Shapeオブジェクトであり、Shapesコレクションに含まれるという事ですね。
ここまで分かると、以下のコードが書けます。
Sub sample()
Dim i As Long
Dim sp As Shape
Dim posTop As Single
For i = 1 To 3
For Each sp In ActiveSheet.Shapes
Next
Next
End Sub
ローカルウィンドウでオートシェイプのテキストを調べる
テキスト内の数字を1～3の順に並べる為に、数字順に処理しようという事ですが、
問題は、オートシェイプのテキストをどのように取得するかです。
Stopを入れて、停止させてみましょう。
ここで、ローカルウィンドウを表示してみましょう。
spを展開しましょう。
かなり多くのメンバーがあり、どれがテキストなのか・・・
それでは、VBAを終了させて、あらためて自動記録でテキストを変更してみましょう。
"TEXT1"を"TEXT11"に変更してみます。
"TEST11"と書かれている行をみてみると、
Selection.ShapeRange(1).TextFrame2.TextRange.Characters.Text = "TEST11"
何やら、
ShapeRange
TextFrame2
TextRange
Characters
このあたりを使うようです。
順に適当に和訳して、まずは適当に解釈して見当をつけます。
図形範囲
テキスト枠
テキスト範囲
文字列
この、適当に和訳して見当を付けるのが重要です。
いちいち全てを調べていたのでは、時間がいくらあっても足りません。
ShapeRangeはオートシェイプの集まり、つまりは、Shapesと同じようなものではないかと、
なので、無視して次へ（ここで気になる場合はググって調べましょう）
TextFrame2ここに核心のテキストがはいっていそうだと、このように目星をつけます。
では、TEST11をTEST１に戻しておいて、
最初のsampleを実行して、ローカルウィンドウでspの中を探してみましょう。
TextFrame2の中に、先の自動記録で見つけた、
TextRangeがありました、これをさらに展開すると、
TEXTの値に、"TEST2"が見つかりました。
つまり、
sp.TextFrame2.TextRange.Text
これでオートシェイプ内のテキストを取得できそうです。
イミディエイトウィンドウで確かめてみると、
間違いなく取得できています。
このTextを文字列を判定すれば出来そうですね。
問題は、オートシェイプのテキストをどのように取得するかです。
Stopを入れて、停止させてみましょう。
それでは、VBAを終了させて、あらためて自動記録でテキストを変更してみましょう。
"TEXT1"を"TEXT11"に変更してみます。
Sub Macro2()
'
' Macro2 Macro
'
'
ActiveSheet.Shapes.Range(Array("Rectangle 2")).Select
Selection.ShapeRange(1).TextFrame2.TextRange.Characters.Text = "TEST11"
With Selection.ShapeRange(1).TextFrame2.TextRange.Characters(1, 6). _
ParagraphFormat
.FirstLineIndent = 0
.Alignment = msoAlignLeft
End With
With Selection.ShapeRange(1).TextFrame2.TextRange.Characters(1, 6).Font
.NameComplexScript = "+mn-cs"
.NameFarEast = "+mn-ea"
.Fill.Visible = msoTrue
.Fill.ForeColor.ObjectThemeColor = msoThemeColorLight1
.Fill.ForeColor.TintAndShade = 0
.Fill.ForeColor.Brightness = 0
.Fill.Transparency = 0
.Fill.Solid
.Size = 18
.Name = "+mn-lt"
End With
Range("A1").Select
End Sub
"TEST11"と書かれている行をみてみると、
Selection.ShapeRange(1).TextFrame2.TextRange.Characters.Text = "TEST11"
何やら、
TextFrame2
TextRange
Characters
順に適当に和訳して、まずは適当に解釈して見当をつけます。
テキスト枠
テキスト範囲
文字列
いちいち全てを調べていたのでは、時間がいくらあっても足りません。
ShapeRangeはオートシェイプの集まり、つまりは、Shapesと同じようなものではないかと、
なので、無視して次へ（ここで気になる場合はググって調べましょう）
TextFrame2ここに核心のテキストがはいっていそうだと、このように目星をつけます。
最初のsampleを実行して、ローカルウィンドウでspの中を探してみましょう。
TextRangeがありました、これをさらに展開すると、
つまり、
イミディエイトウィンドウで確かめてみると、
このTextを文字列を判定すれば出来そうですね。
オートシェイプの位置移動について
次は、オートシェイプの位置の移動です。
最初の自動記録では、
Selection.ShapeRange.IncrementLeft -165
Selection.ShapeRange.IncrementTop -57
Increment（増加、増大と言った英単語）がどうもそのようなのですが・・・
ここは、慣れと事前知識が必要かもしれません。
Incrementなので、場所を特定しているのではなく、現在位置からの移動量を指定しているのだろうと推測できるのです。
IncrementLeftで左位置の移動、IncrementTopで上位置の移動
移動量だからIncrementが付く、だったらIncrementを付けずに、Left、Topでよくねー・・・
のようなノリで調べてみると良いでしょう。
ローカルウィンドウでspの中を探してみましょう。
ありますね、LeftとTop
しかも数値をみれば、絶対位置であることも想像できるでしょう。
ここまで調べたら、ヘルプ（MSのVBAリファレンス）も使いましょう。
「vba shape top」このような感じでぐぐってみると良いでしょう。
図形範囲の最前面にある図形の上端から、ワークシートの上端までの距離をポイント単位で表す単精度浮動小数点型 (single) の値を取得、または設定します。
まさにこれで間違いがないことが分かりますし、数値はポイントであることも分かります。
最初の自動記録では、
Selection.ShapeRange.IncrementTop -57
ここは、慣れと事前知識が必要かもしれません。
Incrementなので、場所を特定しているのではなく、現在位置からの移動量を指定しているのだろうと推測できるのです。
IncrementLeftで左位置の移動、IncrementTopで上位置の移動
移動量だからIncrementが付く、だったらIncrementを付けずに、Left、Topでよくねー・・・
のようなノリで調べてみると良いでしょう。
ローカルウィンドウでspの中を探してみましょう。
しかも数値をみれば、絶対位置であることも想像できるでしょう。
ここまで調べたら、ヘルプ（MSのVBAリファレンス）も使いましょう。
「vba shape top」このような感じでぐぐってみると良いでしょう。
VBAを完成させる
以上をもとにVBAコードを完成させると、
あれれ、最初のVBAコードと何やら少し違う・・・
最初のコードは、
If sp.TextFrame.Characters.Text = "TEST" & i Then
最後のコードは、
If sp.TextFrame2.TextRange.Text = "TEST" & i Then
先に解説しますと、
TextFrame2は、Excel2007で追加されたプロパティで、
TextFrameは、それ以前からあるプロパティです。
どちらでも、結果は同じです。
Sub sample()
Dim i As Long
Dim sp As Shape
Dim posTop As Single
For i = 1 To 3
For Each sp In ActiveSheet.Shapes
If sp.TextFrame2.TextRange.Text = "TEST" & i Then
sp.Top = posTop
sp.Left = 0
posTop = posTop + sp.Height
End If
Next
Next
End Sub
あれれ、最初のVBAコードと何やら少し違う・・・
If sp.TextFrame.Characters.Text = "TEST" & i Then
最後のコードは、
If sp.TextFrame2.TextRange.Text = "TEST" & i Then
TextFrame2は、Excel2007で追加されたプロパティで、
TextFrameは、それ以前からあるプロパティです。
どちらでも、結果は同じです。
オブジェクトブラウザーを使いさらにオブジェクトを調べる
では、
sp.TextFrame.Characters.Text
このコードにはどのようにたどり着いたら良いでしょうか。
どうも、TextやCharacterといったキーワードが見当たりません。
ローカルウィンドウの使い方
こちらに書きましたが、ローカルウィンドウのメンバーにはすべてが表示されているわけではありません。
そこで、
オブジェクトブラウザー(F2)を見てみましょう。
ありました、
Characters
これっぽいですよね、
慣れてくれば、VBEのインテリセンス（候補表示）で見つけられるようになり、
さらに、その下の.Textも簡単に見つけられます。
しかし、もっと階層のあるオブジェクトの場合、インテリセンス（候補表示）だけではなかなか探せない時もあります。
そんな時は、判明したオブジェクトを一旦オブジェクト変数にいれて、ローカルウィンドウを見ます。
オブジェクトを調べたいので、オブジェクトの型は汎用のObjectにします。
大抵はプロパティ名と同じですが、調べるだけなのでObjectで十分でしょう。
確かに、Textがありました。
Fontもありますね。
Captionにも同じ"TEST2"がありますが、今回の場合はTextでよいでしょう。
このようにオブジェクトを探索できるようになれば、どんなオブジェクトでも自分で調べて自在にVBAを書くことができるようになります。
ローカルウィンドウ、イミディエイトウィンドウ、オブジェクトブラウザー、ヘルプ
これがあれば何も要らない。
sp.TextFrame.Characters.Text
このコードにはどのようにたどり着いたら良いでしょうか。
ローカルウィンドウの使い方
こちらに書きましたが、ローカルウィンドウのメンバーにはすべてが表示されているわけではありません。
そこで、
オブジェクトブラウザー(F2)を見てみましょう。
Characters
これっぽいですよね、
慣れてくれば、VBEのインテリセンス（候補表示）で見つけられるようになり、
さらに、その下の.Textも簡単に見つけられます。
そんな時は、判明したオブジェクトを一旦オブジェクト変数にいれて、ローカルウィンドウを見ます。
大抵はプロパティ名と同じですが、調べるだけなのでObjectで十分でしょう。
Fontもありますね。
Captionにも同じ"TEST2"がありますが、今回の場合はTextでよいでしょう。
これがあれば何も要らない。
ウォッチウィンドウについて
今回は、ローカルウィンドウを中心に説明しましたが、適宜ウォッチウィンドウも使って、効率的に調べるようにしてください。
VBEの使い方：ウォッチ ウィンドウ
・ウォッチ ウィンドウの表示 ・ウォッチ ウィンドウとは ・「ウォッチ式の追加」の操作手順 ・ウォッチ式の追加 ・ウォッチ ウィンドウの制限と注意 ・ウォッチ ウィンドウの最後に
同じテーマ「マクロVBA技術解説」の記事
文字種（ひらがな、全半角カタカナ、半角英大文字等々）の判定
オブジェクトとプロパティの真実
オブジェクト式について
オブジェクトの探索方法（オートシェイプのTextを探して）
条件付きコンパイル（32ビット64ビットの互換性）
ドキュメントプロパティ（BuiltinDocumentProperties,CustomDocumentProperties）
VBAでファイルを既定のアプリで開く方法
Excelアドインの作成と登録について
VBAでのタイマー処理（SetTimer,OnTime）
マクロでShift_JIS文字コードか判定する
Byte配列と文字コード関数について
新着記事NEW ・・・新着記事一覧を見る
TRIMRANGE関数（セル範囲をトリム：端の空白セルを除外）｜エクセル入門(2024-08-30)
正規表現関数（REGEXTEST,REGEXREPLACE,REGEXEXTRACT）｜エクセル入門(2024-07-02)
エクセルが起動しない、Excelが立ち上がらない｜エクセル雑感(2024-04-11)
ブール型（Boolean）のis変数・フラグについて｜VBA技術解説(2024-04-05)
テキストの内容によって図形を削除する｜VBA技術解説(2024-04-02)
ExcelマクロVBA入門目次｜エクセルの神髄(2024-03-20)
VBA10大躓きポイント（初心者が躓きやすいポイント）｜VBA技術解説(2024-03-05)
テンキーのスクリーンキーボード作成｜ユーザーフォーム入門(2024-02-26)
無効な前方参照か、コンパイルされていない種類への参照です。｜エクセル雑感(2024-02-17)
初級脱出10問パック｜VBA練習問題(2024-01-24)
アクセスランキング ・・・ ランキング一覧を見る
1.最終行の取得（End,Rows.Count）｜VBA入門
2.セルのコピー&値の貼り付け（PasteSpecial）｜VBA入門
3.変数宣言のDimとデータ型｜VBA入門
4.繰り返し処理（For Next)｜VBA入門
5.RangeとCellsの使い方｜VBA入門
6.ブックを閉じる・保存（Close,Save,SaveAs）｜VBA入門
7.セルのクリア（Clear,ClearContents）｜VBA入門
8.メッセージボックス(MsgBox関数)｜VBA入門
9.条件分岐（Select Case）｜VBA入門
10.ブック・シートの選択（Select,Activate）｜VBA入門
- ホーム
- マクロVBA応用編
- マクロVBA技術解説
- オブジェクトの探索方法（オートシェイプのTextを探して）
このサイトがお役に立ちましたら「シェア」「Bookmark」をお願いいたします。
記述には細心の注意をしたつもりですが、
間違いやご指摘がありましたら、「お問い合わせ」からお知らせいただけると幸いです。
掲載のVBAコードは動作を保証するものではなく、あくまでVBA学習のサンプルとして掲載しています。
掲載のVBAコードは自己責任でご使用ください。万一データ破損等の損害が発生しても責任は負いません。