Sdílet prostřednictvím

CMFCFilterChunkValueImpl – třída

  • Článek

Toto je třída, která zjednodušuje logiku páru hodnot bloků dat i vlastností.

Syntaxe

class CMFCFilterChunkValueImpl : public ATL::IFilterChunkValue;

Členové

Veřejné konstruktory

Název Popis
CMFCFilterChunkValueImpl::~CMFCFilterChunkValueImpl Destrukuje objekt.
CMFCFilterChunkValueImpl::CMFCFilterChunkValueImpl Vytvoří objekt.

Veřejné metody

Název Popis
CMFCFilterChunkValueImpl::Clear Vymaže hodnotu ChunkValue.
CMFCFilterChunkValueImpl::CopyChunk Zkopíruje tento blok dat do struktury popisující charakteristiky bloku dat.
CMFCFilterChunkValueImpl::CopyFrom Inicializuje tuto hodnotu bloku z druhé hodnoty.
CMFCFilterChunkValueImpl::GetChunkGUID Načte identifikátor GUID bloku dat.
CMFCFilterChunkValueImpl::GetChunkPID Načte BLOK PID (ID vlastnosti).
CMFCFilterChunkValueImpl::GetChunkType Získá typ bloku.
CMFCFilterChunkValueImpl::GetString Načte hodnotu řetězce.
CMFCFilterChunkValueImpl::GetValue Načte hodnotu jako přidělený propvariant.
CMFCFilterChunkValueImpl::GetValueNoAlloc Vrátí hodnotu, která není přidělena (interní hodnota).
CMFCFilterChunkValueImpl::IsValid Zkontroluje, zda je tato hodnota vlastnosti platná nebo ne.
CMFCFilterChunkValueImpl::SetBoolValue Přetíženo. Nastaví vlastnost podle klíče na logickou hodnotu.
CMFCFilterChunkValueImpl::SetDwordValue Nastaví vlastnost podle klíče na DWORD.
CMFCFilterChunkValueImpl::SetFileTimeValue Nastaví vlastnost podle klíče na filetime.
CMFCFilterChunkValueImpl::SetInt64Value Nastaví vlastnost podle klíče na int64.
CMFCFilterChunkValueImpl::SetIntValue Nastaví vlastnost podle klíče na int.
CMFCFilterChunkValueImpl::SetLongValue Nastaví vlastnost podle klíče na LONG.
CMFCFilterChunkValueImpl::SetSystemTimeValue Nastaví vlastnost podle klíče na SystemTime.
CMFCFilterChunkValueImpl::SetTextValue Nastaví vlastnost podle klíče na řetězec Unicode.

Chráněné metody

Název Popis
CMFCFilterChunkValueImpl::SetChunk Pomocná funkce, která nastaví společné vlastnosti bloku dat.

Poznámky

Chcete-li použít, jednoduše vytvoříte CMFCFilterChunkValueImpl třídy správného druhu.

Příklad:

CMFCFilterChunkValueImpl blok;

hr = blok dat. SetBoolValue(PKEY_IsAttachment; true);

nebo

hr = blok dat. SetFileTimeValue(PKEY_ItemDate, ftLastModified);

Hierarchie dědičnosti

ATL::IFilterChunkValue

CMFCFilterChunkValueImpl

Požadavky

Hlavička: afxwin.h

CMFCFilterChunkValueImpl::Clear

Vymaže hodnotu ChunkValue.

void Clear();

Poznámky

CMFCFilterChunkValueImpl::CMFCFilterChunkValueImpl

Vytvoří objekt.

CMFCFilterChunkValueImpl();

Poznámky

CMFCFilterChunkValueImpl::~CMFCFilterChunkValueImpl

Destrukuje objekt.

virtual ~CMFCFilterChunkValueImpl();

Poznámky

CMFCFilterChunkValueImpl::CopyChunk

Zkopíruje tento blok dat do struktury popisující charakteristiky bloku dat.

