ショートカットを作る

最終更新 2003 10/10

サンプルのダウンロード → Exp_CreateShortCut.lzh(39k)

全ソースコード
#include <windows.h> #include <shlobj.h> #include <commdlg.h> #pragma comment( lib, "shell32.lib" ) #pragma comment( lib, "comdlg32.lib" ) //クラス名定義 #define CLASS_NAME "Make ShortCut Sample" //OPENFILENAME 構造体用のフラグ #define OPEN_DIALOG_FLAGS OFN_FILEMUSTEXIST | OFN_HIDEREADONLY | OFN_NOCHANGEDIR | OFN_NONETWORKBUTTON | OFN_PATHMUSTEXIST | OFN_READONLY //ShowOpenDialog 関数の引数に使う構造体 typedef struct tagOpenDialog { char path[ MAX_PATH + MAX_PATH ]; char name[ MAX_PATH ]; LPSTR pDefaultExt; LPSTR pFilter; LPSTR pTitle; int filterIndex; } OPENDIALOG; //プロトタイプ宣言 LRESULT CALLBACK WinProc( HWND, UINT, WPARAM, LPARAM ); BOOL CreateShortCut( LPSTR, LPSTR, LPSTR, LPSTR, LPSTR ); BOOL OpenFolderDialog( HWND, char*, LPCSTR ); BOOL ShowOpenDialog( OPENDIALOG* ); //メイン int WINAPI WinMain( HINSTANCE hInstance, HINSTANCE hPrevInstane, LPSTR lpCmdLine, int nShowCmd ) { //ショートカットを作るファイルを選択 OPENDIALOG open; { open.pDefaultExt = NULL; open.pTitle = "ショートカットを作成するファイルを選択"; open.pFilter = "すべてのファイル\0*.*\0"; open.filterIndex = 1; if( !ShowOpenDialog( &open ) ) return 1; } //ショートカットを作成するフォルダを選択 char shortCutPath[ MAX_PATH ]; { ZeroMemory( shortCutPath, sizeof( shortCutPath ) ); if( !OpenFolderDialog( NULL, shortCutPath, "ショートカットを作成するフォルダを選択" ) ) return 1; } //ショートカットのファイル名作成 char shortCutPathName[ MAX_PATH ]; { ZeroMemory( shortCutPathName, sizeof( shortCutPathName ) ); wsprintf( shortCutPathName, "%s\\ショートカットのテスト.lnk", shortCutPath ); } //ショートカット作成 if( !CreateShortCut( shortCutPathName, open.path, NULL, NULL, NULL ) ) return 1; //結果表示 { char text[MAX_PATH + 100]; wsprintf( text, "%s\n以上のフォルダに\n%s\nのショートカットを作成しました。", shortCutPath, open.path ); MessageBox( NULL, text, "ショートカット作成", MB_OK ); } return 0; } //メッセージの対応 LRESULT CALLBACK WinProc( HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam ) { return DefWindowProc( hWnd, uMsg, wParam, lParam ); } /* CreateShortCut 関数 　ショートカットを作成する 引数 lpszShortCutPath = 作成するショートカットの .lnk までのパスを含むファイル名 lpszTargetPath = ショートカットを作成するファイルのパス lpszWorkFolderPath = 作業フォルダのパス lpszDescription = ファイルの内容を格納した文字列の先頭ポインタ lpszArgs = コマンドライン文字列の先頭ポインタ 戻り値 関数成功時 = TRUE 関数失敗時 = FALSE */ BOOL CreateShortCut( LPSTR pShortCutPath, LPSTR pTargetPath, LPSTR pWorkFolderPath, LPSTR pDescription, LPSTR pArgs ) { //COM 初期化 if( !SUCCEEDED( CoInitialize( NULL ) ) ) return FALSE; IShellLink* p_sl; //シェルリンクとやらをいじるためのオブジェクト IPersistFile* p_pf; //ファイルをいろいろいじるためのオブジェクト HRESULT hRes; //戻り値を受け取り用 //IShellLink オブジェクト生成 hRes = CoCreateInstance( CLSID_ShellLink, NULL, CLSCTX_INPROC_SERVER, IID_IShellLink, (void **)&p_sl ); if( SUCCEEDED( hRes ) ) { //IPersistFile がサポートされてるか調べる hRes = p_sl->QueryInterface( IID_IPersistFile, (void **)&p_pf ); if( SUCCEEDED( hRes ) ) { //ショートカットを作るファイルのパスをセット hRes = p_sl->SetPath( pTargetPath ); if( SUCCEEDED( hRes ) ) { //作成するショートカットの設定 p_sl->SetDescription( pDescription ); p_sl->SetArguments( pArgs ); p_sl->SetWorkingDirectory( pWorkFolderPath ); p_sl->SetIconLocation( pTargetPath, 0 ); p_sl->SetShowCmd( SW_NORMAL ); //ppf->Save() の最初の引数が Unicode しかサポートしてないので //lpszShortCutPath を Unicode に変換する WORD path[MAX_PATH]; MultiByteToWideChar( CP_ACP, 0, pShortCutPath, -1, path, MAX_PATH ); hRes = p_pf->Save( path, TRUE ); } } } //使用したオブジェクトを解放 p_sl->Release(); p_pf->Release(); CoUninitialize(); //COM 終了 return SUCCEEDED( hRes ); } /* OpenFolderDialog 関数 　フォルダを開くダイアログボックスを表示します。 　この関数を呼び出す前に char path[MAX_PATH]; のように char 型の配列を 　宣言しておきます。 引数 hWnd = 親ウィンドウのハンドル。 pPathName = 選択されたフォルダのパスを受け取る文字列用配列の先頭ポインタ。 pTitle = ダイアログボックスの上部に表示する文字。 戻り値 関数成功時 = TRUE 関数失敗時 = FALSE ダイアログボックスのキャンセルボタンがクリックされると pPathName に NULL が 格納されて関数はFALSEを返します。 */ BOOL OpenFolderDialog( HWND hWnd, char* pPathName, LPCSTR pTitle ) { //必要な変数を宣言 BROWSEINFO bri; //フォルダ選択ダイアログの設定用 LPITEMIDLIST lpid = NULL; //戻り値受け取り用 if( pTitle == NULL ){ pTitle = "フォルダを選択"; } //値を初期化 ZeroMemory( &bri, sizeof( BROWSEINFO ) ); ZeroMemory( pPathName, lstrlen( pPathName ) ); //値を設定 bri.hwndOwner = hWnd; bri.pidlRoot = NULL; bri.pszDisplayName = pPathName; bri.lpszTitle = pTitle; bri.ulFlags = BIF_RETURNONLYFSDIRS; bri.lpfn = NULL; bri.lParam = 0; bri.iImage = 0; //フォルダ選択ダイアログ表示 lpid = SHBrowseForFolder( &bri ); //値を受け取れたら if( lpid != NULL ) { if( SHGetPathFromIDList( lpid, pPathName ) ) //lpid からフォルダのパスを取得 { CoTaskMemFree( lpid ); //値を解放 return TRUE; } } return FALSE; } /* ShowOpenDialog ファイルを開くコモンダイアログを開く 引数 OPENDIALOG 型の構造体のポインタ。 この関数を呼ぶ前にあらかじめ宣言しておき、必要な値をメンバ関数にセットしておく。 戻り値 ファイルが選択され、正常に終了した = TRUE pOpenDialog の path には選択されたファイルの絶対パスが格納され name には選択されたファイルのパスを含まないファイル名が格納される。 キャンセルボタンが押されたか、正常に終了できなかった = FALSE */ BOOL ShowOpenDialog( OPENDIALOG *pOpenDialog ) { //引数チェック if( pOpenDialog->filterIndex < 1 ) pOpenDialog->filterIndex = 1; if( pOpenDialog->pFilter == NULL ) pOpenDialog->pFilter = "全てのファイル(*.*)\0*.*\0\0"; //ファイル名を受け取るための配列を初期化 ZeroMemory( pOpenDialog->path, sizeof( pOpenDialog->path ) ); ZeroMemory( pOpenDialog->name, sizeof( pOpenDialog->name ) ); //ファイルを開くダイアログの情報をセット OPENFILENAME open; ZeroMemory( &open, sizeof( OPENFILENAME ) ); //念のため０で初期化 open.Flags = OPEN_DIALOG_FLAGS; open.hInstance = NULL; open.hwndOwner = NULL; open.lCustData = 0; open.lpfnHook = 0; open.lpstrCustomFilter = NULL; open.lpstrDefExt = pOpenDialog->pDefaultExt; open.lpstrFile = pOpenDialog->path; open.lpstrFileTitle = pOpenDialog->name; open.lpstrFilter = pOpenDialog->pFilter; open.lpstrInitialDir = NULL; open.lpstrTitle = pOpenDialog->pTitle; open.lpTemplateName = NULL; open.lStructSize = sizeof( OPENFILENAME ); open.nFileExtension = 0; open.nFileOffset = 0; open.nFilterIndex = pOpenDialog->filterIndex; open.nMaxCustFilter = 0; open.nMaxFile = MAX_PATH + MAX_PATH; open.nMaxFileTitle = MAX_PATH; //ファイルを開くダイアログ表示 if( !GetOpenFileName( &open ) ) return FALSE; return TRUE; }

