Condividi tramite

Classe CMFCFilterChunkValueImpl

  • Articolo

Si tratta di una classe che semplifica sia la logica della coppia di blocchi che della coppia di valori di proprietà.

Sintassi

class CMFCFilterChunkValueImpl : public ATL::IFilterChunkValue;

Membri

Costruttori pubblici

Nome Descrizione
CMFCFilterChunkValueImpl::~CMFCFilterChunkValueImpl Decostruisce l'oggetto .
CMFCFilterChunkValueImpl::CMFCFilterChunkValueImpl Costruisce l'oggetto.

Metodi pubblici

Nome Descrizione
CMFCFilterChunkValueImpl::Clear Cancella il valore ChunkValue.
CMFCFilterChunkValueImpl::CopyChunk Copia questo blocco in una struttura che descrive le caratteristiche di un blocco.
CMFCFilterChunkValueImpl::CopyFrom Inizializza questo valore di blocco dall'altro valore.
CMFCFilterChunkValueImpl::GetChunkGUID Recupera il GUID del blocco.
CMFCFilterChunkValueImpl::GetChunkPID Recupera il PID del blocco (ID proprietà).
CMFCFilterChunkValueImpl::GetChunkType Ottiene il tipo di blocco.
CMFCFilterChunkValueImpl::GetString Recupera il valore stringa.
CMFCFilterChunkValueImpl::GetValue Recupera il valore come propvariante allocato.
CMFCFilterChunkValueImpl::GetValueNoAlloc Restituisce un valore non allocato (valore interno).
CMFCFilterChunkValueImpl::IsValid Controlla se questo valore della proprietà è valido o meno.
CMFCFilterChunkValueImpl::SetBoolValue Con overload. Imposta la proprietà per chiave su un valore Boolean.
CMFCFilterChunkValueImpl::SetDwordValue Imposta la proprietà per chiave su un valore DWORD.
CMFCFilterChunkValueImpl::SetFileTimeValue Imposta la proprietà per chiave su un filetime.
CMFCFilterChunkValueImpl::SetInt64Value Imposta la proprietà per chiave su un valore int64.
CMFCFilterChunkValueImpl::SetIntValue Imposta la proprietà per chiave su un valore int.
CMFCFilterChunkValueImpl::SetLongValue Imposta la proprietà in base alla chiave su LONG.
CMFCFilterChunkValueImpl::SetSystemTimeValue Imposta la proprietà per chiave su systemTime.
CMFCFilterChunkValueImpl::SetTextValue Imposta la proprietà per chiave su una stringa Unicode.

Metodi protetti

Nome Descrizione
CMFCFilterChunkValueImpl::SetChunk Funzione helper che imposta le proprietà comuni del blocco.

Osservazioni:

Per usare, è sufficiente creare una classe CMFCFilterChunkValueImpl del tipo corretto

Esempio:

BLOCCO CMFCFilterChunkValueImpl;

hr = chunk. SetBoolValue(PKEY_IsAttachment, true);

or

hr = chunk. SetFileTimeValue(PKEY_ItemDate, ftLastModified);

Gerarchia di ereditarietà

ATL::IFilterChunkValue

CMFCFilterChunkValueImpl

Requisiti

Intestazione: afxwin.h

CMFCFilterChunkValueImpl::Clear

Cancella il valore ChunkValue.

void Clear();

Osservazioni:

CMFCFilterChunkValueImpl::CMFCFilterChunkValueImpl

Costruisce l'oggetto.

CMFCFilterChunkValueImpl();

Osservazioni:

CMFCFilterChunkValueImpl::~CMFCFilterChunkValueImpl

Decostruisce l'oggetto .

virtual ~CMFCFilterChunkValueImpl();

Osservazioni:

CMFCFilterChunkValueImpl::CopyChunk

Copia questo blocco in una struttura che descrive le caratteristiche di un blocco.