HRESULT CopyChunk(STAT_CHUNK* pStatChunk);

Parametry

pStatChunk
Ukazatel na cílovou hodnotu popisující charakteristiky bloku dat.

Návratová hodnota

S_OK v případě úspěchu; jinak kód chyby.

Poznámky

CMFCFilterChunkValueImpl::CopyFrom

Inicializuje tuto hodnotu bloku z druhé hodnoty.

void CopyFrom (IFilterChunkValue* pValue);

Parametry

pValue
Určuje zdrojová hodnota, ze které se má kopírovat.

Poznámky

CMFCFilterChunkValueImpl::GetChunkGUID

Načte identifikátor GUID bloku dat.

REFGUID GetChunkGUID() const;

Návratová hodnota

Odkaz na identifikátor GUID identifikující blok dat.

Poznámky

CMFCFilterChunkValueImpl::GetChunkPID

Načte BLOK PID (ID vlastnosti).

DWORD GetChunkPID() const;

Návratová hodnota

Hodnota DWORD obsahující ID vlastnosti.

Poznámky

CMFCFilterChunkValueImpl::GetChunkType

Načte typ bloku dat.

CHUNKSTATE GetChunkType() const;

Návratová hodnota

Hodnota výčtu CHUNKSTATE, která určuje, zda aktuální blok dat je vlastnost textového typu nebo vlastnost typu hodnota.

Poznámky

CMFCFilterChunkValueImpl::GetString

Načte hodnotu řetězce.

CString &GetString();

Návratová hodnota

Řetězec obsahující hodnotu bloku.

Poznámky

CMFCFilterChunkValueImpl::GetValue

Načte hodnotu jako přidělený propvariant.

HRESULT GetValue(PROPVARIANT** ppPropVariant);

Parametry

ppPropVariant
Když funkce vrátí hodnotu bloku, tento parametr obsahuje hodnotu bloku.

Návratová hodnota

S_OK, pokud byla funkce PROPVARIANT úspěšně přidělena a hodnota bloku dat byla úspěšně zkopírována do ppPropVariant; jinak kód chyby.

Poznámky

CMFCFilterChunkValueImpl::GetValueNoAlloc

Vrátí hodnotu, která není přidělena (interní hodnota).

PROPVARIANT GetValueNoAlloc ();

Návratová hodnota

Vrátí aktuální hodnotu bloku dat.

Poznámky

CMFCFilterChunkValueImpl::IsValid

Zkontroluje, zda je tato hodnota vlastnosti platná nebo ne.

BOOL IsValid() const;

Návratová hodnota

TRUE, pokud je aktuální hodnota bloku platná; jinak NEPRAVDA.

Poznámky

CMFCFilterChunkValueImpl::SetBoolValue

Přetíženo. Nastaví vlastnost podle klíče na logickou hodnotu.

HRESULT SetBoolValue(
    REFPROPERTYKEY pkey,
    BOOL bVal,
    CHUNKSTATE chunkType = CHUNK_VALUE,
    LCID locale = 0,
    DWORD cwcLenSource = 0,
    DWORD cwcStartSource = 0,
    CHUNK_BREAKTYPE chunkBreakType = CHUNK_NO_BREAK);

HRESULT SetBoolValue(
    REFPROPERTYKEY pkey,
    VARIANT_BOOL bVal,
    CHUNKSTATE chunkType = CHUNK_VALUE,
    LCID locale = 0,
    DWORD cwcLenSource = 0,
    DWORD cwcStartSource = 0,
    CHUNK_BREAKTYPE chunkBreakType = CHUNK_NO_BREAK);

Parametry

pkey
Určuje klíč vlastnosti.

bVal
Určuje hodnotu bloku dat, která se má nastavit.

chunkType
Příznaky označují, zda tento blok dat obsahuje textový typ nebo vlastnost typu hodnota. Hodnoty příznaku jsou převzaty z výčtu CHUNKSTATE.

