CPropExchange::ExchangeProp

Artigo
08/25/2010

Uma propriedade entre uma meio de armazenamento e o controle de troca.

virtual BOOL ExchangeProp(
   LPCTSTR pszPropName,
   VARTYPE vtProp,
   void* pvProp,
   const void* pvDefault = NULL 
) = 0;

Parâmetros

pszPropName
O nome da propriedade que está sendo trocado.
vtProp
Um símbolo especificando o tipo de propriedade que está sendo trocado.Os valores possíveis são:

Símbolo

Tipo da propriedade

VT_I2

short

VT_I4

long

VT_BOOL

BOOL

VT_BSTR

CString

VT_CY

CY

VT_R4

float

VT_R8

double
pvProp
Um ponteiro para o valor da propriedade.
pvDefault
Ponteiro para um valor padrão para a propriedade.

Símbolo	Tipo da propriedade
VT_I2	short
VT_I4	long
VT_BOOL	BOOL
VT_BSTR	CString
VT_CY	CY
VT_R4	float
VT_R8	double

Valor de retorno

Diferente de zero se a troca foi bem-sucedida; 0 se não houver êxito.

Comentários

Se a propriedade estiver sendo carregada a partir da meio de para o controle, o valor da propriedade é recuperado da meio e armazenado no objeto apontado por pvProp. Se a propriedade está sendo armazenada na meio, o valor do objeto apontado por pvProp são gravados de meio porte.

As funções CArchivePropExchange::ExchangeProp, CResetPropExchange::ExchangeProp, and CPropsetPropExchange::ExchangeProp substituem essa função virtual pura.