AcroExch.App: ToolButtonIsEnabled メソッド

TOP > AcroExch.App > ToolButtonIsEnabled      [...]


説明

Acrobatアプリケーションの指定されたツールボタンが 使用可能状態(=Enable) かをチェックします。

ツールボタンを使用可能状態にするにはSetActiveToolメソッドを使用します。

形式

VARIANT_BOOL ToolButtonIsEnabled(BSTR szButtonName);

引数

  1. 第1引数(BSTR szButtonName):
    ツールバーのボタン名。
    Acrobat:Menu and Toolbar Button Names 一覧」を参照。

戻り値

  • -1 : True(真)で成功。
    使用可能状態(アクティブ)に成っている。
  • 0 : False(偽)で失敗。理由は以下の3つの内の一つ。
    存在しないツール名を指定した。
    使用可能状態で無いツール名を指定した。

動作するバージョン

VersionAdobe
Acrobat
備考
4OKAcrobat 4.0    ※Windows 98SE + Excel 2000
5
OK
Acrobat 5.0.5
6
OK
Acrobat 6.0.3 Pro
7OKAcrobat 7.0.9 Pro
Acrobat 7.1.4 Pro
8OKAcrobat 8.2.2 Pro
9OKAcrobat 9.3.2 Extended
10-Acrobat X (10.1.8) Extended
11-Acrobat XI (11.0.04) Extended
  • OK = 動作する。
  • NO = 動作しない。
  • - = 未確認。

サンプル:Excel のVBA

説明:PDFファイルのツールボタンが使用可能状態かをチェックする。

  • 参照設定をする。
  • F8キーでステップ実行しながら動作確認する。 
001 Sub AcroExch_App_ToolButtonIsEnabled() 002 003 'Acrobatオブジェクトの定義&作成 004 'Acrobat 4,5,6 の時 005 ' Dim objAcroApp As Acrobat.CAcroApp 006 ' Set objAcroApp = CreateObject("AcroExch.App") 007 008 'Acrobat 7,8,9,10,11 の時 009 Dim objAcroApp As New Acrobat.AcroApp 010 011 '以降はAcrobat全て共通 012 Dim lRet As Long '戻り値 013 'Const CON_TOOL_NAME = "Select" '「矢印」又は「選択」 014 'Const CON_TOOL_NAME = "Hand" '「手」 015 Const CON_TOOL_NAME = "Open" '「開く」 016 017 'Acrobatを起動表示する 018 'lRet = objAcroApp.Show 019 020 '使用可能なツールのボタン名をチェックする 021 lRet = objAcroApp.ToolButtonIsEnabled(CON_TOOL_NAME) 022 MsgBox CON_TOOL_NAME & "=" & lRet 023 024 'アプリケーションの終了 025 'lRet = objAcroApp.Hide 026 'lRet = objAcroApp.Exit 027 028 'オブジェクトの強制開放 029 Set objAcroApp = Nothing 030 031 End Sub


 Highlight:プログラミング言語のソースコードを構文で色分け (GUI編)
 

補足

  • 引数はツールボタンの名前を指定します。
    例:ZoomIn , ZoomOut , etc.
  • 存在しないツールボタンの名前を指定すると戻り値は偽(False=0)、存在するツールボタンの名前を指定すると戻り値は真(True=-1)がセットされます。
  • 英語版PDF解説にはツールボタンの名前(toolbar button Name)の一覧が見当たらない。
  • Acrobat:Menu and Toolbar Button Names 一覧」に各ボタンの名称がありますが、どのボタンに相当するかは随時追加中。
  • Acrobatプリケーションを画面表示しなくてもチェックは出来ます。
    但しPDFドキュメントを表示してチェックする方がより正確なチェックが出来ます。

動作確認環境

  • Windows98SE( + WindowsUpdate) +
    Acrobat 4.0 + Office 2000
  • WindowsXP Pro( + SP3 + WindowsUpdate) +
    Acrobat 5.0.5  + Office 2003( + SP3)
  • WindowsXP Pro( + SP3 + WindowsUpdate) +
    Acrobat 6.0.3 Pro + Office 2003( + SP3)
  • WindowsXP Pro( + SP2 + WindowsUpdate) +
    Acrobat 7.0.9 Pro + Office 2003
  • WindowsXP Pro( + SP3 + WindowsUpdate) +
    Acrobat 7.1.4 Pro + Office 2003( + SP3)
  • WindowsXP Pro( + SP3 + WindowsUpdate) +
    Acrobat 8.2.2 Pro + Office 2003( + SP3)
  • WindowsXP Pro( + SP3 + WindowsUpdate) +
    Acrobat 9.3.2 Extended + Office 2003( + SP3) 

Adobe Web 解説 URL(英語) v9.1

http://livedocs.adobe.com/acrobat_sdk/9.1/Acrobat9_1_HTMLHelp/IAC_API_OLE_Objects.103.29.html

戻る


キーボード

ブラウザ画面の文字サイズを変更するショートカットキー

  1. [ CTRL ] + [ + ]  :  文字を大きく

  2. [ CTRL ] + [ - ]  :  文字を小さく
Shortcut Keys

  1. [ CTRL ] + [ + ]  :  Up the font size

  2. [ CTRL ] + [ - ]  :  Down the font size

コメントを残す

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です

CAPTCHA


出来るだけ早く返答する様には心がけています。
が、遅くなる時もありますのでご了承ください。


SAMURAI Plugin

コメントをする時は出来れば以下もお願いします。

  • OS名 バージョン
  • Acrobat バージョン
  • ツール(Excel等) バージョン
コメントにサンプルコードを入れるとエラーになる場合が有ります。その時はコードの前後に <code> ・・・</code> タグを入れてください。

このサイトはスパムを低減するために Akismet を使っています。コメントデータの処理方法の詳細はこちらをご覧ください