locale
Jazyk a podlanguage přidružené k bloku textu. Národní prostředí bloků dat používají indexery dokumentů k provádění správného dělení textu. Pokud blok dat není textový typ ani datový typ s datovým typem VT_LPWSTR, VT_LPSTR nebo VT_BSTR, bude toto pole ignorováno.

cwcLenSource
Délka znaků zdrojového textu, ze kterého byl aktuální blok dat odvozen. Nulová hodnota označuje znaky po znakové korespondenci mezi zdrojovým textem a odvozeným textem. Nenulová hodnota znamená, že taková přímá korespondence neexistuje.

cwcStartSource
Posun zdrojového textu pro odvozený blok dat začíná ve zdrojovém bloku.

chunkBreakType
Typ přerušení, který odděluje předchozí blok dat od aktuálního bloku dat. Hodnoty pocházejí z CHUNK_BREAKTYPE výčtu.

Návratová hodnota

S_OK v případě úspěchu; jinak kód chyby.

Poznámky

CMFCFilterChunkValueImpl::SetChunk

Pomocná funkce, která nastaví společné vlastnosti bloku dat.

HRESULT SetChunk(
    REFPROPERTYKEY pkey,
    CHUNKSTATE chunkType=CHUNK_VALUE,
    LCID locale=0,
    DWORD cwcLenSource=0,
    DWORD cwcStartSource=0,
    CHUNK_BREAKTYPE chunkBreakType=CHUNK_NO_BREAK);

Parametry

pkey
Určuje klíč vlastnosti.

chunkType
Příznaky označují, zda tento blok dat obsahuje textový typ nebo vlastnost typu hodnota. Hodnoty příznaku jsou převzaty z výčtu CHUNKSTATE.

locale
Jazyk a podlanguage přidružené k bloku textu. Národní prostředí bloků dat používají indexery dokumentů k provádění správného dělení textu. Pokud blok dat není textový typ ani datový typ s datovým typem VT_LPWSTR, VT_LPSTR nebo VT_BSTR, bude toto pole ignorováno.

cwcLenSource
Délka znaků zdrojového textu, ze kterého byl aktuální blok dat odvozen. Nulová hodnota označuje znaky po znakové korespondenci mezi zdrojovým textem a odvozeným textem. Nenulová hodnota znamená, že taková přímá korespondence neexistuje.

cwcStartSource
Posun zdrojového textu pro odvozený blok dat začíná ve zdrojovém bloku.

chunkBreakType
Typ přerušení, který odděluje předchozí blok dat od aktuálního bloku dat. Hodnoty pocházejí z CHUNK_BREAKTYPE výčtu.

Návratová hodnota

S_OK v případě úspěchu; jinak kód chyby.

Poznámky

CMFCFilterChunkValueImpl::SetDwordValue

Nastavte vlastnost podle klíče na DWORD.

HRESULT SetDwordValue(
    REFPROPERTYKEY pkey,
    DWORD dwVal,
    CHUNKSTATE chunkType = CHUNK_VALUE,
    LCID locale = 0,
    DWORD cwcLenSource = 0,
    DWORD cwcStartSource = 0,
    CHUNK_BREAKTYPE chunkBreakType = CHUNK_NO_BREAK);

Parametry

pkey
Určuje klíč vlastnosti.

dwVal
Určuje hodnotu bloku dat, která se má nastavit.

chunkType
Příznaky označují, zda tento blok dat obsahuje textový typ nebo vlastnost typu hodnota. Hodnoty příznaku jsou převzaty z výčtu CHUNKSTATE.

locale
Jazyk a podlanguage přidružené k bloku textu. Národní prostředí bloků dat používají indexery dokumentů k provádění správného dělení textu. Pokud blok dat není textový typ ani datový typ s datovým typem VT_LPWSTR, VT_LPSTR nebo VT_BSTR, bude toto pole ignorováno.

