Klasa CMFCFilterChunkValueImpl
Jest to klasa, która upraszcza logikę par par fragmentów i właściwości.
Składnia
class CMFCFilterChunkValueImpl : public ATL::IFilterChunkValue;
Elementy członkowskie
Konstruktory publiczne
| Nazwa/nazwisko | opis |
|---|---|
| CMFCFilterChunkValueImpl::~CMFCFilterChunkValueImpl | Destrukuje obiekt. |
| CMFCFilterChunkValueImpl::CMFCFilterChunkValueImpl | Konstruuje obiekt . |
Metody publiczne
| Nazwa/nazwisko | opis |
|---|---|
| CMFCFilterChunkValueImpl::Clear | Czyści wartość ChunkValue. |
| CMFCFilterChunkValueImpl::CopyChunk | Kopiuje ten fragment do struktury opisującej cechy fragmentu. |
| CMFCFilterChunkValueImpl::CopyFrom | Inicjuje tę wartość fragmentu z innej wartości. |
| CMFCFilterChunkValueImpl::GetChunkGUID | Pobiera identyfikator GUID fragmentu. |
| CMFCFilterChunkValueImpl::GetChunkPID | Pobiera fragment PID (identyfikator właściwości). |
| CMFCFilterChunkValueImpl::GetChunkType | Pobiera typ fragmentu. |
| CMFCFilterChunkValueImpl::GetString | Pobiera wartość ciągu. |
| CMFCFilterChunkValueImpl::GetValue | Pobiera wartość jako przydzielony propvariant. |
| CMFCFilterChunkValueImpl::GetValueNoAlloc | Zwraca wartość nieprzydzielonej (wartość wewnętrzna). |
| CMFCFilterChunkValueImpl::IsValid | Sprawdza, czy ta wartość właściwości jest prawidłowa, czy nie. |
| CMFCFilterChunkValueImpl::SetBoolValue | Przeciążone. Ustawia właściwość według klucza na wartość logiczną. |
| CMFCFilterChunkValueImpl::SetDwordValue | Ustawia właściwość według klucza na DWORD. |
| CMFCFilterChunkValueImpl::SetFileTimeValue | Ustawia właściwość według klucza na filetime. |
| CMFCFilterChunkValueImpl::SetInt64Value | Ustawia właściwość według klucza na int64. |
| CMFCFilterChunkValueImpl::SetIntValue | Ustawia właściwość według klucza na int. |
| CMFCFilterChunkValueImpl::SetLongValue | Ustawia właściwość według klucza na WARTOŚĆ LONG. |
| CMFCFilterChunkValueImpl::SetSystemTimeValue | Ustawia właściwość według klucza na Wartość SystemTime. |
| CMFCFilterChunkValueImpl::SetTextValue | Ustawia właściwość według klucza na ciąg Unicode. |
Metody chronione
| Nazwa/nazwisko | opis |
|---|---|
| CMFCFilterChunkValueImpl::SetChunk | Funkcja pomocnika, która ustawia typowe właściwości fragmentu. |
Uwagi
Aby użyć, wystarczy utworzyć klasę CMFCFilterChunkValueImpl odpowiedniego rodzaju
Przykład:
Fragment CMFCFilterChunkValueImpl;
hr = fragment. SetBoolValue(PKEY_IsAttachment, true);
lub
hr = fragment. SetFileTimeValue(PKEY_ItemDate, ftLastModified);
Hierarchia dziedziczenia
ATL::IFilterChunkValue
Wymagania
Nagłówek: afxwin.h
CMFCFilterChunkValueImpl::Clear
Czyści wartość ChunkValue.
void Clear();
Uwagi
CMFCFilterChunkValueImpl::CMFCFilterChunkValueImpl
Konstruuje obiekt .
CMFCFilterChunkValueImpl();
Uwagi
CMFCFilterChunkValueImpl::~CMFCFilterChunkValueImpl
Destrukuje obiekt.
virtual ~CMFCFilterChunkValueImpl();
Uwagi
CMFCFilterChunkValueImpl::CopyChunk
Kopiuje ten fragment do struktury opisującej cechy fragmentu.
HRESULT CopyChunk(STAT_CHUNK* pStatChunk);
Parametry
pStatChunk
Wskaźnik do wartości docelowej opisujący cechy fragmentu.
Wartość zwracana
S_OK w przypadku powodzenia; w przeciwnym razie kod błędu.
Uwagi
CMFCFilterChunkValueImpl::CopyFrom
Inicjuje tę wartość fragmentu z innej wartości.
void CopyFrom (IFilterChunkValue* pValue);
Parametry
pValue
Określa wartość źródłową do skopiowania.
Uwagi
CMFCFilterChunkValueImpl::GetChunkGUID
Pobiera identyfikator GUID fragmentu.
REFGUID GetChunkGUID() const;
Wartość zwracana
Odwołanie do identyfikatora GUID identyfikującego fragment.
Uwagi
CMFCFilterChunkValueImpl::GetChunkPID
Pobiera fragment PID (identyfikator właściwości).
DWORD GetChunkPID() const;
Wartość zwracana
Wartość DWORD zawierająca identyfikator właściwości.
Uwagi
CMFCFilterChunkValueImpl::GetChunkType
Pobiera typ fragmentu.
CHUNKSTATE GetChunkType() const;
Wartość zwracana
Wyliczona wartość CHUNKSTATE, która określa, czy bieżący fragment jest właściwością typu tekstowego, czy właściwością typu wartości.
Uwagi
CMFCFilterChunkValueImpl::GetString
Pobiera wartość ciągu.
CString &GetString();
Wartość zwracana
Ciąg zawierający wartość fragmentu.
Uwagi
CMFCFilterChunkValueImpl::GetValue
Pobiera wartość jako przydzielony propvariant.
HRESULT GetValue(PROPVARIANT** ppPropVariant);
Parametry
ppPropVariant
Gdy funkcja zwróci wartość fragmentu, ten parametr zawiera wartość fragmentu.
Wartość zwracana
S_OK, jeśli propVARIANT został pomyślnie przydzielony, a wartość fragmentu została pomyślnie skopiowana do elementu ppPropVariant; w przeciwnym razie kod błędu.
Uwagi
CMFCFilterChunkValueImpl::GetValueNoAlloc
Zwraca wartość nieprzydzielonej (wartość wewnętrzna).
PROPVARIANT GetValueNoAlloc ();
Wartość zwracana
Zwraca bieżącą wartość fragmentu.
Uwagi
CMFCFilterChunkValueImpl::IsValid
Sprawdza, czy ta wartość właściwości jest prawidłowa, czy nie.
BOOL IsValid() const;
Wartość zwracana
WARTOŚĆ TRUE, jeśli bieżąca wartość fragmentu jest prawidłowa; w przeciwnym razie FAŁSZ.
Uwagi
CMFCFilterChunkValueImpl::SetBoolValue
Przeciążone. Ustawia właściwość według klucza na wartość logiczną.
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
Określa klucz właściwości.
bVal
Określa wartość fragmentu do ustawienia.
typ fragmentu
Flagi wskazują, czy ten fragment zawiera właściwość typu tekstowego lub typu wartości. Wartości flagi są pobierane z wyliczenia CHUNKSTATE.
ustawienia regionalne
Język i podjęzyczność skojarzone z fragmentem tekstu. Ustawienia regionalne fragmentów są używane przez indeksatory dokumentów do prawidłowego łamania wyrazów tekstu. Jeśli fragment nie jest typem tekstowym ani typem wartości z typem danych VT_LPWSTR, VT_LPSTR lub VT_BSTR, to pole jest ignorowane.
cwcLenSource
Długość znaków tekstu źródłowego, z którego pochodzi bieżący fragment. Wartość zerowa oznacza znak po znaku między tekstem źródłowym a tekstem pochodnym. Wartość niezerowa oznacza, że taka bezpośrednia korespondencja nie istnieje.
cwcStartSource
Przesunięcie, z którego tekst źródłowy dla fragmentu pochodnego rozpoczyna się we fragmentu źródłowym.
typ fragmentuBreakType
Typ przerwania oddzielający poprzedni fragment od bieżącego fragmentu. Wartości pochodzą z wyliczenia CHUNK_BREAKTYPE.
Wartość zwracana
S_OK w przypadku powodzenia; w przeciwnym razie kod błędu.
Uwagi
CMFCFilterChunkValueImpl::SetChunk
Funkcja pomocnika, która ustawia typowe właściwości fragmentu.
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
Określa klucz właściwości.
typ fragmentu
Flagi wskazują, czy ten fragment zawiera właściwość typu tekstowego lub typu wartości. Wartości flagi są pobierane z wyliczenia CHUNKSTATE.
ustawienia regionalne
Język i podjęzyczność skojarzone z fragmentem tekstu. Ustawienia regionalne fragmentów są używane przez indeksatory dokumentów do prawidłowego łamania wyrazów tekstu. Jeśli fragment nie jest typem tekstowym ani typem wartości z typem danych VT_LPWSTR, VT_LPSTR lub VT_BSTR, to pole jest ignorowane.
cwcLenSource
Długość znaków tekstu źródłowego, z którego pochodzi bieżący fragment. Wartość zerowa oznacza znak po znaku między tekstem źródłowym a tekstem pochodnym. Wartość niezerowa oznacza, że taka bezpośrednia korespondencja nie istnieje.
cwcStartSource
Przesunięcie, z którego tekst źródłowy dla fragmentu pochodnego rozpoczyna się we fragmentu źródłowym.
typ fragmentuBreakType
Typ przerwania oddzielający poprzedni fragment od bieżącego fragmentu. Wartości pochodzą z wyliczenia CHUNK_BREAKTYPE.
Wartość zwracana
S_OK w przypadku powodzenia; w przeciwnym razie kod błędu.
Uwagi
CMFCFilterChunkValueImpl::SetDwordValue
Ustaw właściwość według klucza na WARTOŚĆ 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
Określa klucz właściwości.
dwVal
Określa wartość fragmentu do ustawienia.
typ fragmentu
Flagi wskazują, czy ten fragment zawiera właściwość typu tekstowego lub typu wartości. Wartości flagi są pobierane z wyliczenia CHUNKSTATE.
ustawienia regionalne
Język i podjęzyczność skojarzone z fragmentem tekstu. Ustawienia regionalne fragmentów są używane przez indeksatory dokumentów do prawidłowego łamania wyrazów tekstu. Jeśli fragment nie jest typem tekstowym ani typem wartości z typem danych VT_LPWSTR, VT_LPSTR lub VT_BSTR, to pole jest ignorowane.
cwcLenSource
Długość znaków tekstu źródłowego, z którego pochodzi bieżący fragment. Wartość zerowa oznacza znak po znaku między tekstem źródłowym a tekstem pochodnym. Wartość niezerowa oznacza, że taka bezpośrednia korespondencja nie istnieje.
cwcStartSource
Przesunięcie, z którego tekst źródłowy dla fragmentu pochodnego rozpoczyna się we fragmentu źródłowym.
typ fragmentuBreakType
Typ przerwania oddzielający poprzedni fragment od bieżącego fragmentu. Wartości pochodzą z wyliczenia CHUNK_BREAKTYPE.
Wartość zwracana
S_OK w przypadku powodzenia; w przeciwnym razie kod błędu.
Uwagi
CMFCFilterChunkValueImpl::SetFileTimeValue
Ustaw właściwość według klucza 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
Określa klucz właściwości.
dtVal
Określa wartość fragmentu do ustawienia.
typ fragmentu
Flagi wskazują, czy ten fragment zawiera właściwość typu tekstowego lub typu wartości. Wartości flagi są pobierane z wyliczenia CHUNKSTATE.
ustawienia regionalne
Język i podjęzyczność skojarzone z fragmentem tekstu. Ustawienia regionalne fragmentów są używane przez indeksatory dokumentów do prawidłowego łamania wyrazów tekstu. Jeśli fragment nie jest typem tekstowym ani typem wartości z typem danych VT_LPWSTR, VT_LPSTR lub VT_BSTR, to pole jest ignorowane.
cwcLenSource
Długość znaków tekstu źródłowego, z którego pochodzi bieżący fragment. Wartość zerowa oznacza znak po znaku między tekstem źródłowym a tekstem pochodnym. Wartość niezerowa oznacza, że taka bezpośrednia korespondencja nie istnieje.
cwcStartSource
Przesunięcie, z którego tekst źródłowy dla fragmentu pochodnego rozpoczyna się we fragmentu źródłowym.
typ fragmentuBreakType
Typ przerwania oddzielający poprzedni fragment od bieżącego fragmentu. Wartości pochodzą z wyliczenia CHUNK_BREAKTYPE.
Wartość zwracana
S_OK w przypadku powodzenia; w przeciwnym razie kod błędu.
Uwagi
CMFCFilterChunkValueImpl::SetInt64Value
Ustaw właściwość według klucza 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
Określa klucz właściwości.
nVal
Określa wartość fragmentu do ustawienia.
typ fragmentu
Flagi wskazują, czy ten fragment zawiera właściwość typu tekstowego lub typu wartości. Wartości flagi są pobierane z wyliczenia CHUNKSTATE.
ustawienia regionalne
Język i podjęzyczność skojarzone z fragmentem tekstu. Ustawienia regionalne fragmentów są używane przez indeksatory dokumentów do prawidłowego łamania wyrazów tekstu. Jeśli fragment nie jest typem tekstowym ani typem wartości z typem danych VT_LPWSTR, VT_LPSTR lub VT_BSTR, to pole jest ignorowane.
cwcLenSource
Długość znaków tekstu źródłowego, z którego pochodzi bieżący fragment. Wartość zerowa oznacza znak po znaku między tekstem źródłowym a tekstem pochodnym. Wartość niezerowa oznacza, że taka bezpośrednia korespondencja nie istnieje.
cwcStartSource
Przesunięcie, z którego tekst źródłowy dla fragmentu pochodnego rozpoczyna się we fragmentu źródłowym.
typ fragmentuBreakType
Typ przerwania oddzielający poprzedni fragment od bieżącego fragmentu. Wartości pochodzą z wyliczenia CHUNK_BREAKTYPE.
Wartość zwracana
S_OK w przypadku powodzenia; w przeciwnym razie kod błędu.
Uwagi
CMFCFilterChunkValueImpl::SetIntValue
Ustaw właściwość według klucza 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
Określa klucz właściwości.
nVal
Określa wartość fragmentu do ustawienia.
typ fragmentu
Flagi wskazują, czy ten fragment zawiera właściwość typu tekstowego lub typu wartości. Wartości flagi są pobierane z wyliczenia CHUNKSTATE.
ustawienia regionalne
Język i podjęzyczność skojarzone z fragmentem tekstu. Ustawienia regionalne fragmentów są używane przez indeksatory dokumentów do prawidłowego łamania wyrazów tekstu. Jeśli fragment nie jest typem tekstowym ani typem wartości z typem danych VT_LPWSTR, VT_LPSTR lub VT_BSTR, to pole jest ignorowane.
cwcLenSource
Długość znaków tekstu źródłowego, z którego pochodzi bieżący fragment. Wartość zerowa oznacza znak po znaku między tekstem źródłowym a tekstem pochodnym. Wartość niezerowa oznacza, że taka bezpośrednia korespondencja nie istnieje.
cwcStartSource
Przesunięcie, z którego tekst źródłowy dla fragmentu pochodnego rozpoczyna się we fragmentu źródłowym.
typ fragmentuBreakType
Typ przerwania oddzielający poprzedni fragment od bieżącego fragmentu. Wartości pochodzą z wyliczenia CHUNK_BREAKTYPE.
Wartość zwracana
S_OK w przypadku powodzenia; w przeciwnym razie kod błędu.
Uwagi
CMFCFilterChunkValueImpl::SetLongValue
Ustaw właściwość według klucza na WARTOŚĆ 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
Określa klucz właściwości.
lVal
Określa wartość fragmentu do ustawienia.
typ fragmentu
Flagi wskazują, czy ten fragment zawiera właściwość typu tekstowego lub typu wartości. Wartości flagi są pobierane z wyliczenia CHUNKSTATE.
ustawienia regionalne
Język i podjęzyczność skojarzone z fragmentem tekstu. Ustawienia regionalne fragmentów są używane przez indeksatory dokumentów do prawidłowego łamania wyrazów tekstu. Jeśli fragment nie jest typem tekstowym ani typem wartości z typem danych VT_LPWSTR, VT_LPSTR lub VT_BSTR, to pole jest ignorowane.
cwcLenSource
Długość znaków tekstu źródłowego, z którego pochodzi bieżący fragment. Wartość zerowa oznacza znak po znaku między tekstem źródłowym a tekstem pochodnym. Wartość niezerowa oznacza, że taka bezpośrednia korespondencja nie istnieje.
cwcStartSource
Przesunięcie, z którego tekst źródłowy dla fragmentu pochodnego rozpoczyna się we fragmentu źródłowym.
typ fragmentuBreakType
Typ przerwania oddzielający poprzedni fragment od bieżącego fragmentu. Wartości pochodzą z wyliczenia CHUNK_BREAKTYPE.
Wartość zwracana
S_OK w przypadku powodzenia; w przeciwnym razie kod błędu.
Uwagi
CMFCFilterChunkValueImpl::SetSystemTimeValue
Ustawia właściwość według klucza na Wartość 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
Określa klucz właściwości.
systemTime
Określa wartość fragmentu do ustawienia.
typ fragmentu
Flagi wskazują, czy ten fragment zawiera właściwość typu tekstowego lub typu wartości. Wartości flagi są pobierane z wyliczenia CHUNKSTATE.
ustawienia regionalne
Język i podjęzyczność skojarzone z fragmentem tekstu. Ustawienia regionalne fragmentów są używane przez indeksatory dokumentów do prawidłowego łamania wyrazów tekstu. Jeśli fragment nie jest typem tekstowym ani typem wartości z typem danych VT_LPWSTR, VT_LPSTR lub VT_BSTR, to pole jest ignorowane.
cwcLenSource
Długość znaków tekstu źródłowego, z którego pochodzi bieżący fragment. Wartość zerowa oznacza znak po znaku między tekstem źródłowym a tekstem pochodnym. Wartość niezerowa oznacza, że taka bezpośrednia korespondencja nie istnieje.
cwcStartSource
Przesunięcie, z którego tekst źródłowy dla fragmentu pochodnego rozpoczyna się we fragmentu źródłowym.
typ fragmentuBreakType
Typ przerwania oddzielający poprzedni fragment od bieżącego fragmentu. Wartości pochodzą z wyliczenia CHUNK_BREAKTYPE.
Wartość zwracana
S_OK w przypadku powodzenia; w przeciwnym razie kod błędu.
Uwagi
CMFCFilterChunkValueImpl::SetTextValue
Ustawia właściwość według klucza na ciąg 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
Określa klucz właściwości.
pszValue
Określa wartość fragmentu do ustawienia.
typ fragmentu
Flagi wskazują, czy ten fragment zawiera właściwość typu tekstowego lub typu wartości. Wartości flagi są pobierane z wyliczenia CHUNKSTATE.
ustawienia regionalne
Język i podjęzyczność skojarzone z fragmentem tekstu. Ustawienia regionalne fragmentów są używane przez indeksatory dokumentów do prawidłowego łamania wyrazów tekstu. Jeśli fragment nie jest typem tekstowym ani typem wartości z typem danych VT_LPWSTR, VT_LPSTR lub VT_BSTR, to pole jest ignorowane.
cwcLenSource
Długość znaków tekstu źródłowego, z którego pochodzi bieżący fragment. Wartość zerowa oznacza znak po znaku między tekstem źródłowym a tekstem pochodnym. Wartość niezerowa oznacza, że taka bezpośrednia korespondencja nie istnieje.
cwcStartSource
Przesunięcie, z którego tekst źródłowy dla fragmentu pochodnego rozpoczyna się we fragmentu źródłowym.
typ fragmentuBreakType
Typ przerwania oddzielający poprzedni fragment od bieżącego fragmentu. Wartości pochodzą z wyliczenia CHUNK_BREAKTYPE.
Wartość zwracana
S_OK w przypadku powodzenia; w przeciwnym razie kod błędu.