다음을 통해 공유


CMFCFilterChunkValueImpl 클래스

청크 및 속성 값 쌍 논리를 모두 간소화하는 클래스입니다.

구문

class CMFCFilterChunkValueImpl : public ATL::IFilterChunkValue;

멤버

공용 생성자

속성 설명
CMFCFilterChunkValueImpl::~CMFCFilterChunkValueImpl 개체를 소멸합니다.
CMFCFilterChunkValueImpl::CMFCFilterChunkValueImpl 개체를 생성합니다.

공용 메서드

이름 설명
CMFCFilterChunkValueImpl::Clear ChunkValue를 지웁니다.
CMFCFilterChunkValueImpl::CopyChunk 청크의 특성을 설명하는 구조체에 이 청크를 복사합니다.
CMFCFilterChunkValueImpl::CopyFrom 다른 값에서 이 청크 값을 초기화합니다.
CMFCFilterChunkValueImpl::GetChunkGUID 청크 GUID를 검색합니다.
CMFCFilterChunkValueImpl::GetChunkPID 청크 PID(속성 ID)를 검색합니다.
CMFCFilterChunkValueImpl::GetChunkType 청크 유형을 가져옵니다.
CMFCFilterChunkValueImpl::GetString 문자열 값을 검색합니다.
CMFCFilterChunkValueImpl::GetValue 값을 할당된 전파 변수로 검색합니다.
CMFCFilterChunkValueImpl::GetValueNoAlloc 할당하지 않은(내부 값) 값을 반환합니다.
CMFCFilterChunkValueImpl::IsValid 이 속성 값이 유효한지 여부를 확인합니다.
CMFCFilterChunkValueImpl::SetBoolValue 오버로드됨. 키로 속성을 부울로 설정합니다.
CMFCFilterChunkValueImpl::SetDwordValue 키별로 속성을 DWORD로 설정합니다.
CMFCFilterChunkValueImpl::SetFileTimeValue 키별 속성을 파일 시간으로 설정합니다.
CMFCFilterChunkValueImpl::SetInt64Value 키별로 속성을 int64로 설정합니다.
CMFCFilterChunkValueImpl::SetIntValue 속성 기준 키를 int로 설정합니다.
CMFCFilterChunkValueImpl::SetLongValue 속성 기준 키를 LONG으로 설정합니다.
CMFCFilterChunkValueImpl::SetSystemTimeValue 키별 속성을 SystemTime으로 설정합니다.
CMFCFilterChunkValueImpl::SetTextValue 키별 속성을 유니코드 문자열로 설정합니다.

보호된 메서드

속성 설명
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
청크의 특성을 설명하는 대상 값에 대한 포인터입니다.

Return Value

S_OK 성공하면

설명

CMFCFilterChunkValueImpl::CopyFrom

다른 값에서 이 청크 값을 초기화합니다.

void CopyFrom (IFilterChunkValue* pValue);

매개 변수

pValue
복사할 원본 값을 지정합니다.

설명

CMFCFilterChunkValueImpl::GetChunkGUID

청크 GUID를 검색합니다.

REFGUID GetChunkGUID() const;

Return Value

청크를 식별하는 GUID에 대한 참조입니다.

설명

CMFCFilterChunkValueImpl::GetChunkPID

청크 PID(속성 ID)를 검색합니다.

DWORD GetChunkPID() const;

Return Value

속성 ID를 포함하는 DWORD 값입니다.

설명

CMFCFilterChunkValueImpl::GetChunkType

청크 유형을 검색합니다.

CHUNKSTATE GetChunkType() const;

Return Value

현재 청크가 텍스트 형식 속성인지 아니면 값 형식 속성인지를 지정하는 CHUNKSTATE 열거형 값입니다.

설명

CMFCFilterChunkValueImpl::GetString

문자열 값을 검색합니다.

CString &GetString();

Return Value

청크 값을 포함하는 문자열입니다.

설명

CMFCFilterChunkValueImpl::GetValue

값을 할당된 전파 변수로 검색합니다.

HRESULT GetValue(PROPVARIANT** ppPropVariant);

매개 변수

ppPropVariant
함수가 반환되면 이 매개 변수에는 청크 값이 포함됩니다.

Return Value

PROPVARIANT가 성공적으로 할당되고 청크 값이 ppPropVariant성공적으로 복사되었는지 S_OK. 그렇지 않으면 오류 코드입니다.

설명

CMFCFilterChunkValueImpl::GetValueNoAlloc

할당하지 않은(내부 값) 값을 반환합니다.

PROPVARIANT GetValueNoAlloc ();

Return Value

현재 청크 값을 반환합니다.

설명

CMFCFilterChunkValueImpl::IsValid

이 속성 값이 유효한지 여부를 확인합니다.

BOOL IsValid() const;

Return Value

현재 청크 값이 유효한 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

CMFCFilterChunkValueImpl::SetBoolValue

오버로드됨. 키로 속성을 부울로 설정합니다.

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
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.

cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.

chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.

Return Value

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 열거형에서 가져옵니다.

로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.

cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.

cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.

chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.

Return Value

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 열거형에서 가져옵니다.

로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.

cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.

cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.

chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.

Return Value

S_OK 성공하면

설명

CMFCFilterChunkValueImpl::SetFileTimeValue

키별로 속성을 파일 시간으로 설정합니다.

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 열거형에서 가져옵니다.

로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.

cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.

cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.

chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.

Return Value

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 열거형에서 가져옵니다.

로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.

cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.

cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.

chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.

Return Value

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 열거형에서 가져옵니다.

로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.

cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.

cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.

chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.

Return Value

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 열거형에서 가져옵니다.

로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.

cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.

cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.

chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.

Return Value

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 열거형에서 가져옵니다.

로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.

cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.

cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.

chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.

Return Value

S_OK 성공하면

설명

CMFCFilterChunkValueImpl::SetTextValue

키별 속성을 유니코드 문자열로 설정합니다.

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 열거형에서 가져옵니다.

로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.

cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.

cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.

chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.

Return Value

S_OK 성공하면

설명

참고 항목

클래스