HRESULT CopyChunk(STAT_CHUNK* pStatChunk);

Parametri

pStatChunk
Puntatore al valore di destinazione che descrive le caratteristiche del blocco.

Valore restituito

S_OK se ha esito positivo; in caso contrario, un codice di errore.

Osservazioni:

CMFCFilterChunkValueImpl::CopyFrom

Inizializza questo valore di blocco dall'altro valore.

void CopyFrom (IFilterChunkValue* pValue);

Parametri

pValue
Specifica il valore di origine da cui copiare.

Osservazioni:

CMFCFilterChunkValueImpl::GetChunkGUID

Recupera il GUID del blocco.

REFGUID GetChunkGUID() const;

Valore restituito

Riferimento a un GUID che identifica il blocco.

Osservazioni:

CMFCFilterChunkValueImpl::GetChunkPID

Recupera il PID del blocco (ID proprietà).

DWORD GetChunkPID() const;

Valore restituito

Valore DWORD contenente l'ID proprietà.

Osservazioni:

CMFCFilterChunkValueImpl::GetChunkType

Recupera il tipo di blocco.

CHUNKSTATE GetChunkType() const;

Valore restituito

Valore enumerato CHUNKSTATE, che specifica se il blocco corrente è una proprietà di tipo testo o una proprietà di tipo valore.

Osservazioni:

CMFCFilterChunkValueImpl::GetString

Recupera il valore stringa.

CString &GetString();

Valore restituito

Stringa contenente il valore del blocco.

Osservazioni:

CMFCFilterChunkValueImpl::GetValue

Recupera il valore come propvariante allocato.

HRESULT GetValue(PROPVARIANT** ppPropVariant);

Parametri

ppPropVariant
Quando la funzione viene restituita, questo parametro contiene il valore del blocco.

Valore restituito

S_OK se PROPVARIANT è stato allocato correttamente e il valore del blocco è stato copiato correttamente in ppPropVariant; in caso contrario, un codice di errore.

Osservazioni:

CMFCFilterChunkValueImpl::GetValueNoAlloc

Restituisce il valore non allocato (valore interno).

PROPVARIANT GetValueNoAlloc ();

Valore restituito

Restituisce il valore del blocco corrente.

Osservazioni:

CMFCFilterChunkValueImpl::IsValid

Controlla se questo valore della proprietà è valido o meno.

BOOL IsValid() const;

Valore restituito

TRUE se il valore corrente del blocco è valido; in caso contrario FALSE.

Osservazioni:

CMFCFilterChunkValueImpl::SetBoolValue

Con overload. Imposta la proprietà per chiave su un valore Boolean.

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);

Parametri

pkey
Specifica una chiave di proprietà.

bVal
Specifica il valore del blocco da impostare.

chunkType
I flag indicano se questo blocco contiene un tipo di testo o una proprietà di tipo valore. I valori flag vengono ricavati dall'enumerazione CHUNKSTATE.

impostazioni locali
Lingua e sottolanguage associata a un blocco di testo. Le impostazioni locali dei blocchi vengono usate dagli indicizzatori di documenti per eseguire un'interruzione di parola corretta del testo. Se il blocco non è di tipo testo né di tipo valore con tipo di dati VT_LPWSTR, VT_LPSTR o VT_BSTR, questo campo viene ignorato.

cwcLenSource
Lunghezza in caratteri del testo di origine da cui è stato derivato il blocco corrente. Un valore zero indica la corrispondenza di caratteri per carattere tra il testo di origine e il testo derivato. Un valore diverso da zero indica che non esiste una corrispondenza diretta di questo tipo.

cwcStartSource
Offset da cui inizia il testo di origine per un blocco derivato nel blocco di origine.

chunkBreakType
Tipo di interruzione che separa il blocco precedente dal blocco corrente. I valori provengono dall'enumerazione CHUNK_BREAKTYPE.

Valore restituito

S_OK se ha esito positivo; in caso contrario, un codice di errore.

