CMFCFilterChunkValueImpl – třída
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
| Jméno | popis |
|---|---|
| CMFCFilterChunkValueImpl::~CMFCFilterChunkValueImpl | Destrukuje objekt. |
| CMFCFilterChunkValueImpl::CMFCFilterChunkValueImpl | Vytvoří objekt. |
Veřejné metody
| Jméno | 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
| Jméno | 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
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.
Vrácená 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;
Vrácená hodnota
Odkaz na identifikátor GUID identifikující blok dat.
Poznámky
CMFCFilterChunkValueImpl::GetChunkPID
Načte BLOK PID (ID vlastnosti).
DWORD GetChunkPID() const;
Vrácená hodnota
Hodnota DWORD obsahující ID vlastnosti.
Poznámky
CMFCFilterChunkValueImpl::GetChunkType
Načte typ bloku dat.
CHUNKSTATE GetChunkType() const;
Vrácená 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();
Vrácená 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.
Vrácená 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 ();
Vrácená hodnota
Vrátí aktuální hodnotu bloku dat.
Poznámky
CMFCFilterChunkValueImpl::IsValid
Zkontroluje, zda je tato hodnota vlastnosti platná nebo ne.
BOOL IsValid() const;
Vrácená 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.
Vrácená 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.
Vrácená 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.
Vrácená 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.
Vrácená 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.
Vrácená 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.
Vrácená 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.
Vrácená 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.
Vrácená 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.
Vrácená hodnota
S_OK v případě úspěchu; jinak kód chyby.
Poznámky
Viz také
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro