THEME.savePreference

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método savePreference salva uma preferência no registro.

        theme.savePreference(theKey, theValue)

Parâmetros

theKey

Uma cadeia de caracteres que especifica a chave do valor de preferência a ser salva.

theValue

Uma cadeia de caracteres que especifica o valor a ser salvo.

Valor Retornado

Esse método não retorna um valor.

Comentários

Uma preferência é um par chave/valor que pode ser armazenado no registro para reter informações sobre o estado de Reprodutor Multimídia do Windows entre execuções. Esse recurso pode ser usado, por exemplo, para salvar as configurações de personalização para que elas não precisem ser inseridas novamente sempre que Reprodutor Multimídia do Windows for iniciada.

As preferências não são criptografadas e, portanto, não são um método seguro para manter os dados. Não use preferências para armazenar dados privados.

Exemplos

<THEME>
  <VIEW 
    id="View1" 
    onclose="jscript:theme.savePreference('drawer1','open');
             theme.savePreference('drawer2','close')">
  </VIEW>
</THEME>

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows versão 7.0 ou posterior

Confira também

Elemento THEME

THEME.loadPreference