InternetExplorerオブジェクトのdocument.readyStateプロパティ

document.ReadyStateプロパティはHTMLDocumentオブジェクトのドキュメントの読み込み状態を示します。InternetExplorerの状態をチェックするのに利用するとより安全に処理を行うことができます。こちらでは、その点も含めて解説しています。

目次

スポンサー リンク

document.ReadyStateプロパティとは

document.ReadyStateプロパティはHTMLDocumentオブジェクトのドキュメントの読み込み状態を示します。読み込み状態は4段階で、文字列で返す点にご注意ください。こちらもWebページの完全読み込み待機処理で利用します。

objIE.document.readyState = "uninitialized"/"loading"/
"interactive"/"complete"
変数 = objIE.document.readyState

構文object.document.readyState
引数省略説明
object×表示させるIEオブジェクトの名前を指定します。

戻り値

戻り値説明
"uninitialized"デフォルト値。読み込み開始前。
"loading"documentオブジェクトの読み込み中。
"interactive"documentオブジェクトの読み込み中で操作可能。
"complete"documentオブジェクトの読み込み完了。

Webページの完全読込待機処理をするサンプルコード

Sub sample()

  Dim objIE As InternetExplorer

  'IE(InternetExplorer)のオブジェクトを作成する
  Set objIE = CreateObject("InternetExplorer.Application")

  'IE(InternetExplorer)を表示する
  objIE.Visible = True

  '指定したURLのページを表示する
  objIE.navigate "http://www.vba-ie.net/"

  '完全にページが表示されるまで待機する
  Do While objIE.Busy = True Or objIE.readyState <> 4
    DoEvents
  Loop

  '完全にドキュメントが読み込まれるまで待機する
 Do Until objIE.document.ReadyState = "complete"
  DoEvents
 Loop

End Sub

実行結果

「VBAのIE制御」サイトのトップページが表示されます。

VBAのIE制御サイト画面

解説

Sub sample()
 Dim objIE As InternetExplorer

sampleのSubステートメントは引数の設定なしです。次に、Dimステートメントを利用して変数objIEをInternetExplorer型で宣言します。


'IE(InternetExplorer)のオブジェクトを作成する
Set objIE = CreateObject("InternetExplorer.Application")

SetステートメントCreateObject関数を利用してIEのオブジェクトを作成します。オブジェクト作成によりプロパティやメソッドを利用することができます。


'IE(InternetExplorer)を表示する
objIE.Visible = True

VisibleプロパティTrueを設定することで、ブラウザを表示させます。


'指定したURLのページを表示する
objIE.Navigate "http://www.vba-ie.net/"

Navigateメソッドの第一引数に「http://www.vba-ie.net/」を設定しています。これにより「VBAのIE制御」サイトのトップページが表示されます。


'完全にページが表示されるまで待機する
Do While objIE.Busy = True Or objIE.ReadyState <> 4
 DoEvents
Loop

こちらは、Do...Loop ステートメントを利用して、ページが完全に読み込まれるまでループさせる処理を行っています。
それぞれのプロパティでWebページが完全に読み込まれた場合の戻り値は、BusyプロパティFalseReadyStateプロパティ4になりますので、たとえBusyプロパティでFalseになったとしてもReadyStateプロパティが4でない場合はループから抜け出すことはできません。
こちらを抜け出すためには、BusyプロパティReadyStateプロパティ両方が完全に読み込み完了状態になった場合のみとなります。
ということは、ページが完全に読み込まれるまで次の処理へ移動せず待機するということになります。
ちなみにDoEvents関数を設定しているのでは、無限ループに陥った場合に制御を戻しておくためです。


'完全にドキュメントが読み込まれるまで待機する
Do Until objIE.document.ReadyState = "complete"
 DoEvents
Loop

こちらも、Do...Loop ステートメントを利用して、ドキュメントが完全に読み込まれるまでループさせる処理を行っています。objIEオブジェクトのReadyStateプロパティは読み込み完了時に4を返しますが、HTMLDocumentオブジェクトのReadyStateプロパティは"complete"を返します。
どのオブジェクトのReadyStateプロパティかによって戻り値が異なりますので注意が必要です。ここでは、"complete"を返したときにループ処理を抜けるような処理をしています。


End Sub

最後はEndステートメントを利用してsampleプロシージャを終了させます。

利用されているコンテンツ

ReadyStateプロパティは、IE(InternetExplorer)を表示させるには必須のプロパティになります。ほとんどのコンテンツで利用されていますので、ここでは代表的なコンテンツを紹介します。

InternetExplorerオブジェクトのプロパティ