サンプルがかなり長いので CreateShortCut() 関数と WinMain() の中を中心に
見るだけでよいと思います。
他の部分は フォルダを選択するダイアログの表示とファイルを開く
ダイアログの表示を行っているだけです。これらは別の項で説明しています。
ここで見る必要はないでしょう。

ショートカットを作成する方法をいろいろ調べてみたのですが、ＣＯＭを
使った方法しか発見できませんでした。
ＣＯＭの詳しい仕組みは理解する必要はないと思います。
とりあえず、やり方だけ分かればあとはなんとかなります。
必要になったら専門書を読むなりして対応していけば良いと思います。
使い方は DirectX に良く似てますねぇ〜


【 準備 】

最初に shlobj.h をインクルードします。
念のため #pragma comment を使って shell32.lib をリンクするように
設定しています。


【 作業の流れ 】

作業の流れは

１．COM 初期化
２．IShellLinkオブジェクト生成
３．IPersistFileオブジェクトのポインタ取得
４．作成するショートカットのパスをセット
５．作成するショートカットの設定
６．作成するショートカットのパスを Unicode に変換して保存
７．オブジェクトの解放
８．COM 終了

こんな感じです。



１．〜４．までの詳しいやり方はサンプルをご覧下さい。



【 作成するショートカットの設定 】