cwcLenSource
Délka znaků zdrojového textu, ze kterého byl aktuální blok dat odvozen. Nulová hodnota označuje znaky po znakové korespondenci mezi zdrojovým textem a odvozeným textem. Nenulová hodnota znamená, že taková přímá korespondence neexistuje.

cwcStartSource
Posun zdrojového textu pro odvozený blok dat začíná ve zdrojovém bloku.

chunkBreakType
Typ přerušení, který odděluje předchozí blok dat od aktuálního bloku dat. Hodnoty pocházejí z CHUNK_BREAKTYPE výčtu.

Návratová hodnota

S_OK v případě úspěchu; jinak kód chyby.

Poznámky

CMFCFilterChunkValueImpl::SetFileTimeValue

Nastavte vlastnost podle klíče na filetime.

HRESULT SetFileTimeValue(
    REFPROPERTYKEY pkey,
    FILETIME dtVal,
    CHUNKSTATE chunkType = CHUNK_VALUE,
    LCID locale = 0,
    DWORD cwcLenSource = 0,
    DWORD cwcStartSource = 0,
    CHUNK_BREAKTYPE chunkBreakType = CHUNK_NO_BREAK);

Parametry

pkey
Určuje klíč vlastnosti.

dtVal
Určuje hodnotu bloku dat, která se má nastavit.

chunkType
Příznaky označují, zda tento blok dat obsahuje textový typ nebo vlastnost typu hodnota. Hodnoty příznaku jsou převzaty z výčtu CHUNKSTATE.

locale
Jazyk a podlanguage přidružené k bloku textu. Národní prostředí bloků dat používají indexery dokumentů k provádění správného dělení textu. Pokud blok dat není textový typ ani datový typ s datovým typem VT_LPWSTR, VT_LPSTR nebo VT_BSTR, bude toto pole ignorováno.

cwcLenSource
Délka znaků zdrojového textu, ze kterého byl aktuální blok dat odvozen. Nulová hodnota označuje znaky po znakové korespondenci mezi zdrojovým textem a odvozeným textem. Nenulová hodnota znamená, že taková přímá korespondence neexistuje.

cwcStartSource
Posun zdrojového textu pro odvozený blok dat začíná ve zdrojovém bloku.

chunkBreakType
Typ přerušení, který odděluje předchozí blok dat od aktuálního bloku dat. Hodnoty pocházejí z CHUNK_BREAKTYPE výčtu.

Návratová hodnota

S_OK v případě úspěchu; jinak kód chyby.

Poznámky

CMFCFilterChunkValueImpl::SetInt64Value

Nastavte vlastnost podle klíče na int64.

HRESULT SetInt64Value(
    REFPROPERTYKEY pkey,
    __int64 nVal,
    CHUNKSTATE chunkType = CHUNK_VALUE,
    LCID locale = 0,
    DWORD cwcLenSource = 0,
    DWORD cwcStartSource = 0,
    CHUNK_BREAKTYPE chunkBreakType = CHUNK_NO_BREAK);

Parametry

pkey
Určuje klíč vlastnosti.

nVal
Určuje hodnotu bloku dat, která se má nastavit.

chunkType
Příznaky označují, zda tento blok dat obsahuje textový typ nebo vlastnost typu hodnota. Hodnoty příznaku jsou převzaty z výčtu CHUNKSTATE.

locale
Jazyk a podlanguage přidružené k bloku textu. Národní prostředí bloků dat používají indexery dokumentů k provádění správného dělení textu. Pokud blok dat není textový typ ani datový typ s datovým typem VT_LPWSTR, VT_LPSTR nebo VT_BSTR, bude toto pole ignorováno.

cwcLenSource
Délka znaků zdrojového textu, ze kterého byl aktuální blok dat odvozen. Nulová hodnota označuje znaky po znakové korespondenci mezi zdrojovým textem a odvozeným textem. Nenulová hodnota znamená, že taková přímá korespondence neexistuje.

