IWICMetadataQueryWriter

メタデータクエリ式を使用して、エンコーダーまたはそのイメージフレームに対してメタデータブロックおよびメタデータ項目を設定または削除するためのメソッドを公開します。

メタデータクエリライターは、メタデータクエリ式を使用してメタデータを設定または削除します。メタデータクエリ言語の詳細については、メタデータクエリ言語の概要を参照してください。

例

次のコードは、XMP クエリライターを作成し、新しいメタデータ項目を追加する方法を示しています。

// Create XMP block
IWICMetadataQueryWriter *pXMPWriter = NULL;

if (SUCCEEDED(hr))
{
    hr = pFactory->CreateQueryWriter(GUID_MetadataFormatXMP, NULL, &pXMPWriter);
}

// Write metadata to the XMP writer
if (SUCCEEDED(hr))
{
    PROPVARIANT value;
    PropVariantInit(&value);

    value.vt = VT_LPWSTR;
    value.pwszVal = L"Metadata Test Image.";
    
    hr = pXMPWriter->SetMetadataByName(L"/dc:title", &value);

    PropVariantClear(&value);
}

メタデータ項目を特定の場所に設定します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

SetMetadataByName は、メタデータクエリ式を使用してメタデータを削除します。メタデータクエリ言語の詳細については、メタデータクエリ言語の概要を参照してください。

設定する値がネストされたメタデータブロックである場合は、バリアント型 VT_UNKNOWN を使用し、pvarValue が新しいメタデータブロックの IWICMetadataQueryWriter を指すようにします。
相対的な位置は指定されないため、メタデータ項目の順序はクエリライターの裁量に委ねられます。

メタデータクエリ式を使用して、特定の場所からメタデータ項目を削除します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

RemoveMetadataByName は、メタデータクエリ式を使用してメタデータを削除します。メタデータクエリ言語の詳細については、メタデータクエリ言語の概要を参照してください。

メタデータ項目がメタデータブロックである場合は、メタデータ階層から削除されます。