CMFCFilterChunkValueImpl 類別

發行項
08/04/2024

這是可簡化區塊和屬性值組邏輯的類別。

語法

class CMFCFilterChunkValueImpl : public ATL::IFilterChunkValue;

成員

公用建構函式

名稱	描述
CMFCFilterChunkValueImpl：：~CMFCFilterChunkValueImpl	解構物件。
CMFCFilterChunkValueImpl：：CMFCFilterChunkValueImpl	建構物件。

公用方法

名稱	描述
CMFCFilterChunkValueImpl：：Clear	清除 ChunkValue。
CMFCFilterChunkValueImpl：：CopyChunk	將此區塊複製到描述區塊特性的結構。
CMFCFilterChunkValueImpl：：CopyFrom	從其他值初始化這個區塊值。
CMFCFilterChunkValueImpl：：GetChunkGUID	擷取區塊 GUID。
CMFCFilterChunkValueImpl：：GetChunkPID	擷取區塊 PID （屬性識別符）。
CMFCFilterChunkValueImpl：：GetChunkType	取得區塊類型。
CMFCFilterChunkValueImpl：：GetString	擷取字串值。
CMFCFilterChunkValueImpl：：GetValue	擷取值做為配置的 propvariant。
CMFCFilterChunkValueImpl：：GetValueNoAlloc	傳回未配置的（內部值）值。
CMFCFilterChunkValueImpl：：IsValid	檢查這個屬性值是否有效。
CMFCFilterChunkValueImpl：：SetBoolValue	已多載。依索引鍵將屬性設定為 Boolean。
CMFCFilterChunkValueImpl：：SetDwordValue	依索引鍵將屬性設定為 DWORD。
CMFCFilterChunkValueImpl：：SetFileTimeValue	依索引鍵將屬性設定為 filetime。
CMFCFilterChunkValueImpl：：SetInt64Value	依索引鍵將屬性設定為int64。
CMFCFilterChunkValueImpl：：SetIntValue	依索引鍵將屬性設定為 int。
CMFCFilterChunkValueImpl：：SetLongValue	依索引鍵將屬性設定為 LONG。
CMFCFilterChunkValueImpl：：SetSystemTimeValue	依索引鍵將屬性設定為 SystemTime。
CMFCFilterChunkValueImpl：：SetTextValue	依索引鍵將屬性設定為 Unicode 字串。

受保護的方法

名稱	描述
CMFCFilterChunkValueImpl：：SetChunk	設定區塊通用屬性的協助程式函式。

備註

若要使用，您只需建立正確的 CMFCFilterChunkValueImpl 類別

範例：

CMFCFilterChunkValueImpl 區塊;

hr = 區塊。SetBoolValue（PKEY_IsAttachment，true）：

或

hr = 區塊。SetFileTimeValue（PKEY_ItemDate，ftLastModified）：

繼承階層架構

ATL::IFilterChunkValue

CMFCFilterChunkValueImpl

需求

標題: afxwin.h

CMFCFilterChunkValueImpl：：Clear

清除 ChunkValue。

void Clear();

備註

CMFCFilterChunkValueImpl：：CMFCFilterChunkValueImpl

建構物件。

CMFCFilterChunkValueImpl();

備註

CMFCFilterChunkValueImpl：：~CMFCFilterChunkValueImpl

解構物件。

virtual ~CMFCFilterChunkValueImpl();

備註

CMFCFilterChunkValueImpl：：CopyChunk

將此區塊複製到描述區塊特性的結構。

HRESULT CopyChunk(STAT_CHUNK* pStatChunk);

參數

pStatChunk
描述區塊特性的目的地值的指標。

傳回值

如果成功，S_OK;否則為錯誤碼。

備註

CMFCFilterChunkValueImpl：：CopyFrom

從其他值初始化這個區塊值。

void CopyFrom (IFilterChunkValue* pValue);

參數

pValue
指定要複製的來源值。

備註

CMFCFilterChunkValueImpl：：GetChunkGUID

擷取區塊 GUID。

REFGUID GetChunkGUID() const;

傳回值

識別區塊之 GUID 的參考。

備註

CMFCFilterChunkValueImpl：：GetChunkPID

擷取區塊 PID （屬性識別符）。

DWORD GetChunkPID() const;

傳回值

包含屬性識別碼的 DWORD 值。

備註

CMFCFilterChunkValueImpl：：GetChunkType

擷取區塊類型。

CHUNKSTATE GetChunkType() const;

傳回值

CHUNKSTATE 列舉值，指定目前的區塊是文字類型屬性還是實值型別屬性。

備註

CMFCFilterChunkValueImpl：：GetString

擷取字串值。

CString &GetString();

傳回值

包含區塊值的字串。

備註

CMFCFilterChunkValueImpl：：GetValue

擷取值做為配置的 propvariant。

HRESULT GetValue(PROPVARIANT** ppPropVariant);

參數

