Win32 API 日本語リファレンス
ホーム › UI.Shell › SHARD

SHARD

列挙型
📘 Microsoft Learn (日本語) · English
基底型i4

メンバー 8

名前10進16進説明
SHARD_PIDL10x1pv パラメーターは、ドキュメントのファイルオブジェクトを識別する PIDL を指します。ファイル以外のオブジェクトを識別する PIDL は受け付けられません。
SHARD_PATHA20x2pv パラメーターは、オブジェクトのパスとファイル名を格納した NULL 終端の ANSI 文字列を指します。
SHARD_PATHW30x3pv パラメーターは、オブジェクトのパスとファイル名を格納した NULL 終端の Unicode 文字列を指します。
SHARD_APPIDINFO40x4Windows 7 以降。pv パラメーターは SHARDAPPIDINFO 構造体を指します。この構造体は、項目を識別する IShellItem と、その項目を特定のプロセスまたはアプリケーションに関連付ける AppUserModelID を組み合わせます。
SHARD_APPIDINFOIDLIST50x5Windows 7 以降。pv パラメーターは SHARDAPPIDINFOIDLIST 構造体を指します。この構造体は、項目を識別する絶対 PIDL と、その項目を特定のプロセスまたはアプリケーションに関連付ける AppUserModelID を組み合わせます。
SHARD_LINK60x6Windows 7 以降。pv パラメーターは IShellLink オブジェクトへのインターフェイスポインターです。
SHARD_APPIDINFOLINK70x7Windows 7 以降。pv パラメーターは SHARDAPPIDINFOLINK 構造体を指します。この構造体は、項目を識別する IShellLink と、その項目を特定のプロセスまたはアプリケーションに関連付ける AppUserModelID を組み合わせます。
SHARD_SHELLITEM80x8Windows 7 以降。pv パラメーターは IShellItem オブジェクトへのインターフェイスポインターです。

公式ドキュメント

使用状況の統計が追跡される項目を識別するために、SHAddToRecentDocs の pv パラメーターに渡されるデータをどのように解釈するかを示します。

解説(Remarks)

Windows 7 より前では、SHARD_PIDL、SHARD_PATHA、SHARD_PATHW は列挙型のメンバーではなく、個別の定数として定義されていました。

SHARD_LINK または SHARD_APPIDINFOLINK によって IShellLink を渡す場合、その IShellLink インスタンスは次の情報を提供しなければなりません。

表示名は、項目の System.Title (PKEY_Title) プロパティで設定しなければなりません。このプロパティには表示名を直接格納することも、格納済みの文字列を利用するために "@shell32.dll,-1324" のような間接文字列表現を指定することもできます。間接文字列を使用すると、ユーザーが選択した言語で項目名を表示できます。

必要に応じて、説明フィールド (IShellLink::SetDescription) を設定して、ジャンプリスト内の項目にカスタムのツールチップを表示できます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum SHARD : int {
    SHARD_PIDL = 1,
    SHARD_PATHA = 2,
    SHARD_PATHW = 3,
    SHARD_APPIDINFO = 4,
    SHARD_APPIDINFOIDLIST = 5,
    SHARD_LINK = 6,
    SHARD_APPIDINFOLINK = 7,
    SHARD_SHELLITEM = 8
} SHARD;
public enum SHARD : int
{
    SHARD_PIDL = 1,
    SHARD_PATHA = 2,
    SHARD_PATHW = 3,
    SHARD_APPIDINFO = 4,
    SHARD_APPIDINFOIDLIST = 5,
    SHARD_LINK = 6,
    SHARD_APPIDINFOLINK = 7,
    SHARD_SHELLITEM = 8,
}
Public Enum SHARD As Integer
    SHARD_PIDL = 1
    SHARD_PATHA = 2
    SHARD_PATHW = 3
    SHARD_APPIDINFO = 4
    SHARD_APPIDINFOIDLIST = 5
    SHARD_LINK = 6
    SHARD_APPIDINFOLINK = 7
    SHARD_SHELLITEM = 8
End Enum
import enum

class SHARD(enum.IntEnum):
    SHARD_PIDL = 1
    SHARD_PATHA = 2
    SHARD_PATHW = 3
    SHARD_APPIDINFO = 4
    SHARD_APPIDINFOIDLIST = 5
    SHARD_LINK = 6
    SHARD_APPIDINFOLINK = 7
    SHARD_SHELLITEM = 8
// SHARD
pub const SHARD_PIDL: i32 = 1;
pub const SHARD_PATHA: i32 = 2;
pub const SHARD_PATHW: i32 = 3;
pub const SHARD_APPIDINFO: i32 = 4;
pub const SHARD_APPIDINFOIDLIST: i32 = 5;
pub const SHARD_LINK: i32 = 6;
pub const SHARD_APPIDINFOLINK: i32 = 7;
pub const SHARD_SHELLITEM: i32 = 8;
// SHARD
const (
	SHARD_PIDL int32 = 1
	SHARD_PATHA int32 = 2
	SHARD_PATHW int32 = 3
	SHARD_APPIDINFO int32 = 4
	SHARD_APPIDINFOIDLIST int32 = 5
	SHARD_LINK int32 = 6
	SHARD_APPIDINFOLINK int32 = 7
	SHARD_SHELLITEM int32 = 8
)
const
  SHARD_PIDL = 1;
  SHARD_PATHA = 2;
  SHARD_PATHW = 3;
  SHARD_APPIDINFO = 4;
  SHARD_APPIDINFOIDLIST = 5;
  SHARD_LINK = 6;
  SHARD_APPIDINFOLINK = 7;
  SHARD_SHELLITEM = 8;
// SHARD
pub const SHARD_PIDL: i32 = 1;
pub const SHARD_PATHA: i32 = 2;
pub const SHARD_PATHW: i32 = 3;
pub const SHARD_APPIDINFO: i32 = 4;
pub const SHARD_APPIDINFOIDLIST: i32 = 5;
pub const SHARD_LINK: i32 = 6;
pub const SHARD_APPIDINFOLINK: i32 = 7;
pub const SHARD_SHELLITEM: i32 = 8;
const
  SHARD_PIDL* = 1
  SHARD_PATHA* = 2
  SHARD_PATHW* = 3
  SHARD_APPIDINFO* = 4
  SHARD_APPIDINFOIDLIST* = 5
  SHARD_LINK* = 6
  SHARD_APPIDINFOLINK* = 7
  SHARD_SHELLITEM* = 8
enum SHARD : int {
    SHARD_PIDL = 1,
    SHARD_PATHA = 2,
    SHARD_PATHW = 3,
    SHARD_APPIDINFO = 4,
    SHARD_APPIDINFOIDLIST = 5,
    SHARD_LINK = 6,
    SHARD_APPIDINFOLINK = 7,
    SHARD_SHELLITEM = 8,
}
#define global SHARD_PIDL            0x1
#define global SHARD_PATHA           0x2
#define global SHARD_PATHW           0x3
#define global SHARD_APPIDINFO       0x4
#define global SHARD_APPIDINFOIDLIST 0x5
#define global SHARD_LINK            0x6
#define global SHARD_APPIDINFOLINK   0x7
#define global SHARD_SHELLITEM       0x8