CPropExchange::ExchangeProp

Artigo
02/25/2013

Troca uma propriedade entre um meio de armazenamento e o controle.

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

Parâmetros

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

Símbolo

Tipo de 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 de 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 tenha êxito; 0 se malsucedido.

Comentários

Se a propriedade está sendo carregada do meio para o controle, o valor da propriedade é recuperado do meio e armazenado no objeto apontado por pvProp.Se a propriedade está sendo armazenado em mídias, o valor do objeto apontado por pvProp é escrito no meio.

As funções CArchivePropExchange::ExchangeProp, substituição de CResetPropExchange::ExchangeProp, e de CPropsetPropExchange::ExchangeProp essa função virtual pura.