CMFCFilterChunkValueImpl, classe
Il s’agit d’une classe qui simplifie à la fois la logique de paire segment et valeur de propriété.
Syntaxe
class CMFCFilterChunkValueImpl : public ATL::IFilterChunkValue;
Membres
Constructeurs publics
Nom | Description |
---|---|
CMFCFilterChunkValueImpl ::~CMFCFilterChunkValueImpl | Destructeur l’objet. |
CMFCFilterChunkValueImpl ::CMFCFilterChunkValueImpl | Construit l’objet. |
Méthodes publiques
Nom | Description |
---|---|
CMFCFilterChunkValueImpl ::Clear | Efface la valeur de bloc. |
CMFCFilterChunkValueImpl ::CopyChunk | Copie ce bloc dans une structure décrivant les caractéristiques d’un bloc. |
CMFCFilterChunkValueImpl ::CopyFrom | Initialise cette valeur de bloc à partir de l’autre valeur. |
CMFCFilterChunkValueImpl ::GetChunkGUID | Récupère le GUID de bloc. |
CMFCFilterChunkValueImpl ::GetChunkPID | Récupère le PID de bloc (ID de propriété). |
CMFCFilterChunkValueImpl ::GetChunkType | Obtient le type de bloc. |
CMFCFilterChunkValueImpl ::GetString | Récupère la valeur de chaîne. |
CMFCFilterChunkValueImpl ::GetValue | Récupère la valeur en tant que propvariant alloué. |
CMFCFilterChunkValueImpl ::GetValueNoAlloc | Retourne la valeur non allouée (valeur interne). |
CMFCFilterChunkValueImpl ::IsValid | Vérifie si cette valeur de propriété est valide ou non. |
CMFCFilterChunkValueImpl ::SetBoolValue | Surcharge. Définit la propriété par clé sur une valeur booléenne. |
CMFCFilterChunkValueImpl ::SetDwordValue | Définit la propriété par clé sur un DWORD. |
CMFCFilterChunkValueImpl ::SetFileTimeValue | Définit la propriété par clé sur un filetime. |
CMFCFilterChunkValueImpl ::SetInt64Value | Définit la propriété par clé sur un int64. |
CMFCFilterChunkValueImpl ::SetIntValue | Définit la propriété par clé sur un int. |
CMFCFilterChunkValueImpl ::SetLongValue | Définit la propriété par clé sur un type LONG. |
CMFCFilterChunkValueImpl ::SetSystemTimeValue | Définit la propriété par clé sur un SystemTime. |
CMFCFilterChunkValueImpl ::SetTextValue | Définit la propriété par clé sur une chaîne Unicode. |
Méthodes protégées
Nom | Description |
---|---|
CMFCFilterChunkValueImpl ::SetChunk | Fonction d’assistance qui définit les propriétés communes du bloc. |
Notes
Pour l’utiliser, vous créez simplement une classe CMFCFilterChunkValueImpl du type approprié
Exemple :
CMFCFilterChunkValueImpl bloc ;
hr = segment. SetBoolValue(PKEY_IsAttachment, true) ;
or
hr = segment. SetFileTimeValue(PKEY_ItemDate, ftLastModified) ;
Hiérarchie d'héritage
ATL::IFilterChunkValue
Spécifications
En-tête : afxwin.h
CMFCFilterChunkValueImpl ::Clear
Efface la valeur de bloc.
void Clear();
Notes
CMFCFilterChunkValueImpl ::CMFCFilterChunkValueImpl
Construit l’objet.
CMFCFilterChunkValueImpl();
Notes
CMFCFilterChunkValueImpl ::~CMFCFilterChunkValueImpl
Destructeur l’objet.
virtual ~CMFCFilterChunkValueImpl();
Notes
CMFCFilterChunkValueImpl ::CopyChunk
Copie ce bloc dans une structure décrivant les caractéristiques d’un bloc.
HRESULT CopyChunk(STAT_CHUNK* pStatChunk);
Paramètres
pStatChunk
Pointeur vers la valeur de destination décrivant les caractéristiques du bloc.
Valeur de retour
S_OK en cas de réussite ; sinon, un code d’erreur.
Notes
CMFCFilterChunkValueImpl ::CopyFrom
Initialise cette valeur de bloc à partir de l’autre valeur.
void CopyFrom (IFilterChunkValue* pValue);
Paramètres
pValue
Spécifie la valeur source à partir de laquelle copier.
Notes
CMFCFilterChunkValueImpl ::GetChunkGUID
Récupère le GUID de bloc.
REFGUID GetChunkGUID() const;
Valeur de retour
Référence à un GUID identifiant le bloc.
Notes
CMFCFilterChunkValueImpl ::GetChunkPID
Récupère le PID de bloc (ID de propriété).
DWORD GetChunkPID() const;
Valeur de retour
Valeur DWORD contenant l’ID de propriété.
Notes
CMFCFilterChunkValueImpl ::GetChunkType
Récupère le type de bloc.
CHUNKSTATE GetChunkType() const;
Valeur de retour
Valeur énumérée CHUNKSTATE, qui spécifie si le bloc actuel est une propriété de type texte ou une propriété de type valeur.
Notes
CMFCFilterChunkValueImpl ::GetString
Récupère la valeur de chaîne.
CString &GetString();
Valeur de retour
Chaîne contenant la valeur de bloc.
Notes
CMFCFilterChunkValueImpl ::GetValue
Récupère la valeur en tant que propvariant alloué.
HRESULT GetValue(PROPVARIANT** ppPropVariant);
Paramètres
ppPropVariant
Lorsque la fonction est retournée, ce paramètre contient la valeur de bloc.
Valeur de retour
S_OK si PROPVARIANT a été alloué correctement et que la valeur de bloc a été correctement copiée dans ppPropVariant ; sinon, un code d’erreur.
Notes
CMFCFilterChunkValueImpl ::GetValueNoAlloc
Retourne la valeur non allouée (valeur interne).
PROPVARIANT GetValueNoAlloc ();
Valeur de retour
Retourne la valeur de bloc actuelle.
Notes
CMFCFilterChunkValueImpl ::IsValid
Vérifie si cette valeur de propriété est valide ou non.
BOOL IsValid() const;
Valeur de retour
TRUE si la valeur de bloc actuelle est valide ; sinon FALSE.
Notes
CMFCFilterChunkValueImpl ::SetBoolValue
Surcharge. Définit la propriété par clé sur une valeur booléenne.
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);
Paramètres
pkey
Spécifie une clé de propriété.
bVal
Spécifie la valeur de bloc à définir.
chunkType
Les indicateurs indiquent si ce bloc contient un type de texte ou une propriété de type valeur. Les valeurs d’indicateur sont extraites de l’énumération CHUNKSTATE.
paramètres régionaux
Langue et sous-langue associées à un bloc de texte. Les paramètres régionaux de bloc sont utilisés par les indexeurs de documents pour effectuer une rupture de mot appropriée du texte. Si le bloc n’est ni de type texte ni de type valeur avec le type de données VT_LPWSTR, VT_LPSTR ou VT_BSTR, ce champ est ignoré.
cwcLenSource
Longueur en caractères du texte source à partir duquel le bloc actuel a été dérivé. Une valeur nulle signifie la correspondance caractère par caractère entre le texte source et le texte dérivé. Une valeur différente de zéro signifie qu’aucune correspondance directe n’existe.
cwcStartSource
Décalage à partir duquel le texte source d’un bloc dérivé démarre dans le bloc source.
chunkBreakType
Type de saut qui sépare le bloc précédent du bloc actuel. Les valeurs proviennent de l’énumération CHUNK_BREAKTYPE.
Valeur de retour
S_OK en cas de réussite ; sinon, un code d’erreur.
Notes
CMFCFilterChunkValueImpl ::SetChunk
Fonction d’assistance qui définit les propriétés communes du bloc.
HRESULT SetChunk(
REFPROPERTYKEY pkey,
CHUNKSTATE chunkType=CHUNK_VALUE,
LCID locale=0,
DWORD cwcLenSource=0,
DWORD cwcStartSource=0,
CHUNK_BREAKTYPE chunkBreakType=CHUNK_NO_BREAK);
Paramètres
pkey
Spécifie une clé de propriété.
chunkType
Les indicateurs indiquent si ce bloc contient un type de texte ou une propriété de type valeur. Les valeurs d’indicateur sont extraites de l’énumération CHUNKSTATE.
paramètres régionaux
Langue et sous-langue associées à un bloc de texte. Les paramètres régionaux de bloc sont utilisés par les indexeurs de documents pour effectuer une rupture de mot appropriée du texte. Si le bloc n’est ni de type texte ni de type valeur avec le type de données VT_LPWSTR, VT_LPSTR ou VT_BSTR, ce champ est ignoré.
cwcLenSource
Longueur en caractères du texte source à partir duquel le bloc actuel a été dérivé. Une valeur nulle signifie la correspondance caractère par caractère entre le texte source et le texte dérivé. Une valeur différente de zéro signifie qu’aucune correspondance directe n’existe.
cwcStartSource
Décalage à partir duquel le texte source d’un bloc dérivé démarre dans le bloc source.
chunkBreakType
Type de saut qui sépare le bloc précédent du bloc actuel. Les valeurs proviennent de l’énumération CHUNK_BREAKTYPE.
Valeur de retour
S_OK en cas de réussite ; sinon, code d’erreur.
Notes
CMFCFilterChunkValueImpl ::SetDwordValue
Définissez la propriété par clé sur un 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);
Paramètres
pkey
Spécifie une clé de propriété.
dwVal
Spécifie la valeur de bloc à définir.
chunkType
Les indicateurs indiquent si ce bloc contient un type de texte ou une propriété de type valeur. Les valeurs d’indicateur sont extraites de l’énumération CHUNKSTATE.
paramètres régionaux
Langue et sous-langue associées à un bloc de texte. Les paramètres régionaux de bloc sont utilisés par les indexeurs de documents pour effectuer une rupture de mot appropriée du texte. Si le bloc n’est ni de type texte ni de type valeur avec le type de données VT_LPWSTR, VT_LPSTR ou VT_BSTR, ce champ est ignoré.
cwcLenSource
Longueur en caractères du texte source à partir duquel le bloc actuel a été dérivé. Une valeur nulle signifie la correspondance caractère par caractère entre le texte source et le texte dérivé. Une valeur différente de zéro signifie qu’aucune correspondance directe n’existe.
cwcStartSource
Décalage à partir duquel le texte source d’un bloc dérivé démarre dans le bloc source.
chunkBreakType
Type de saut qui sépare le bloc précédent du bloc actuel. Les valeurs proviennent de l’énumération CHUNK_BREAKTYPE.
Valeur de retour
S_OK en cas de réussite ; sinon, un code d’erreur.
Notes
CMFCFilterChunkValueImpl ::SetFileTimeValue
Définissez la propriété par clé sur un fichiertime.
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);
Paramètres
pkey
Spécifie une clé de propriété.
dtVal
Spécifie la valeur de bloc à définir.
chunkType
Les indicateurs indiquent si ce bloc contient un type de texte ou une propriété de type valeur. Les valeurs d’indicateur sont extraites de l’énumération CHUNKSTATE.
paramètres régionaux
Langue et sous-langue associées à un bloc de texte. Les paramètres régionaux de bloc sont utilisés par les indexeurs de documents pour effectuer une rupture de mot appropriée du texte. Si le bloc n’est ni de type texte ni de type valeur avec le type de données VT_LPWSTR, VT_LPSTR ou VT_BSTR, ce champ est ignoré.
cwcLenSource
Longueur en caractères du texte source à partir duquel le bloc actuel a été dérivé. Une valeur nulle signifie la correspondance caractère par caractère entre le texte source et le texte dérivé. Une valeur différente de zéro signifie qu’aucune correspondance directe n’existe.
cwcStartSource
Décalage à partir duquel le texte source d’un bloc dérivé démarre dans le bloc source.
chunkBreakType
Type de saut qui sépare le bloc précédent du bloc actuel. Les valeurs proviennent de l’énumération CHUNK_BREAKTYPE.
Valeur de retour
S_OK en cas de réussite ; sinon, un code d’erreur.
Notes
CMFCFilterChunkValueImpl ::SetInt64Value
Définissez la propriété par clé sur un 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);
Paramètres
pkey
Spécifie une clé de propriété.
nVal
Spécifie la valeur de bloc à définir.
chunkType
Les indicateurs indiquent si ce bloc contient un type de texte ou une propriété de type valeur. Les valeurs d’indicateur sont extraites de l’énumération CHUNKSTATE.
paramètres régionaux
Langue et sous-langue associées à un bloc de texte. Les paramètres régionaux de bloc sont utilisés par les indexeurs de documents pour effectuer une rupture de mot appropriée du texte. Si le bloc n’est ni de type texte ni de type valeur avec le type de données VT_LPWSTR, VT_LPSTR ou VT_BSTR, ce champ est ignoré.
cwcLenSource
Longueur en caractères du texte source à partir duquel le bloc actuel a été dérivé. Une valeur nulle signifie la correspondance caractère par caractère entre le texte source et le texte dérivé. Une valeur différente de zéro signifie qu’aucune correspondance directe n’existe.
cwcStartSource
Décalage à partir duquel le texte source d’un bloc dérivé démarre dans le bloc source.
chunkBreakType
Type de saut qui sépare le bloc précédent du bloc actuel. Les valeurs proviennent de l’énumération CHUNK_BREAKTYPE.
Valeur de retour
S_OK en cas de réussite ; sinon, un code d’erreur.
Notes
CMFCFilterChunkValueImpl ::SetIntValue
Définissez la propriété par clé sur un 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);
Paramètres
pkey
Spécifie une clé de propriété.
nVal
Spécifie la valeur de bloc à définir.
chunkType
Les indicateurs indiquent si ce bloc contient un type de texte ou une propriété de type valeur. Les valeurs d’indicateur sont extraites de l’énumération CHUNKSTATE.
paramètres régionaux
Langue et sous-langue associées à un bloc de texte. Les paramètres régionaux de bloc sont utilisés par les indexeurs de documents pour effectuer une rupture de mot appropriée du texte. Si le bloc n’est ni de type texte ni de type valeur avec le type de données VT_LPWSTR, VT_LPSTR ou VT_BSTR, ce champ est ignoré.
cwcLenSource
Longueur en caractères du texte source à partir duquel le bloc actuel a été dérivé. Une valeur nulle signifie la correspondance caractère par caractère entre le texte source et le texte dérivé. Une valeur différente de zéro signifie qu’aucune correspondance directe n’existe.
cwcStartSource
Décalage à partir duquel le texte source d’un bloc dérivé démarre dans le bloc source.
chunkBreakType
Type de saut qui sépare le bloc précédent du bloc actuel. Les valeurs proviennent de l’énumération CHUNK_BREAKTYPE.
Valeur de retour
S_OK en cas de réussite ; sinon, un code d’erreur.
Notes
CMFCFilterChunkValueImpl ::SetLongValue
Définissez la propriété par clé sur un type 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);
Paramètres
pkey
Spécifie une clé de propriété.
lVal
Spécifie la valeur de bloc à définir.
chunkType
Les indicateurs indiquent si ce bloc contient un type de texte ou une propriété de type valeur. Les valeurs d’indicateur sont extraites de l’énumération CHUNKSTATE.
paramètres régionaux
Langue et sous-langue associées à un bloc de texte. Les paramètres régionaux de bloc sont utilisés par les indexeurs de documents pour effectuer une rupture de mot appropriée du texte. Si le bloc n’est ni de type texte ni de type valeur avec le type de données VT_LPWSTR, VT_LPSTR ou VT_BSTR, ce champ est ignoré.
cwcLenSource
Longueur en caractères du texte source à partir duquel le bloc actuel a été dérivé. Une valeur nulle signifie la correspondance caractère par caractère entre le texte source et le texte dérivé. Une valeur différente de zéro signifie qu’aucune correspondance directe n’existe.
cwcStartSource
Décalage à partir duquel le texte source d’un bloc dérivé démarre dans le bloc source.
chunkBreakType
Type de saut qui sépare le bloc précédent du bloc actuel. Les valeurs proviennent de l’énumération CHUNK_BREAKTYPE.
Valeur de retour
S_OK en cas de réussite ; sinon, un code d’erreur.
Notes
CMFCFilterChunkValueImpl ::SetSystemTimeValue
Définit la propriété par clé sur un 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);
Paramètres
pkey
Spécifie une clé de propriété.
systemTime
Spécifie la valeur de bloc à définir.
chunkType
Les indicateurs indiquent si ce bloc contient un type de texte ou une propriété de type valeur. Les valeurs d’indicateur sont extraites de l’énumération CHUNKSTATE.
paramètres régionaux
Langue et sous-langue associées à un bloc de texte. Les paramètres régionaux de bloc sont utilisés par les indexeurs de documents pour effectuer une rupture de mot appropriée du texte. Si le bloc n’est ni de type texte ni de type valeur avec le type de données VT_LPWSTR, VT_LPSTR ou VT_BSTR, ce champ est ignoré.
cwcLenSource
Longueur en caractères du texte source à partir duquel le bloc actuel a été dérivé. Une valeur nulle signifie la correspondance caractère par caractère entre le texte source et le texte dérivé. Une valeur différente de zéro signifie qu’aucune correspondance directe n’existe.
cwcStartSource
Décalage à partir duquel le texte source d’un bloc dérivé démarre dans le bloc source.
chunkBreakType
Type de saut qui sépare le bloc précédent du bloc actuel. Les valeurs proviennent de l’énumération CHUNK_BREAKTYPE.
Valeur de retour
S_OK en cas de réussite ; sinon, un code d’erreur.
Notes
CMFCFilterChunkValueImpl ::SetTextValue
Définit la propriété par clé sur une chaîne 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);
Paramètres
pkey
Spécifie une clé de propriété.
pszValue
Spécifie la valeur de bloc à définir.
chunkType
Les indicateurs indiquent si ce bloc contient un type de texte ou une propriété de type valeur. Les valeurs d’indicateur sont extraites de l’énumération CHUNKSTATE.
paramètres régionaux
Langue et sous-langue associées à un bloc de texte. Les paramètres régionaux de bloc sont utilisés par les indexeurs de documents pour effectuer une rupture de mot appropriée du texte. Si le bloc n’est ni de type texte ni de type valeur avec le type de données VT_LPWSTR, VT_LPSTR ou VT_BSTR, ce champ est ignoré.
cwcLenSource
Longueur en caractères du texte source à partir duquel le bloc actuel a été dérivé. Une valeur nulle signifie la correspondance caractère par caractère entre le texte source et le texte dérivé. Une valeur différente de zéro signifie qu’aucune correspondance directe n’existe.
cwcStartSource
Décalage à partir duquel le texte source d’un bloc dérivé démarre dans le bloc source.
chunkBreakType
Type de saut qui sépare le bloc précédent du bloc actuel. Les valeurs proviennent de l’énumération CHUNK_BREAKTYPE.
Valeur de retour
S_OK en cas de réussite ; sinon, un code d’erreur.