プロパティデータ型内容
ApplicationObjectアプリケーションオートメーションオブジェクトにアクセス可能であれば、そのオートメーションオブジェクトを返す。
VisibleBooleanアプリケーションの表示・非表示を設定します。
BusyBooleanWebページが読み込み中かどうかを示す。
ReadyStatetagREADYSTATEIEオブジェクトのドキュメントの読み込み状態を示します。
document.readyStatetagREADYSTATEIEのdocumentオブジェクトの読み込み状態を示します。
TopLongInternetExplorerウィンドウの垂直位置(ピクセル)を設定します。
LeftLongInternetExplorerウィンドウの水平位置(ピクセル)を設定します。
WidthLongInternetExplorerウィンドウの幅(ピンクセル)を設定します。
HeightLongInternetExplorerウィンドウの高さ(ピンクセル)を設定します。
AddressBarBooleanアドレスバーを表示・非表示させます。
MenuBarBooleanメニューバーを表示・非表示させます。
StatusBarBooleanステータスバーを表示・非表示させます。
ToolBarLongツールバーが表示されているのを制御します。
FullScreenBooleanウィンドウを最大化し、ステータスバー、ツールバー、メニューバー、およびタイトルバーを非表示にします。
TheaterModeBooleanInternetExplorerのシアターモードを設定します。
ResizableBooleanウィンドウサイズ変更の可否を設定します。
OfflineBoolean設定またはオブジェクトがオフラインモードで動作しているかどうかを示す値を取得します。
RegisterAsBrowserBoolean設定またはオブジェクトは、トップレベルのブラウザウィンドウとして登録されているかどうかを示す値を取得します。
RegisterAsDropTargetBoolean設定またはオブジェクトはナビゲーションのためのドロップターゲットとして登録されているかどうかを示す値を取得します。
SilentBoolean任意のダイアログボックスを表示することかどうかを設定する。
TopLevelContainerBoolean指定したオブジェクトがトップレベルのオブジェクトである場合にTrueを返します。
HWNDLong指定したInternetExplorerのHWNDを返します。
ContainerObjectコンテナ/親へのオブジェクト参照を取得します。
DocumentObject指定したドキュメントを返します。
ParentObjectコンテナ/親が存在する場合は、そのオートメーションオブジェクトのオートメーションオブジェクトを返します。
PathStringInternetExplorerアプリケーションのフォルダパスを返します。
FullNameStringInternetExplorerアプリケーションのファイルパスを返します。
NameStringアプリケーションの名前を返します。
LocationNameString指定したページのタイトルを取得します。
LocationURLString指定したページのURLを取得します。
StatusTextStringステータスバーのテキストを取得します。
TypeString含まれているドキュメントオブジェクトの型を返します。
Excel VBAでIEを思いのままに操作できるプログラミング術 Excel 2013/2010/2007/2003対応

近田 伸矢, 植木 悠二, 上田 寛

IEのデータ収集&自動操作のプログラミング本はこの1冊だけ!IEの起動やポップアップウィンドウ、表示を制御する基本的なコードはもちろん、テキストボックスやラジオボタン、表、ハイパーリンクなどのHTML部品を制御する方法など、自動操作に欠かせないノウハウを丁寧に解説。

VBAのIE制御についてのQ&A掲示板

↑エクセルVBAのIE(InternetExplorer)操作で分からない事があればこちらの掲示板よりご質問ください^^

ExcelのVBA初心者入門

↑こちらはExcelのVBAをマスターできるよう初心者向けのエクセルVBA入門コンテンツになります^^

VBAのIE制御入門RSS

RSSフィードを登録すると最新記事を受け取ることができます。

VBAIE操作のスカイプレッスン

VBAでIE(InternetExplorer)制御の準備

【ダウンロード】IE操作に便利なツール

こちらでは、これまでに紹介したIE(InternetExplorer)操作で便利な機能をツール化しています。無償でダウンロードできますので、目的に合わせたご利用ください。

IEオブジェクトのメソッド・プロパティ

こちらでは、IE(InternetExplorer)オブジェクトのメソッド・プロパティをまとめています。

IE操作に利用されているVBA関数

こちらでは、エクセルVBAのIE(InternetExplorer)操作で利用されたVBA関数をまとめています。

IE操作に利用されているステートメント

こちらでは、エクセルVBAのIE(InternetExplorer)操作で利用されたステートメントをまとめています。ExcelのVBAで基本的な部分になりますので、しっかり理解しましょう。

IE(InternetExplorer)制御のVBAコード

こちらでは、これまでに作成したIE(InternetExplorer)操作で役立つサブルーチンをまとめています。
全てをコピーする必要はありませんが、目的に合わせたサブルーチンをご利用ください。