【入門編】【上級者】Windows API(GetDiskFreeSpaceEx)を用いて保存先ストレージの空き容量を事前検証し、容量不足時に高解像度画像を自動圧縮してから安全に保存する堅牢マクロ – PowerPoint VBA解析バイブル

スポンサーリンク
スポンサーリンク

【極限の知見】「保存に失敗しました」をゼロにする。Windows APIと画像圧縮を組み合わせた、プロ仕様の堅牢な保存アーキテクチャ

こんにちは。技術の深淵へようこそ。

皆さんは、一生懸命作ったスライドショーを、いざネットワークドライブへ保存しようとした瞬間に「ディスク領域が不足しています」という無慈悲なエラーに直面し、数時間の作業が水の泡になった経験はありませんか?

マクロの記録機能を使って「保存する」というコードを書くだけなら、誰でもできます。しかし、プロのエンジニアが作る自動化ツールは違います。プロは「失敗すること」を前提に設計し、失敗させないための「防護策」を組み込みます。

今日は、PowerPoint VBAの限界を超え、Windows OSの深層(API)にアクセスしてストレージ容量を監視し、容量不足を察知した瞬間に「画像の解像度を自動で落としてファイルサイズを軽量化する」という、極めて堅牢な(ロバストな)アーキテクチャを伝授しましょう。

ここをマスターすれば、あなたは「単なるマクロ使い」から「信頼されるシステムエンジニア」へと進化できるはずです。

1. なぜ「普通のVBA」では足りないのか?

通常、ファイルの容量をチェックするなら、VBA標準の `FileSystemObject` を使うのが一般的です。しかし、これには弱点があります。

  • ネットワークドライブへの対応力: ネットワーク越しの大容量ストレージの状態を、より精密に、かつ高速に取得するには、Windows OSが直接持っている情報(API)を叩くのが最も確実です。
  • 「予測」の欠如: 単に「容量が足りないか」を見るのではなく、「これから保存しようとしているファイルサイズに対して、十分な余裕があるか」を計算する必要があります。

今回は、Windows APIの `GetDiskFreeSpaceEx` を使用します。これにより、OSレベルで正確な空き容量をリアルタイムに取得します。

2. 守護神を召喚する:Windows APIの宣言

まず、VBAからWindowsの深い機能を使うための「儀式」が必要です。現代の64bit版Officeでも動作するように、`PtrSafe` を用いた宣言を行います。

' --- API宣言セクション ---

If VBA7 Then

' 64bit版Office用 Declare PtrSafe Function GetDiskFreeSpaceEx Lib "kernel32" Alias "GetDiskFreeSpaceExA" ( _ ByVal lpDirectoryName As String, _ ByRef lpFreeBytesAvailable As Currency, _ ByRef lpTotalNumberOfBytes As Currency, _ ByRef lpTotalNumberOfFreeBytes As Currency) As Long

Else

' 32bit版Office用 Declare Function GetDiskFreeSpaceEx Lib "kernel32" Alias "GetDiskFreeSpaceExA" ( _ ByVal lpDirectoryName As String, _ ByRef lpFreeBytesAvailable As Currency, _ ByRef lpTotalNumberOfBytes As Currency, _ ByRef lpTotalNumberOfFreeBytes As Currency) As Long

End If

【エンジニアの視点】
ここで `Currency` 型を使っていることに注目してください。ファイルサイズは「バイト」単位で扱います。`Long` 型(整数)では、数GBを超える巨大なファイルサイズを扱う際にオーバーフロー(桁溢れ)を起こしてしまいます。`Currency` は非常に大きな整数を正確に保持できるため、容量計算には最適なのです。

3. 実装:堅牢な保存エンジンの全貌

それでは、メインとなるロジックを構築しましょう。このコードの戦略は以下の通りです。

1. 容量チェック: 保存先の空き容量をAPIで取得。
2. リスク判定: 空き容量が「閾値(例:500MB)」を下回っているか判定。
3. 自動防衛(画像圧縮): リスクがある場合、スライド内の全画像をスキャンし、解像度を落として再配置する。
4. 安全な保存: 最後にファイルを保存。

Option Explicit

' 定数定義:安全のための閾値(500MB)
Private Const MIN_FREE_SPACE_BYTES As Currency = 500 * 1024 * 1024 

