【極限の知見】「保存に失敗しました」をゼロにする。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型 でデータの精度を守る。
- ロジックの転換 で物理的な限界を突破する。
ここをクリアすれば、あなたの作るツールは「便利」なレベルから、「なくてはならないインフラ」へと昇華します。
さあ、勇気を持って、いつものマクロに「知性」を吹き込んでみてください。応援していますよ!