Osservazioni:

CMFCFilterChunkValueImpl::SetChunk

Funzione helper che imposta le proprietà comuni del blocco.

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

Parametri

pkey
Specifica una chiave di proprietà.

chunkType
I flag indicano se questo blocco contiene un tipo di testo o una proprietà di tipo valore. I valori flag vengono ricavati dall'enumerazione CHUNKSTATE.

impostazioni locali
Lingua e sottolanguage associata a un blocco di testo. Le impostazioni locali dei blocchi vengono usate dagli indicizzatori di documenti per eseguire un'interruzione di parola corretta del testo. Se il blocco non è di tipo testo né di tipo valore con tipo di dati VT_LPWSTR, VT_LPSTR o VT_BSTR, questo campo viene ignorato.

cwcLenSource
Lunghezza in caratteri del testo di origine da cui è stato derivato il blocco corrente. Un valore zero indica la corrispondenza di caratteri per carattere tra il testo di origine e il testo derivato. Un valore diverso da zero indica che non esiste una corrispondenza diretta di questo tipo.

cwcStartSource
Offset da cui inizia il testo di origine per un blocco derivato nel blocco di origine.

chunkBreakType
Tipo di interruzione che separa il blocco precedente dal blocco corrente. I valori provengono dall'enumerazione CHUNK_BREAKTYPE.

Valore restituito

S_OK se ha esito positivo; in caso contrario, codice di errore.

Osservazioni:

CMFCFilterChunkValueImpl::SetDwordValue

Impostare la proprietà per chiave su un valore 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);

Parametri

pkey
Specifica una chiave di proprietà.

dwVal
Specifica il valore del blocco da impostare.

chunkType
I flag indicano se questo blocco contiene un tipo di testo o una proprietà di tipo valore. I valori flag vengono ricavati dall'enumerazione CHUNKSTATE.

impostazioni locali
Lingua e sottolanguage associata a un blocco di testo. Le impostazioni locali dei blocchi vengono usate dagli indicizzatori di documenti per eseguire un'interruzione di parola corretta del testo. Se il blocco non è di tipo testo né di tipo valore con tipo di dati VT_LPWSTR, VT_LPSTR o VT_BSTR, questo campo viene ignorato.

cwcLenSource
Lunghezza in caratteri del testo di origine da cui è stato derivato il blocco corrente. Un valore zero indica la corrispondenza di caratteri per carattere tra il testo di origine e il testo derivato. Un valore diverso da zero indica che non esiste una corrispondenza diretta di questo tipo.

cwcStartSource
Offset da cui inizia il testo di origine per un blocco derivato nel blocco di origine.

chunkBreakType
Tipo di interruzione che separa il blocco precedente dal blocco corrente. I valori provengono dall'enumerazione CHUNK_BREAKTYPE.

Valore restituito

S_OK se ha esito positivo; in caso contrario, un codice di errore.

Osservazioni:

CMFCFilterChunkValueImpl::SetFileTimeValue

Impostare la proprietà per chiave su un 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);

Parametri

pkey
Specifica una chiave di proprietà.

dtVal
Specifica il valore del blocco da impostare.

chunkType
I flag indicano se questo blocco contiene un tipo di testo o una proprietà di tipo valore. I valori flag vengono ricavati dall'enumerazione CHUNKSTATE.

impostazioni locali
Lingua e sottolanguage associata a un blocco di testo. Le impostazioni locali dei blocchi vengono usate dagli indicizzatori di documenti per eseguire un'interruzione di parola corretta del testo. Se il blocco non è di tipo testo né di tipo valore con tipo di dati VT_LPWSTR, VT_LPSTR o VT_BSTR, questo campo viene ignorato.

cwcLenSource
Lunghezza in caratteri del testo di origine da cui è stato derivato il blocco corrente. Un valore zero indica la corrispondenza di caratteri per carattere tra il testo di origine e il testo derivato. Un valore diverso da zero indica che non esiste una corrispondenza diretta di questo tipo.

