img要素の画像データを連想配列に格納
<< エクセルVBAで特定のaタグのリンクURLをクリックするサブルーチンの作成 :前の記事
前回は、文書ドキュメントの指定した要素のリンクをクリックするサブルーチンの作成について解説しました。クリック処理と併せてtarget属性の重要性についても理解できたかと思います。基本的には処理を円滑にするためにtarget属性を「_self」で処理を行います。新しいウィンドウで表示させたい場合は第三引数に設定しましょう。今回は、特定のimg要素データを連想配列に格納する方法について解説していきます。
img要素の抽出については、「imgタグから要素を特定する」で解説しましたが、Imagesオブジェクトには様々なプロパティが用意されていました。今回はその中の比較的利用する画像URL・画像ファイル名・alt属性・幅・高さを連想配列に格納する方法について解説していきます。
目次
- DOM(Document Object Model)とは
- HTML(HyperText Markup Language)とは
- タグと要素(エレメント)の違い
- 利用するサブルーチン・プロパティ・VBA関数について
- 指定した画像要素オブジェクトデータを連想配列に格納する処理の流れ
- 指定した画像要素オブジェクトデータを連想配列に格納するサンプルコード
- まとめ
DOM(Document Object Model)とは
DOMとは「Document Object Model」の略称で、html・head・body・p・aなどのHTMLドキュメント要素にアクセスして取得や操作ができる仕組みのことです。
以下はHTMLドキュメントをツリー構造に表したものでDOMツリーと呼ばれます。階層状のツリー構造でHTMLドキュメントを表現します。
HTML(HyperText Markup Language)とは
HTMLとは「HyperText Markup Language」の略称で、Webページを作成するために開発された言語です。世の中に公開されているWebページのほとんどがHTMLで作成されています。こちらのサイトもHTMLで作成されています。
HTMLは基本的に以下のような構成でできており「<タグ名>★テキスト★</タグ名>」が1つの要素(エレメント)になります。この中の特定の要素に対してデータの取得や操作を行っていきます。
<html>
<head>
<title>VBAのIE制御</title>
</head>
<body>
<p>こちらはpタグのテキストです。</p>
<a href="★リンクURL★">リンクのアンカーテキストです。</a>
</body>
</html>
タグと要素(エレメント)の違い
HTML言語では、「タグ」と呼ばれる仕組みを利用して構築していきます。以下のイメージを確認すると分かりやすいと思いますが、タグとは「<」と「>」で構成されており、開始タグと終了タグまでの括りで1つの要素を形成します。
具体例で説明するとWebページのタイトルを表す「titleタグ」を利用して開始タグの「<title>」と終了タグの「</title>」で括り、タグの中の文字列が「要素内容」となります。こちらでは「VBAのIE制御入門」の文字列が要素内容となります。
そして、こちらの「開始タグ+要素内容+終了タグ」の全体を「要素」と呼びます。また、別名では「エレメント」と呼ばれますので、どちらも同じ意味であることを理解してください。
利用するサブルーチン・プロパティ・VBA関数について
今回利用するサブルーチン・プロパティ・VBA関数は以下になります。
- ieViewサブルーチン
- ieCheckサブルーチン
- Documentプロパティとは
- Imagesプロパティとは
- outerHTMLプロパティとは
- srcプロパティとは
- namePropプロパティとは
- altプロパティとは
- Widthプロパティとは
- Heightプロパティとは
- MsgBox関数プロパティとは
ieViewサブルーチンとは
ieViewサブルーチンは指定したURLをInternetExplorerで起動させ、Webページが完全に読み込まれるまで待機処理をするマクロです。
ieCheckサブルーチンとは
ieCheckサブルーチンは指定したInternetExplorerオブジェクトのWebページが完全に読み込まれるまで待機処理をするマクロです。
Documentプロパティとは
InternetExplorerオブジェクトのDocumentプロパティはHTMLドキュメントのオブジェクトを返すプロパティです。これによりHTMLドキュメントを操作することができます。
Imagesプロパティとは
DocumentオブジェクトのImagesプロパティはHTMLドキュメント内の画像要素オブジェクトのコレクションを返すメソッドです。
outerHTMLプロパティとは
要素オブジェクトのouterHTMLプロパティは指定した要素オブジェクトの要素タグとその中に含まれるHTMLコードを取得するプロパティです。
赤文字がpタグのouterHTMLの取得範囲になります。
<p>pタグの<span class="colorRed">outerHTML</span>の取得範囲</p>
srcプロパティとは
Imagesオブジェクトのsrcプロパティは指定した画像要素の画像URLを取得するプロパティです。
objIE.document.images(添え字).src = "設定する画像URL"
namePropプロパティとは
ImagesオブジェクトのnamePropプロパティは指定した画像要素の画像ファイル名を取得するプロパティです。
altプロパティとは
Imagesオブジェクトのaltプロパティは指定した画像要素のalt属性の値を取得するプロパティです。
objIE.document.images(添え字).alt = "設定するalt属性の値"
Widthプロパティとは
ImagesオブジェクトのWidthプロパティは指定した画像要素の幅の値を取得するプロパティです。
objIE.document.images(添え字).Width = "設定する画像の幅"
Heightプロパティとは
ImagesオブジェクトのHeightプロパティは指定したた画像要素の高さの値を取得するプロパティです。
objIE.document.images(添え字).Height = "設定する画像の高さ"
MsgBox関数とは
MsgBox関数はダイアログボックスにメッセージとボタンを表示し、どのボタンが押されたかを示す整数型の数値を返します。
指定した画像要素オブジェクトデータを連想配列に格納する処理の流れ
以下が今回の処理の流れになります。
- ①変数宣言
- ②ieViewサブルーチンを利用して指定したURLをIEで起動
- ③HTMLドキュメントのオブジェクトを取得
- ④HTMLドキュメント内のimg要素コレクションを取得
- ⑤コレクションの中から特定のimg要素オブジェクトを取得
- ⑥特定のimg要素オブジェクトのデータを連想配列に格納
- ⑦メッセージボックスに格納したデータを表示
指定した画像要素オブジェクトデータを連想配列に格納するサンプルコード
こちらのVBAコードは、IE(InternetExplorer)の指定した画像要素オブジェクトデータを連想配列に格納するマクロです。
Sub sample()
Dim objIE As InternetExplorer
Dim arrImg As Collection
Set arrImg = New Collection
'本サイトをIE(InternetExplorer)で起動
Call ieView(objIE, "http://www.vba-ie.net/library/index.html")
With objIE.document.images(0)
arrImg.Add .src, "src" '画像URL
arrImg.Add .nameProp, "nameProp" '画像ファイル名
arrImg.Add .alt, "alt" 'alt属性
arrImg.Add .Width, "width" 'width属性
arrImg.Add .Height, "height" 'height属性
End With
'①画像URLを抽出する
MsgBox arrImg("src")
'②画像ファイル名を抽出する
MsgBox arrImg("nameProp")
'③alt属性を抽出する
MsgBox arrImg("alt")
'④width属性を抽出する
MsgBox arrImg("width")
'⑤height属性を抽出する
MsgBox arrImg("height")
End Sub
連想配列に格納する要素のHTMLコード
<img src="/img/vbaproject.png" alt="VBAの参照設定" width="400" height="275" />
解説
Sub sample()
Dim objIE As InternetExplorer
Dim arrImg As Collection
こちらはSubステートメントに引数の設定がないsampleプロシージャになります。 まずは、変数宣言でメモリ領域を割り当てるDimステートメントを利用してオブジェクト変数objIEに「InternetExplorer型」を、オブジェクト変数arrImgに「Collection型」を変数宣言しています。
エクセルVBAで連想配列を作成する場合はCollectionオブジェクトを利用しますので、オブジェクト変数arrImgは「Collection型」で宣言しています。
Set arrImg = New Collection
こちらでは、オブジェクトを参照するSetステートメントを利用してオブジェクト変数arrImgにCollectionオブジェクトを生成しています。こちらで記述しなくても宣言時に以下のように記述することもできますので、覚えておきましょう。
Dim arrImg As New Collection
'本サイトをIE(InternetExplorer)で起動
Call ieView(objIE, "http://www.vba-ie.net/library/index.html")
次に他のプロシージャを呼び出すCallステートメントを利用してieViewサブルーチンを呼び出しています。第一引数にはオブジェクト変数の「objIE」を第二引数には表示させるURLの「http://www.vba-ie.net/library/index.html」を設定しています。これによりInternetExplorerで本サイトの「IE制御の準備(ライブラリ追加)ページ」が表示されます。
With objIE.document.images(0)
arrImg.Add .src, "src" '画像URL
arrImg.Add .nameProp, "nameProp" '画像ファイル名
arrImg.Add .alt, "alt" 'alt属性
arrImg.Add .Width, "width" 'width属性
arrImg.Add .Height, "height" 'height属性
End With
ここからはImagesプロパティを利用して指定したimg要素を取得して連想配列に格納する部分になります。以下は理解しやすい様にVBAコードとキーワードの関連性を列挙したものです。あくまで関連性ですので必ずしも「=(イコール)」ではありません。
- 【objIE.document.images(0)】
- objIE = InternetExplorerオブジェクト
- document = HTMLドキュメントのオブジェクト(Documentオブジェクト)
- images = HTMLドキュメント内のすべてのimg要素(Imagesプロパティ)
- images(0) = img要素コレクションの1番目のimg要素オブジェクト
まず、1つのオブジェクトに対して処理をまとめるWithステートメントのオブジェクト名に「objIE.document.images(0)」を設定しています。
こちらはInternetExplorerオブジェクトのdocumentプロパティを利用してHTMLドキュメントのオブジェクト(Documentオブジェクト)を取得します。
次にすべてのimg要素を取得するDocumentオブジェクトのImagesプロパティを利用してすべてのimg要素を取得します。この要素コレクションから1番目のimg要素オブジェクトを取得しますが、1番目のimg要素オブジェクトとは「images(0)」の部分で、括弧内の数字(添え字)は「0」から数えるため、1番目のimg要素オブジェクトの添え字は「0」となります。
img要素を取得できたら次は連想配列に格納していきます。連想配列に格納する場合はCollectionオブジェクトのAddメソッドを利用します。利用方法については以下のような形で記述していきます。
arrImg.Add 配列に格納する要素, キー
今回は、srcプロパティを利用して画像URLを、altプロパティを利用してalt属性の値を、Widthプロパティを利用して画像の幅を、Heightプロパティを利用して画像の高さを連想配列に格納しています。
'①画像URLを抽出する
MsgBox arrImg("src")
'②画像ファイル名を抽出する
MsgBox arrImg("nameProp")
'③alt属性を抽出する
MsgBox arrImg("alt")
'④width属性を抽出する
MsgBox arrImg("width")
'⑤height属性を抽出する
MsgBox arrImg("height")
こちらでは、連想配列に格納したそれぞれデータをキーで指定してメッセージボックスに表示させています。
まとめ
今回は、Collectionオブジェクトを利用して特定のimg要素データを連想配列に格納する方法について解説していきます。一度連想配列に格納すれば自由に利用することができますのでとても便利です。次回は、特定のimg要素データを連想配列に格納するサブルーチンの作成について解説していきます。
次の記事: エクセルVBAで特定のimg要素データを連想配列に格納するサブルーチン >>
近田 伸矢, 植木 悠二, 上田 寛
IEのデータ収集&自動操作のプログラミング本はこの1冊だけ!IEの起動やポップアップウィンドウ、表示を制御する基本的なコードはもちろん、テキストボックスやラジオボタン、表、ハイパーリンクなどのHTML部品を制御する方法など、自動操作に欠かせないノウハウを丁寧に解説。