cwcStartSource
Posun zdrojového textu pro odvozený blok dat začíná ve zdrojovém bloku.

chunkBreakType
Typ přerušení, který odděluje předchozí blok dat od aktuálního bloku dat. Hodnoty pocházejí z CHUNK_BREAKTYPE výčtu.

Návratová hodnota

S_OK v případě úspěchu; jinak kód chyby.

Poznámky

CMFCFilterChunkValueImpl::SetIntValue

Nastavte vlastnost podle klíče na int.

HRESULT SetIntValue(
    REFPROPERTYKEY pkey,
    int nVal,
    CHUNKSTATE chunkType = CHUNK_VALUE,
    LCID locale = 0,
    DWORD cwcLenSource = 0,
    DWORD cwcStartSource = 0,
    CHUNK_BREAKTYPE chunkBreakType = CHUNK_NO_BREAK);

Parametry

pkey
Určuje klíč vlastnosti.

nVal
Určuje hodnotu bloku dat, která se má nastavit.

chunkType
Příznaky označují, zda tento blok dat obsahuje textový typ nebo vlastnost typu hodnota. Hodnoty příznaku jsou převzaty z výčtu CHUNKSTATE.

locale
Jazyk a podlanguage přidružené k bloku textu. Národní prostředí bloků dat používají indexery dokumentů k provádění správného dělení textu. Pokud blok dat není textový typ ani datový typ s datovým typem VT_LPWSTR, VT_LPSTR nebo VT_BSTR, bude toto pole ignorováno.

cwcLenSource
Délka znaků zdrojového textu, ze kterého byl aktuální blok dat odvozen. Nulová hodnota označuje znaky po znakové korespondenci mezi zdrojovým textem a odvozeným textem. Nenulová hodnota znamená, že taková přímá korespondence neexistuje.

cwcStartSource
Posun zdrojového textu pro odvozený blok dat začíná ve zdrojovém bloku.

chunkBreakType
Typ přerušení, který odděluje předchozí blok dat od aktuálního bloku dat. Hodnoty pocházejí z CHUNK_BREAKTYPE výčtu.

Návratová hodnota

S_OK v případě úspěchu; jinak kód chyby.

Poznámky

CMFCFilterChunkValueImpl::SetLongValue

Nastavte vlastnost podle klíče na HODNOTU LONG.

HRESULT SetLongValue(
    REFPROPERTYKEY pkey,
    long lVal,
    CHUNKSTATE chunkType = CHUNK_VALUE,
    LCID locale = 0,
    DWORD cwcLenSource = 0,
    DWORD cwcStartSource = 0,
    CHUNK_BREAKTYPE chunkBreakType = CHUNK_NO_BREAK);

Parametry

pkey
Určuje klíč vlastnosti.

LVal
Určuje hodnotu bloku dat, která se má nastavit.

chunkType
Příznaky označují, zda tento blok dat obsahuje textový typ nebo vlastnost typu hodnota. Hodnoty příznaku jsou převzaty z výčtu CHUNKSTATE.

locale
Jazyk a podlanguage přidružené k bloku textu. Národní prostředí bloků dat používají indexery dokumentů k provádění správného dělení textu. Pokud blok dat není textový typ ani datový typ s datovým typem VT_LPWSTR, VT_LPSTR nebo VT_BSTR, bude toto pole ignorováno.

cwcLenSource
Délka znaků zdrojového textu, ze kterého byl aktuální blok dat odvozen. Nulová hodnota označuje znaky po znakové korespondenci mezi zdrojovým textem a odvozeným textem. Nenulová hodnota znamená, že taková přímá korespondence neexistuje.

cwcStartSource
Posun zdrojového textu pro odvozený blok dat začíná ve zdrojovém bloku.

chunkBreakType
Typ přerušení, který odděluje předchozí blok dat od aktuálního bloku dat. Hodnoty pocházejí z CHUNK_BREAKTYPE výčtu.

