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

Metody publiczne

Metody chronione

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

CMFCFilterChunkValueImpl

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.

Uwagi

Zobacz też

Klasy