ここでは５．について少し説明したいと思います。
何かご自分のディスクにあるショートカットのプロパティを
見てもらうと分かると思うのですが、いくつか設定項目があると思います。
中には何に使うのか良く分からない項目もあります。（自分にはあります）

だいたい、どのバージョンのウィンドウズにもある項目は

作業フォルダ
ショートカットキー
実行時の大きさ
コメント
アイコンの変更

でしょうか。

サンプルでは上から順番に

作業フォルダ        psl->SetWorkingDirectory( pWorkFolderPath );
ショートカットキー  なし
実行時の大きさ      psl->SetShowCmd( SW_SHOWNORMAL );
コメント            psl->SetDescription( pDescription );
アイコンの変更      psl->SetIconLocation( pTargetPath, 0 );

の部分に対応しています。


●作業フォルダの設定

作業フォルダは、例えばコマンドプロンプトでＣのコンパイラを
使う時などに、コンパイラが作ったファイルを保存しておくための
フォルダです。
ショートカットがリンクしている実行ファイルを起動した時に
一時的なファイルを置いておく場所とでも言うのでしょうか・・・。
作業フォルダを指定しない場合、どこが作業フォルダになるかは
実行ファイルによって違うと思います。（多分）


●実行時の大きさの設定

実行時の大きさの SetShowCmd() は ShowWindow() ＡＰＩ関数と
同じようなものです。
ショートカットを使って、アプリケーションを起動した時の
ウィンドウの表示方法を指定します。指定する値は ShowWindow()
関数の値がそのまま使えます。
よく使う値は

SW_SHOW             ウィンドウを表示する
SW_HIDE             ウィンドウを非表示にする
SW_MAXIMIZE         最大化して表示
SW_MINIMIZE         最小化して表示
SW_SHOWNORMAL       ウィンドウをアクティブにして通常表示
SW_SHOWMAXIMIZED    ウィンドウをアクティブにして最大化
SW_SHOWMINIMIZED    ウィンドウをアクティブにして最小化

でしょうか・・・。


●コメントの設定

コメントはファイルの簡単な説明を書いておくためのものです。
psl->SetDescription( pDescription ); とやってコメントを
設定します。
pDescription はポインタなので、あらかじめ

char comment[256];
wsprintf( comment, "コメントだよ〜ぅ！" );

のようにして、コメントを格納した配列を用意しておいて

CreateShortCut( ショートカットのパス, 元のファイルのパス,
                作業フォルダのパス, comment, コマンドライン );

というように、配列の先頭のポインタを CreateShortCut() 関数の引数に
渡します。（ CreateShortCut() は自作関数です。上のサンプルをご覧下さい。）


●アイコンの設定

アイコンの変更 psl->SetIconLocation( pTargetPath, 0 ); と
なっていますが、SetIconLocation() の最初の引数には、アイコンが
含まれているファイルの絶対パスを指定します。
アイコンがあるファイルであれば、どの種類のファイルを指定しても
そのファイルからアイコンを抜き出してくれます。
２番目の引数は、ファイルにアイコンが複数登録されている時に
何番目のアイコンを選択するかを指定します。
１番目のアイコンが 0 です。


●コマンドラインの設定

psl->SetArguments( pArgs );
はコマンドライン（コマンドオプション、スイッチ）を設定します。
ＤＯＳ窓を開いて実行するようなアプリケーションなら、よく
オプションを指定して起動したりするのですが、普通にウィンドウを
表示していろいろやるようなアプリケーションでは、あまり使いません
ねぇ・・・。
エディタなどではここにテキストファイルのパスを指定しておくと
そのテキストファイルをエディタに読み込んだ状態で起動することが
できます。


【 ショートカットのパスを Unicode に変換 】

作成するショートカットの設定が終わったら、最後に
ppf->Save( pathName, TRUE );
とやって、ショートカットを作成します。
ところが、この Save に指定できるのパス ( pathName ) は
２バイトの文字列でないといけません。
通常、Ｃで扱う文字列は char 型の配列を使うので１バイトです。
１バイトの文字列を２バイトに変換するために MultiByteToWideChar()
関数を使います。


【 オブジェクトの解放とＣＯＭの終了 】

ショートカットが作成できたら、使用したオブジェクト psl, ppf を
解放します。これは必ず行います。
オブジェクトの解放が終わったら CoUninitialize() を使って
ＣＯＭを終了します。

| home |