Návratová hodnota

S_OK v případě úspěchu; jinak kód chyby.

Poznámky

CMFCFilterChunkValueImpl::SetSystemTimeValue

Nastaví vlastnost podle klíče na SystemTime.

HRESULT SetSystemTimeValue(
    REFPROPERTYKEY pkey,
    const SYSTEMTIME& systemTime,
    CHUNKSTATE chunkType = CHUNK_VALUE,
    LCID locale=0,
    DWORD cwcLenSource=0,
    DWORD cwcStartSource=0,
    CHUNK_BREAKTYPE chunkBreakType=CHUNK_NO_BREAK);

Parametry

pkey
Určuje klíč vlastnosti.

systemTime
Určuje hodnotu bloku dat, která se má nastavit.

chunkType
Příznaky označují, zda tento blok dat obsahuje textový typ nebo vlastnost typu hodnota. Hodnoty příznaku jsou převzaty z výčtu CHUNKSTATE.

locale
Jazyk a podlanguage přidružené k bloku textu. Národní prostředí bloků dat používají indexery dokumentů k provádění správného dělení textu. Pokud blok dat není textový typ ani datový typ s datovým typem VT_LPWSTR, VT_LPSTR nebo VT_BSTR, bude toto pole ignorováno.

cwcLenSource
Délka znaků zdrojového textu, ze kterého byl aktuální blok dat odvozen. Nulová hodnota označuje znaky po znakové korespondenci mezi zdrojovým textem a odvozeným textem. Nenulová hodnota znamená, že taková přímá korespondence neexistuje.

cwcStartSource
Posun zdrojového textu pro odvozený blok dat začíná ve zdrojovém bloku.

chunkBreakType
Typ přerušení, který odděluje předchozí blok dat od aktuálního bloku dat. Hodnoty pocházejí z CHUNK_BREAKTYPE výčtu.

Návratová hodnota

S_OK v případě úspěchu; jinak kód chyby.

Poznámky

CMFCFilterChunkValueImpl::SetTextValue

Nastaví vlastnost podle klíče na řetězec Unicode.

HRESULT SetTextValue(
    REFPROPERTYKEY pkey,
    LPCTSTR pszValue,
    CHUNKSTATE chunkType = CHUNK_VALUE,
    LCID locale = 0,
    DWORD cwcLenSource = 0,
    DWORD cwcStartSource = 0,
    CHUNK_BREAKTYPE chunkBreakType = CHUNK_NO_BREAK);

Parametry

pkey
Určuje klíč vlastnosti.

pszValue
Určuje hodnotu bloku dat, která se má nastavit.

chunkType
Příznaky označují, zda tento blok dat obsahuje textový typ nebo vlastnost typu hodnota. Hodnoty příznaku jsou převzaty z výčtu CHUNKSTATE.

locale
Jazyk a podlanguage přidružené k bloku textu. Národní prostředí bloků dat používají indexery dokumentů k provádění správného dělení textu. Pokud blok dat není textový typ ani datový typ s datovým typem VT_LPWSTR, VT_LPSTR nebo VT_BSTR, bude toto pole ignorováno.

cwcLenSource
Délka znaků zdrojového textu, ze kterého byl aktuální blok dat odvozen. Nulová hodnota označuje znaky po znakové korespondenci mezi zdrojovým textem a odvozeným textem. Nenulová hodnota znamená, že taková přímá korespondence neexistuje.

cwcStartSource
Posun zdrojového textu pro odvozený blok dat začíná ve zdrojovém bloku.

chunkBreakType
Typ přerušení, který odděluje předchozí blok dat od aktuálního bloku dat. Hodnoty pocházejí z CHUNK_BREAKTYPE výčtu.

Návratová hodnota

S_OK v případě úspěchu; jinak kód chyby.

Poznámky

Viz také

Třídy