ppPropVariant
當函式傳回時，此參數會包含區塊值。

傳回值

S_OK如果 PROPVARIANT 已順利配置，且區塊值已成功複製到 ppPropVariant，則為，否則為錯誤碼。

備註

CMFCFilterChunkValueImpl：：GetValueNoAlloc

傳回未配置的（內部值）值。

PROPVARIANT GetValueNoAlloc ();

傳回值

傳回目前的區塊值。

備註

CMFCFilterChunkValueImpl：：IsValid

檢查這個屬性值是否有效。

BOOL IsValid() const;

傳回值

如果目前的區塊值有效，則為TRUE;否則為 FALSE。

備註

CMFCFilterChunkValueImpl：：SetBoolValue

已多載。依索引鍵將屬性設定為 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);

參數

pkey
指定屬性索引鍵。

bVal
指定要設定的區塊值。

chunkType
旗標指出此區塊是否包含文字類型或實值型別屬性。旗標值取自 CHUNKSTATE 列舉。

地區設定
與文字區塊相關聯的語言和子語言。檔索引器會使用區塊地區設定來執行適當的文字斷詞。如果區塊既不是文字類型，也不是數據類型為實值型別，VT_LPWSTR、VT_LPSTR或VT_BSTR，則會忽略此字段。

cwcLenSource
衍生目前區塊的來源文字字元長度。零值表示來源文字與衍生文字之間的逐字元對應。非零值表示不存在這類直接對應。

cwcStartSource
衍生區塊的來源文字開始於來源區塊中的位移。

chunkBreakType
分隔上一個區塊與目前區塊的中斷類型。值來自CHUNK_BREAKTYPE列舉。

傳回值

如果成功，S_OK;否則為錯誤碼。

備註

CMFCFilterChunkValueImpl：：SetChunk

設定區塊通用屬性的協助程式函式。

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

參數

pkey
指定屬性索引鍵。

chunkType
旗標指出此區塊是否包含文字類型或實值型別屬性。旗標值取自 CHUNKSTATE 列舉。

cwcLenSource
衍生目前區塊的來源文字字元長度。零值表示來源文字與衍生文字之間的逐字元對應。非零值表示不存在這類直接對應。

cwcStartSource
衍生區塊的來源文字開始於來源區塊中的位移。

chunkBreakType
分隔上一個區塊與目前區塊的中斷類型。值來自CHUNK_BREAKTYPE列舉。

傳回值

如果成功，S_OK;否則為錯誤碼。

備註

CMFCFilterChunkValueImpl：：SetDwordValue

依索引鍵將屬性設定為 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);

參數

pkey
指定屬性索引鍵。

dwVal
指定要設定的區塊值。

chunkType
旗標指出此區塊是否包含文字類型或實值型別屬性。旗標值取自 CHUNKSTATE 列舉。

cwcLenSource
衍生目前區塊的來源文字字元長度。零值表示來源文字與衍生文字之間的逐字元對應。非零值表示不存在這類直接對應。

cwcStartSource
衍生區塊的來源文字開始於來源區塊中的位移。

chunkBreakType
分隔上一個區塊與目前區塊的中斷類型。值來自CHUNK_BREAKTYPE列舉。

傳回值

如果成功，S_OK;否則為錯誤碼。

備註

CMFCFilterChunkValueImpl：：SetFileTimeValue

依索引鍵將屬性設定為 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);

參數

pkey
指定屬性索引鍵。

dtVal
指定要設定的區塊值。

chunkType
旗標指出此區塊是否包含文字類型或實值型別屬性。旗標值取自 CHUNKSTATE 列舉。

cwcLenSource
衍生目前區塊的來源文字字元長度。零值表示來源文字與衍生文字之間的逐字元對應。非零值表示不存在這類直接對應。

cwcStartSource
衍生區塊的來源文字開始於來源區塊中的位移。

chunkBreakType
分隔上一個區塊與目前區塊的中斷類型。值來自CHUNK_BREAKTYPE列舉。

傳回值

如果成功，S_OK;否則為錯誤碼。

備註

CMFCFilterChunkValueImpl：：SetInt64Value

依索引鍵將屬性設定為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);

參數

pkey
指定屬性索引鍵。

nVal
指定要設定的區塊值。

chunkType
旗標指出此區塊是否包含文字類型或實值型別屬性。旗標值取自 CHUNKSTATE 列舉。

cwcLenSource
衍生目前區塊的來源文字字元長度。零值表示來源文字與衍生文字之間的逐字元對應。非零值表示不存在這類直接對應。

cwcStartSource
衍生區塊的來源文字開始於來源區塊中的位移。

chunkBreakType
分隔上一個區塊與目前區塊的中斷類型。值來自CHUNK_BREAKTYPE列舉。

傳回值

如果成功，S_OK;否則為錯誤碼。

備註

CMFCFilterChunkValueImpl：：SetIntValue

依索引鍵將屬性設定為 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);

