Shortcut テーブル
Shortcut テーブルには、アプリケーションがユーザーのコンピューターにショートカットを作成するために必要な情報が保持されます。
Shortcut テーブルには次の列があります。
| Column | 種類 | キー | Nullable |
|---|---|---|---|
| ショートカット | Identifier | Y | N |
| Directory_ | Identifier | N | N |
| 名前 | Filename | N | N |
| Component_ | Identifier | N | N |
| 移行先 | ショートカット | N | N |
| 引数 | Formatted | N | Y |
| 説明 | [テキスト] | N | Y |
| ホット キー | 整数 | N | Y |
| Icon_ | Identifier | N | Y |
| IconIndex | 整数 | N | Y |
| ShowCmd | 整数 | N | Y |
| WkDir | Identifier | N | Y |
| DisplayResourceDLL | Formatted | N | Y |
| DisplayResourceId | 整数 | N | Y |
| DescriptionResourceDLL | Formatted | N | Y |
| DescriptionResourceId | 整数 | N | Y |
[列]
-
Shortcut
-
このテーブルのキー値。
-
Directory_
-
Directory テーブルの最初の列の外部キー。 この列には、Shortcut ファイルを作成するディレクトリを指定します。
-
Name
-
作成するショートカットのローカライズ可能な名前。
-
Component_
-
Component テーブルの最初の列の外部キー。 この列に指定されたコンポーネントのインストール状態は、インストーラーでショートカットを作成するか削除するかを決定するために使われます。 ショートカットをインストールするには、このコンポーネントには有効なキー パスが必要です。 Target 列に機能名が含まれている場合、ショートカットによって起動されるファイルは、この列に列挙されているコンポーネントのキー ファイルです。
-
Target
-
ショートカットのターゲット。
アドバタイズされたショートカットの場合、この列は Feature テーブルの最初の列の外部キーである必要があります。 Target フィールドのエントリは、インストーラーによって Identifier と評価されます。このエントリは Feature テーブルの有効な外部キーである必要があります。 この場合、ショートカットによって起動されるファイルは、Component_ 列に列挙されているコンポーネント キー ファイルです。 ショートカットがアクティブになると、このファイルを起動する前に、インストーラーによって、その機能のすべてのコンポーネントがインストールされているかことが確認されます。
アドバタイズされていないショートカットの場合、このフィールドはインストーラーによって Formatted 文字列と評価されます。 このフィールドには、角かっこ ([]) で囲まれたプロパティ識別子を含めてください。ショートカットが指すファイルまたはフォルダーに展開されます。 詳細については、「CreateShortcuts アクション」を参照してください。
-
Arguments
-
ショートカットのコマンドライン引数。
Arguments フィールドのプロパティの解決は制限されていることに注意してください。 このフィールドの [Property] という形式のプロパティは、ショートカットを所有するコンポーネントがインストールされたときに、そのプロパティが既に意図した値である場合にのみ解決できます。 たとえば、引数 "[#MyDoc.doc]" の正しい値に解決するには、ファイル MyDoc.doc とそのショートカットを所有するコンポーネントを同じプロセスでインストールする必要があります。
-
Description
-
ショートカットのローカライズ可能な説明。
-
Hotkey
-
ショートカットのホットキー。 下位バイトにはキーの仮想キー コード、上位バイトには修飾子フラグが含まれています。 これは負ではない数にする必要があります。 通常、インストール パッケージの作成者は、このオプションを設定しないことをお勧めします。このオプションを設定すると、ユーザーのデスクトップに重複するホットキーが追加される可能性があるからです。 また、ショートカットにホットキーを割り当てる方法は、アクセシビリティに対応したホットキーを使っているユーザーにとって問題になることがあります。
-
Icon_
-
Icon テーブルの列 1 の外部キー。
-
IconIndex
-
ショートカットのアイコン インデックス。 これは負ではない数にする必要があります。
-
ShowCmd
-
アプリケーション ウィンドウの Show コマンド。
次の値を使用できます。 値は、Windows API 関数 ShowWindow で定義されているとおりです。
値 意味 1 SW_SHOWNORMAL 3 SW_SHOWMAXIMIZED 7 SW_SHOWMINNOACTIVE -
WkDir
-
ショートカットの作業ディレクトリのパスが指定されたプロパティの名前。 この値は、環境変数を参照するために Windows 形式を使用できます (たとえば %USERPROFILE%)。 インストーラーがショートカットを作成するために作業ディレクトリを解決するときに、この参照は実際のパスに解決されます。
-
DisplayResourceDLL
-
リソース構成 (RC Config) データを含む言語に依存しない移植可能な実行可能ファイル (LN ファイル) の完全なパスに対する Formatted 文字列値がこのフィールドに含まれています。 書式設定された文字列には [#filekey] 規約を使用できます。 このフィールドに値が格納されている場合、Name 列は無視されます。 このフィールドが空の場合、インストーラーは Name 列の値を使います。 このフィールドに値が格納されている場合、DisplayResourceId フィールドにも値が格納されている必要があります。そうでない場合、インストールは失敗します。
Shortcut テーブルのこの列が使われるのは、Windows Vista または Windows Server 2008 上で実行されている場合のみです。それ以外の場合は無視されます。 この列は、Windows インストーラー 4.0 よりも前のバージョンで使用できます。
MUI リソースで使うショートカットを Shortcut テーブルに追加する方法については、「MUI ショートカットの例」を参照してください。
-
DisplayResourceId
-
ショートカットの表示名インデックス。 これは負ではない数にする必要があります。 このフィールドに値が格納されている場合、DisplayResourceDLL フィールドにも値が格納されている必要があります。そうでない場合、インストールは失敗します。
Shortcut テーブルのこの列が使われるのは、Windows Vista または Windows Server 2008 上で実行されている場合のみです。それ以外の場合は無視されます。 この列は、Windows インストーラー 4.0 よりも前のバージョンで使用できます。
-
DescriptionResourceDLL
-
リソース構成 (RC Config) データを含む言語に依存しない移植可能な実行可能ファイル (LN ファイル) の完全なパスに対する Formatted 文字列値がこのフィールドに含まれています。 書式設定された文字列には [#filekey] 規約を使用できます。 このフィールドに値が格納されている場合、Name 列は無視されます。 このフィールドが空の場合、インストーラーは Description 列の値を使います。 このフィールドに値が格納されている場合、DescriptionResourceId フィールドにも値が格納されている必要があります。そうでない場合、インストールは失敗します。
Shortcut テーブルのこの列が使われるのは、Windows Vista または Windows Server 2008 上で実行されている場合のみです。それ以外の場合は無視されます。 この列は、Windows インストーラー 4.0 よりも前のバージョンで使用できます。
MUI リソースで使うショートカットを Shortcut テーブルに追加する方法については、「MUI ショートカットの例」を参照してください。
-
DescriptionResourceId
-
ショートカットの説明名インデックス。 これは負ではない数にする必要があります。 このフィールドに値が格納されている場合、DescriptionResourceDLL フィールドにも値が格納されている必要があります。そうでない場合、インストールは失敗します。
Shortcut テーブルのこの列が使われるのは、Windows Vista または Windows Server 2008 上で実行されている場合のみです。それ以外の場合は無視されます。 この列は、Windows インストーラー 4.0 よりも前のバージョンで使用できます。
解説
この機能を有効にすると、システムの IShellLink インターフェイスがインストーラー記述子の解決をサポートしている場合にのみ、アドバタイズされたショートカットが作成されます。 これは、Microsoft Windows 2000 と、Microsoft Internet Explorer 4.01 を実行しているシステムでサポートされています。 サポートされていない場合、ローカルまたはソースから実行される機能のコンポーネントをインストールするときに、インストーラーによってアドバタイズされていないショートカットが作成されます。
アドバタイズされたショートカットは、常に ProductCode で指定された特定のアプリケーションを指しており、アプリケーション間で共有することはできないことに注意してください。 アドバタイズされたショートカットは、最近インストールされたアプリケーションに対してのみ機能し、そのアプリケーションが削除されると削除されます。
このテーブルは CreateShortcuts アクションと RemoveShortcuts アクションを実行したときに参照されます。
「DISABLEADVTSHORTCUTS プロパティ」も参照してください。
検証
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示