cwcStartSource
Offset da cui inizia il testo di origine per un blocco derivato nel blocco di origine.

chunkBreakType
Tipo di interruzione che separa il blocco precedente dal blocco corrente. I valori provengono dall'enumerazione CHUNK_BREAKTYPE.

Valore restituito

S_OK se ha esito positivo; in caso contrario, un codice di errore.

Osservazioni:

CMFCFilterChunkValueImpl::SetInt64Value

Impostare la proprietà per chiave su un valore 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);

Parametri

pkey
Specifica una chiave di proprietà.

nVal
Specifica il valore del blocco da impostare.

chunkType
I flag indicano se questo blocco contiene un tipo di testo o una proprietà di tipo valore. I valori flag vengono ricavati dall'enumerazione CHUNKSTATE.

impostazioni locali
Lingua e sottolanguage associata a un blocco di testo. Le impostazioni locali dei blocchi vengono usate dagli indicizzatori di documenti per eseguire un'interruzione di parola corretta del testo. Se il blocco non è di tipo testo né di tipo valore con tipo di dati VT_LPWSTR, VT_LPSTR o VT_BSTR, questo campo viene ignorato.

cwcLenSource
Lunghezza in caratteri del testo di origine da cui è stato derivato il blocco corrente. Un valore zero indica la corrispondenza di caratteri per carattere tra il testo di origine e il testo derivato. Un valore diverso da zero indica che non esiste una corrispondenza diretta di questo tipo.

cwcStartSource
Offset da cui inizia il testo di origine per un blocco derivato nel blocco di origine.

chunkBreakType
Tipo di interruzione che separa il blocco precedente dal blocco corrente. I valori provengono dall'enumerazione CHUNK_BREAKTYPE.

Valore restituito

S_OK se ha esito positivo; in caso contrario, un codice di errore.

Osservazioni:

CMFCFilterChunkValueImpl::SetIntValue

Impostare la proprietà per chiave su un valore 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);

Parametri

pkey
Specifica una chiave di proprietà.

nVal
Specifica il valore del blocco da impostare.

chunkType
I flag indicano se questo blocco contiene un tipo di testo o una proprietà di tipo valore. I valori flag vengono ricavati dall'enumerazione CHUNKSTATE.

impostazioni locali
Lingua e sottolanguage associata a un blocco di testo. Le impostazioni locali dei blocchi vengono usate dagli indicizzatori di documenti per eseguire un'interruzione di parola corretta del testo. Se il blocco non è di tipo testo né di tipo valore con tipo di dati VT_LPWSTR, VT_LPSTR o VT_BSTR, questo campo viene ignorato.

cwcLenSource
Lunghezza in caratteri del testo di origine da cui è stato derivato il blocco corrente. Un valore zero indica la corrispondenza di caratteri per carattere tra il testo di origine e il testo derivato. Un valore diverso da zero indica che non esiste una corrispondenza diretta di questo tipo.

cwcStartSource
Offset da cui inizia il testo di origine per un blocco derivato nel blocco di origine.

chunkBreakType
Tipo di interruzione che separa il blocco precedente dal blocco corrente. I valori provengono dall'enumerazione CHUNK_BREAKTYPE.

Valore restituito

S_OK se ha esito positivo; in caso contrario, un codice di errore.

Osservazioni:

CMFCFilterChunkValueImpl::SetLongValue

Impostare la proprietà per chiave su 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);

Parametri

pkey
Specifica una chiave di proprietà.

lVal
Specifica il valore del blocco da impostare.

chunkType
I flag indicano se questo blocco contiene un tipo di testo o una proprietà di tipo valore. I valori flag vengono ricavati dall'enumerazione CHUNKSTATE.