參數

pkey
指定屬性索引鍵。

nVal
指定要設定的區塊值。

chunkType
旗標指出此區塊是否包含文字類型或實值型別屬性。旗標值取自 CHUNKSTATE 列舉。

cwcLenSource
衍生目前區塊的來源文字字元長度。零值表示來源文字與衍生文字之間的逐字元對應。非零值表示不存在這類直接對應。

cwcStartSource
衍生區塊的來源文字開始於來源區塊中的位移。

chunkBreakType
分隔上一個區塊與目前區塊的中斷類型。值來自CHUNK_BREAKTYPE列舉。

傳回值

如果成功，S_OK;否則為錯誤碼。

備註

CMFCFilterChunkValueImpl：：SetLongValue

依索引鍵將屬性設定為 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);

參數

pkey
指定屬性索引鍵。

lVal
指定要設定的區塊值。

chunkType
旗標指出此區塊是否包含文字類型或實值型別屬性。旗標值取自 CHUNKSTATE 列舉。

cwcLenSource
衍生目前區塊的來源文字字元長度。零值表示來源文字與衍生文字之間的逐字元對應。非零值表示不存在這類直接對應。

cwcStartSource
衍生區塊的來源文字開始於來源區塊中的位移。

chunkBreakType
分隔上一個區塊與目前區塊的中斷類型。值來自CHUNK_BREAKTYPE列舉。

傳回值

如果成功，S_OK;否則為錯誤碼。

備註

CMFCFilterChunkValueImpl：：SetSystemTimeValue

依索引鍵將屬性設定為 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);

參數

pkey
指定屬性索引鍵。

systemTime
指定要設定的區塊值。

chunkType
旗標指出此區塊是否包含文字類型或實值型別屬性。旗標值取自 CHUNKSTATE 列舉。

cwcLenSource
衍生目前區塊的來源文字字元長度。零值表示來源文字與衍生文字之間的逐字元對應。非零值表示不存在這類直接對應。

cwcStartSource
衍生區塊的來源文字開始於來源區塊中的位移。

chunkBreakType
分隔上一個區塊與目前區塊的中斷類型。值來自CHUNK_BREAKTYPE列舉。

傳回值

如果成功，S_OK;否則為錯誤碼。

備註

CMFCFilterChunkValueImpl：：SetTextValue

依索引鍵將屬性設定為 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);

參數

pkey
指定屬性索引鍵。

pszValue
指定要設定的區塊值。

chunkType
旗標指出此區塊是否包含文字類型或實值型別屬性。旗標值取自 CHUNKSTATE 列舉。

cwcLenSource
衍生目前區塊的來源文字字元長度。零值表示來源文字與衍生文字之間的逐字元對應。非零值表示不存在這類直接對應。

cwcStartSource
衍生區塊的來源文字開始於來源區塊中的位移。

chunkBreakType
分隔上一個區塊與目前區塊的中斷類型。值來自CHUNK_BREAKTYPE列舉。

共用方式為

CMFCFilterChunkValueImpl 類別

語法

成員

公用建構函式

公用方法

受保護的方法

備註

繼承階層架構

需求

CMFCFilterChunkValueImpl：：Clear

備註

CMFCFilterChunkValueImpl：：CMFCFilterChunkValueImpl

備註

CMFCFilterChunkValueImpl：：~CMFCFilterChunkValueImpl

備註

CMFCFilterChunkValueImpl：：CopyChunk

參數

傳回值

備註

CMFCFilterChunkValueImpl：：CopyFrom

參數

備註

CMFCFilterChunkValueImpl：：GetChunkGUID

傳回值

備註

CMFCFilterChunkValueImpl：：GetChunkPID

傳回值

備註

CMFCFilterChunkValueImpl：：GetChunkType

傳回值

備註

CMFCFilterChunkValueImpl：：GetString

傳回值

備註

CMFCFilterChunkValueImpl：：GetValue

參數

傳回值

備註

CMFCFilterChunkValueImpl：：GetValueNoAlloc

傳回值

備註

CMFCFilterChunkValueImpl：：IsValid

傳回值

備註

CMFCFilterChunkValueImpl：：SetBoolValue

參數

傳回值

備註

CMFCFilterChunkValueImpl：：SetChunk

參數

傳回值

備註

CMFCFilterChunkValueImpl：：SetDwordValue

參數

傳回值

備註

CMFCFilterChunkValueImpl：：SetFileTimeValue

參數

傳回值

備註

CMFCFilterChunkValueImpl：：SetInt64Value

參數

傳回值

備註

CMFCFilterChunkValueImpl：：SetIntValue

參數

傳回值

備註

CMFCFilterChunkValueImpl：：SetLongValue

參數

傳回值

備註

CMFCFilterChunkValueImpl：：SetSystemTimeValue

參數

傳回值

備註

CMFCFilterChunkValueImpl：：SetTextValue

參數

傳回值