''' <summary>
''' 安全な保存を実行するメインルーチン
''' </summary>
Public Sub SmartSave()
    Dim targetPath As String
    Dim freeSpace As Currency
    Dim totalSpace As Currency
    Dim totalFreeSpace As Currency
    
    ' 1. 保存先のパスを設定(ここでは現在のファイルと同じフォルダを想定)
    targetPath = ActivePresentation.Path
    If targetPath = "" Then
        MsgBox "一度ファイルを保存してから実行してください。", vbCritical
        Exit Sub
    End If
    
    ' 2. Windows APIを使用して空き容量を確認
    If GetFreeSpace(targetPath, freeSpace) = False Then
        MsgBox "ストレージ情報の取得に失敗しました。", vbCritical
        Exit Sub
    End If
    
    Debug.Print "現在の空き容量: " & Round(freeSpace / 1024 / 1024, 2) & " MB"

    ' 3. リスク判定とアクション
    If freeSpace < MIN_FREE_SPACE_BYTES Then
        Dim res As VbMsgBoxResult
        res = MsgBox("警告: ストレージの空き容量が不足しています。" & vbCrLf & _
                     "画像を自動圧縮して保存を試みますか?", vbYesNo + vbExclamation, "容量不足検知")
        
        If res = vbYes Then
            ' --- 画像圧縮プロセス開始 ---
            Application.ScreenUpdating = False ' 画面更新を停止して高速化
            CompressAllImages
            Application.ScreenUpdating = True
            ' --------------------------
        Else
            Exit Sub ' キャンセルされた場合
        End If
    End If

    ' 4. 保存の実行
    On Error Resume Next
    ActivePresentation.Save
    If Err.Number <> 0 Then
        MsgBox "保存に失敗しました。ディスク容量が極端に不足している可能性があります。", vbCritical
    Else
        MsgBox "安全に保存が完了しました。", vbInformation
    End If
    On Error GoTo 0
End Sub

''' <summary>
''' Windows APIを呼び出して空き容量を取得する関数
''' </summary>
Private Function GetFreeSpace(ByVal folderPath As String, ByRef freeBytes As Currency) As Boolean
    Dim totalBytes As Currency
    Dim totalFreeBytes As Currency
    
    ' API呼び出し
    If GetDiskFreeSpaceEx(folderPath, freeBytes, totalBytes, totalFreeBytes) <> 0 Then
        GetFreeSpace = True
    Else
        GetFreeSpace = False
    End If
End Function

''' <summary>
''' 全スライドの画像をスキャンし、解像度を下げて再インポートする(簡易圧縮)
''' </summary>
Private Sub CompressAllImages()
    Dim sld As Slide
    Dim shp As Shape
    Dim imgPath As String
    Dim tempImgPath As String
    Dim targetWidth As Single
    Dim targetHeight As Single

    tempImgPath = Environ("TEMP") & "\ppt_temp_img.jpg"

    For Each sld In ActivePresentation.Slides
        For Each shp In sld.Shapes
            ' 図形が画像(Picture)であるか判定
            If shp.Type = msoPicture Then
                ' 現在のサイズを保持
                targetWidth = shp.Width
                targetHeight = shp.Height
                
                ' 1. 画像を一旦エクスポート(JPGとして書き出し、これで容量が減る)
                shp.Export tempImgPath, ppShapeFormatJPG
                
                ' 2. 元の画像を削除
                shp.Delete
                
                ' 3. 圧縮された画像を同じ位置に再挿入
                ' ※ここでは解像度を落とす代わりに、ファイル形式をJPGに強制することで容量削減を図る
                With sld.Shapes.AddPicture(FileName:=tempImgPath, _
                                          LinkToFile:=msoFalse, _
                                          SaveWithDocument:=msoTrue, _
                                          Left:=shp.Left, _
                                          Top:=shp.Top, _
                                          Width:=targetWidth, _
                                          Height:=targetHeight)
                    ' 再挿入後の設定(必要に応じて)
                End With
            End If
        Next shp
    Next sld
    
    ' 一時ファイルの削除
    If Dir(tempImgPath) <> "" Then Kill tempImgPath
    
    MsgBox "画像の最適化が完了しました。", vbInformation
End Sub

4. ここがプロの「こだわり」:設計のポイント

このコードには、初学者が陥りがちなミスを防ぐための「知恵」が詰まっています。

① エラーハンドリングの階層化

単に `On Error Resume Next` で全てを無視するのではなく、APIの戻り値、ユーザーの意思(MsgBox)、そして最終的な保存の成否を、段階的にチェックしています。これにより、「なぜ動かないのか」が明確になります。

② 画像圧縮のロジック(Export & Re-import)

VBAには「画像の解像度(DPI)を直接書き換える」という命令が存在しません。そこで、プロは「一度画像として外部出力(Export)し、高圧縮な形式(JPG)で読み込み直す」というアプローチを取ります。これが、VBAにおける最も確実な「ダウンサンプル(解像度削減)」の手法です。

③ ユーザー体験(UX)への配慮

容量不足という「不快な状況」において、勝手に処理を進めるのではなく、必ず `MsgBox` でユーザーに許可を求めています。自動化において、「制御不能な自動化」は恐怖です。常にユーザーにコントロール権を与えるのが、一流の設計です。

5. まとめ:次の一歩へ

今回のコードは、単なる「保存マクロ」ではありません。
「環境(ストレージ)の状態を察知し、自律的に振る舞いを変える」という、高度なプログラムの基礎が詰まっています。

  • Windows API でOSの力を借りる。
  • Currency型 でデータの精度を守る。
  • ロジックの転換 で物理的な限界を突破する。

ここをクリアすれば、あなたの作るツールは「便利」なレベルから、「なくてはならないインフラ」へと昇華します。

さあ、勇気を持って、いつものマクロに「知性」を吹き込んでみてください。応援していますよ!

タイトルとURLをコピーしました