impostazioni locali
Lingua e sottolanguage associata a un blocco di testo. Le impostazioni locali dei blocchi vengono usate dagli indicizzatori di documenti per eseguire un'interruzione di parola corretta del testo. Se il blocco non è di tipo testo né di tipo valore con tipo di dati VT_LPWSTR, VT_LPSTR o VT_BSTR, questo campo viene ignorato.

cwcLenSource
Lunghezza in caratteri del testo di origine da cui è stato derivato il blocco corrente. Un valore zero indica la corrispondenza di caratteri per carattere tra il testo di origine e il testo derivato. Un valore diverso da zero indica che non esiste una corrispondenza diretta di questo tipo.

cwcStartSource
Offset da cui inizia il testo di origine per un blocco derivato nel blocco di origine.

chunkBreakType
Tipo di interruzione che separa il blocco precedente dal blocco corrente. I valori provengono dall'enumerazione CHUNK_BREAKTYPE.

Valore restituito

S_OK se ha esito positivo; in caso contrario, un codice di errore.

Osservazioni:

CMFCFilterChunkValueImpl::SetSystemTimeValue

Imposta la proprietà per chiave su 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);

Parametri

pkey
Specifica una chiave di proprietà.

systemTime
Specifica il valore del blocco da impostare.

chunkType
I flag indicano se questo blocco contiene un tipo di testo o una proprietà di tipo valore. I valori flag vengono ricavati dall'enumerazione CHUNKSTATE.

impostazioni locali
Lingua e sottolanguage associata a un blocco di testo. Le impostazioni locali dei blocchi vengono usate dagli indicizzatori di documenti per eseguire un'interruzione di parola corretta del testo. Se il blocco non è di tipo testo né di tipo valore con tipo di dati VT_LPWSTR, VT_LPSTR o VT_BSTR, questo campo viene ignorato.

cwcLenSource
Lunghezza in caratteri del testo di origine da cui è stato derivato il blocco corrente. Un valore zero indica la corrispondenza di caratteri per carattere tra il testo di origine e il testo derivato. Un valore diverso da zero indica che non esiste una corrispondenza diretta di questo tipo.

cwcStartSource
Offset da cui inizia il testo di origine per un blocco derivato nel blocco di origine.

chunkBreakType
Tipo di interruzione che separa il blocco precedente dal blocco corrente. I valori provengono dall'enumerazione CHUNK_BREAKTYPE.

Valore restituito

S_OK se ha esito positivo; in caso contrario, un codice di errore.

Osservazioni:

CMFCFilterChunkValueImpl::SetTextValue

Imposta la proprietà per chiave su una stringa 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);

Parametri

pkey
Specifica una chiave di proprietà.

pszValue
Specifica il valore del blocco da impostare.

chunkType
I flag indicano se questo blocco contiene un tipo di testo o una proprietà di tipo valore. I valori flag vengono ricavati dall'enumerazione CHUNKSTATE.

impostazioni locali
Lingua e sottolanguage associata a un blocco di testo. Le impostazioni locali dei blocchi vengono usate dagli indicizzatori di documenti per eseguire un'interruzione di parola corretta del testo. Se il blocco non è di tipo testo né di tipo valore con tipo di dati VT_LPWSTR, VT_LPSTR o VT_BSTR, questo campo viene ignorato.

cwcLenSource
Lunghezza in caratteri del testo di origine da cui è stato derivato il blocco corrente. Un valore zero indica la corrispondenza di caratteri per carattere tra il testo di origine e il testo derivato. Un valore diverso da zero indica che non esiste una corrispondenza diretta di questo tipo.

cwcStartSource
Offset da cui inizia il testo di origine per un blocco derivato nel blocco di origine.

chunkBreakType
Tipo di interruzione che separa il blocco precedente dal blocco corrente. I valori provengono dall'enumerazione CHUNK_BREAKTYPE.

Valore restituito

S_OK se ha esito positivo; in caso contrario, un codice di errore.

Osservazioni:

Vedi anche

Classi