Partilhar via


FrameworkPropertyMetadata Construtores

Definição

Inicializa uma nova instância da classe FrameworkPropertyMetadata.

Sobrecargas

FrameworkPropertyMetadata()

Inicializa uma nova instância da classe FrameworkPropertyMetadata.

FrameworkPropertyMetadata(Object)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o valor padrão especificado.

FrameworkPropertyMetadata(PropertyChangedCallback)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o retorno de chamada PropertyChangedCallback especificado.

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o valor padrão e as opções de metadados em nível da estrutura fornecidos.

FrameworkPropertyMetadata(Object, PropertyChangedCallback)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o valor padrão fornecido e o retorno de chamada PropertyChangedCallback especificado.

FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com os retornos de chamada especificados.

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o valor padrão e as opções de metadados da estrutura fornecidos, bem como o retorno de chamada PropertyChangedCallback especificado.

FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o valor padrão fornecido e os retornos de chamada especificados.

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o valor padrão e as opções de metadados da estrutura fornecidos, bem como os retornos de chamada especificados.

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o valor padrão e as opções de metadados da estrutura fornecidos, os retornos de chamada especificados e um booliano que pode ser usado para impedir a animação da propriedade.

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o valor padrão e as opções de metadados da estrutura fornecidos, os retornos de chamada especificados, um booliano que pode ser usado para impedir a animação da propriedade e um padrão de gatilho de atualização com associação de dados.

FrameworkPropertyMetadata()

Inicializa uma nova instância da classe FrameworkPropertyMetadata.

public:
 FrameworkPropertyMetadata();
public FrameworkPropertyMetadata ();
Public Sub New ()

Comentários

Essa assinatura inicializa todos os valores de FrameworkPropertyMetadata para seus padrões de propriedade. DefaultValue será nulle as várias FrameworkPropertyMetadata propriedades boolianas serão false.

Confira também

Aplica-se a

FrameworkPropertyMetadata(Object)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o valor padrão especificado.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue);
public FrameworkPropertyMetadata (object defaultValue);
new System.Windows.FrameworkPropertyMetadata : obj -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object)

Parâmetros

defaultValue
Object

O valor padrão da propriedade de dependência, geralmente, fornecido como um valor de um tipo específico.

Exceções

defaultValue é definido como UnsetValue.

Exemplos

O exemplo a seguir chama essa assinatura de construtor:

static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(Double.NaN);

Comentários

O tipo do valor fornecido para defaultValue deve corresponder ou estar relacionado ao tipo especificado no registro original da propriedade de dependência à qual esses metadados serão aplicados. As incompatibilidades entre o tipo de valor padrão de metadados e o tipo da propriedade de dependência à qual ela está sendo aplicada podem ser difíceis de depurar, pois a incompatibilidade não é detectável durante a compilação. O sistema de propriedades não avalia o valor efetivo de uma propriedade até o tempo de execução, portanto, o resultado de uma incompatibilidade de tipo de propriedade/tipo de valor padrão é um erro em tempo de execução.

O valor UnsetValue tem um significado especial no sistema de propriedades e não pode ser usado como um valor padrão da propriedade de dependência.

Confira também

Aplica-se a

FrameworkPropertyMetadata(PropertyChangedCallback)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o retorno de chamada PropertyChangedCallback especificado.

public:
 FrameworkPropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback);
public FrameworkPropertyMetadata (System.Windows.PropertyChangedCallback propertyChangedCallback);
new System.Windows.FrameworkPropertyMetadata : System.Windows.PropertyChangedCallback -> System.Windows.FrameworkPropertyMetadata
Public Sub New (propertyChangedCallback As PropertyChangedCallback)

Parâmetros

propertyChangedCallback
PropertyChangedCallback

Uma referência a uma implementação do manipulador que será chamada pelo sistema de propriedades sempre que o valor efetivo da propriedade for alterado.

Exemplos

O exemplo a seguir chama essa assinatura de construtor:

static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(new PropertyChangedCallback(OnCurrentReadingChanged));

Aplica-se a

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o valor padrão e as opções de metadados em nível da estrutura fornecidos.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags);
public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags);
new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions)

Parâmetros

defaultValue
Object

O valor padrão da propriedade de dependência, geralmente, fornecido como um valor de um tipo específico.

flags
FrameworkPropertyMetadataOptions

Os sinalizadores de opção de metadados (uma combinação de valores FrameworkPropertyMetadataOptions). Essas opções especificam características da propriedade de dependência que interagem com sistemas, como layout ou vinculação de dados.

Exceções

defaultValue é definido como UnsetValue.

Exemplos

O exemplo a seguir chama essa assinatura de construtor:

static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault)
);

Comentários

O tipo do valor fornecido para defaultValue deve corresponder ou estar relacionado ao tipo especificado no registro original da propriedade de dependência à qual esses metadados serão aplicados. As incompatibilidades entre o tipo de valor padrão de metadados e o tipo da propriedade de dependência à qual ela está sendo aplicada podem ser difíceis de depurar, pois a incompatibilidade não é detectável durante a compilação. O sistema de propriedades não avalia o valor efetivo de uma propriedade até o tempo de execução, portanto, o resultado de uma incompatibilidade de tipo de propriedade/tipo de valor padrão é um erro em tempo de execução.

O valor UnsetValue tem um significado especial no sistema de propriedades e não pode ser usado como um valor padrão da propriedade de dependência.

Valores marcados como sinalizadores definidos no flags parâmetro definirão o valor booliano das FrameworkPropertyMetadata propriedades que correspondem FrameworkPropertyMetadataOptions ao nome desse sinalizador como true. Posteriormente, você pode alterar os valores das propriedades nos metadados, desde que os metadados ainda não sejam aplicados a uma operação específica do sistema de propriedades.

Confira também

Aplica-se a

FrameworkPropertyMetadata(Object, PropertyChangedCallback)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o valor padrão fornecido e o retorno de chamada PropertyChangedCallback especificado.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback);
public FrameworkPropertyMetadata (object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback);
new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.PropertyChangedCallback -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback)

Parâmetros

defaultValue
Object

O valor padrão da propriedade de dependência, geralmente, fornecido como um valor de um tipo específico.

propertyChangedCallback
PropertyChangedCallback

Uma referência a uma implementação do manipulador que será chamada pelo sistema de propriedades sempre que o valor efetivo da propriedade for alterado.

Exceções

defaultValue é definido como UnsetValue.

Exemplos

O exemplo a seguir chama essa assinatura de construtor:

static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged)
);

Comentários

O tipo do valor fornecido para defaultValue deve corresponder ou estar relacionado ao tipo especificado no registro original da propriedade de dependência à qual esses metadados serão aplicados. As incompatibilidades entre o tipo de valor padrão de metadados e o tipo da propriedade de dependência à qual ela está sendo aplicada podem ser difíceis de depurar, pois a incompatibilidade não é detectável durante a compilação. O sistema de propriedades não avalia o valor efetivo de uma propriedade até o tempo de execução, portanto, o resultado de uma incompatibilidade de tipo de propriedade/tipo de valor padrão é um erro em tempo de execução.

O valor UnsetValue tem um significado especial no sistema de propriedades e não pode ser usado como um valor padrão da propriedade de dependência.

Confira também

Aplica-se a

FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com os retornos de chamada especificados.

public:
 FrameworkPropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);
public FrameworkPropertyMetadata (System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);
new System.Windows.FrameworkPropertyMetadata : System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.FrameworkPropertyMetadata
Public Sub New (propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)

Parâmetros

propertyChangedCallback
PropertyChangedCallback

Uma referência a uma implementação do manipulador que será chamada pelo sistema de propriedades sempre que o valor efetivo da propriedade for alterado.

coerceValueCallback
CoerceValueCallback

Uma referência a uma implementação de manipulador será chamada sempre que o sistema de propriedades chamar CoerceValue(DependencyProperty) para essa propriedade de dependência.

Exemplos

O exemplo a seguir chama essa assinatura de construtor:

static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

Comentários

Essa implementação chama um inicializador base e adiciona o coerceValueCallback definindo a propriedade na instância base.

Confira também

Aplica-se a

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o valor padrão e as opções de metadados da estrutura fornecidos, bem como o retorno de chamada PropertyChangedCallback especificado.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback);
public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback);
new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback)

Parâmetros

defaultValue
Object

O valor padrão da propriedade de dependência, geralmente, fornecido como um valor de um tipo específico.

flags
FrameworkPropertyMetadataOptions

Os sinalizadores de opção de metadados (uma combinação de valores FrameworkPropertyMetadataOptions). Essas opções especificam características da propriedade de dependência que interagem com sistemas, como layout ou vinculação de dados.

propertyChangedCallback
PropertyChangedCallback

Uma referência a uma implementação do manipulador que será chamada pelo sistema de propriedades sempre que o valor efetivo da propriedade for alterado.

Exceções

defaultValue é definido como UnsetValue.

Exemplos

O exemplo a seguir chama essa assinatura de construtor:

static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged)
);

Comentários

O tipo do valor fornecido para defaultValue deve corresponder ou estar relacionado ao tipo especificado no registro original da propriedade de dependência à qual esses metadados serão aplicados. As incompatibilidades entre o tipo de valor padrão de metadados e o tipo da propriedade de dependência à qual ela está sendo aplicada podem ser difíceis de depurar, pois a incompatibilidade não é detectável durante a compilação. O sistema de propriedades não avalia o valor efetivo de uma propriedade até o tempo de execução, portanto, o resultado de uma incompatibilidade de tipo de propriedade/tipo de valor padrão é um erro em tempo de execução.

O valor UnsetValue tem um significado especial no sistema de propriedades e não pode ser usado como um valor padrão da propriedade de dependência.

Valores marcados como sinalizadores definidos no flags parâmetro definirão o valor booliano das FrameworkPropertyMetadata propriedades que correspondem FrameworkPropertyMetadataOptions ao nome desse sinalizador como true. Você ainda pode alterar os valores das propriedades nos metadados, desde que os metadados ainda não sejam aplicados a uma operação específica do sistema de propriedades.

Confira também

Aplica-se a

FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o valor padrão fornecido e os retornos de chamada especificados.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);
public FrameworkPropertyMetadata (object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);
new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)

Parâmetros

defaultValue
Object

O valor padrão da propriedade de dependência, geralmente, fornecido como um tipo específico.

propertyChangedCallback
PropertyChangedCallback

Uma referência a uma implementação do manipulador que será chamada pelo sistema de propriedades sempre que o valor efetivo da propriedade for alterado.

coerceValueCallback
CoerceValueCallback

Uma referência a uma implementação de manipulador será chamada sempre que o sistema de propriedades chamar CoerceValue(DependencyProperty) para essa propriedade de dependência.

Exceções

defaultValue é definido como UnsetValue.

Exemplos

O exemplo a seguir chama essa assinatura de construtor:

static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

Comentários

O tipo do valor fornecido para defaultValue deve corresponder ou estar relacionado ao tipo especificado no registro original da propriedade de dependência à qual esses metadados serão aplicados. As incompatibilidades entre o tipo de valor padrão de metadados e o tipo da propriedade de dependência à qual ela está sendo aplicada podem ser difíceis de depurar, pois a incompatibilidade não é detectável durante a compilação. O sistema de propriedades não avalia o valor efetivo de uma propriedade até o tempo de execução, portanto, o resultado de uma incompatibilidade de tipo de propriedade/tipo de valor padrão é um erro em tempo de execução.

O valor UnsetValue tem um significado especial no sistema de propriedades e não pode ser usado como um valor padrão da propriedade de dependência.

Confira também

Aplica-se a

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o valor padrão e as opções de metadados da estrutura fornecidos, bem como os retornos de chamada especificados.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);
public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);
new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)

Parâmetros

defaultValue
Object

O valor padrão da propriedade de dependência, geralmente, fornecido como um tipo específico.

flags
FrameworkPropertyMetadataOptions

Os sinalizadores de opção de metadados (uma combinação de valores FrameworkPropertyMetadataOptions). Essas opções especificam características da propriedade de dependência que interagem com sistemas, como layout ou vinculação de dados.

propertyChangedCallback
PropertyChangedCallback

Uma referência a uma implementação do manipulador que será chamada pelo sistema de propriedades sempre que o valor efetivo da propriedade for alterado.

coerceValueCallback
CoerceValueCallback

Uma referência a uma implementação de manipulador que será chamada sempre que o sistema de propriedades chamar CoerceValue(DependencyProperty) nessa propriedade.

Exceções

defaultValue é definido como UnsetValue.

Exemplos

O exemplo a seguir chama essa assinatura de construtor:

static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

Comentários

O tipo do valor fornecido para defaultValue deve corresponder ou estar relacionado ao tipo especificado no registro original da propriedade de dependência à qual esses metadados serão aplicados. As incompatibilidades entre o tipo de valor padrão de metadados e o tipo da propriedade de dependência à qual ela está sendo aplicada podem ser difíceis de depurar, pois a incompatibilidade não é detectável durante a compilação. O sistema de propriedades não avalia o valor efetivo de uma propriedade até o tempo de execução, portanto, o resultado de uma incompatibilidade de tipo de propriedade/tipo de valor padrão é um erro em tempo de execução.

O valor UnsetValue tem um significado especial no sistema de propriedades e não pode ser usado como um valor padrão da propriedade de dependência.

Valores marcados como sinalizadores definidos no flags parâmetro definirão o valor booliano das FrameworkPropertyMetadata propriedades que correspondem FrameworkPropertyMetadataOptions ao nome desse sinalizador como true. Você ainda pode alterar os valores das propriedades nos metadados, desde que os metadados ainda não sejam aplicados a uma operação específica do sistema de propriedades.

Confira também

Aplica-se a

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o valor padrão e as opções de metadados da estrutura fornecidos, os retornos de chamada especificados e um booliano que pode ser usado para impedir a animação da propriedade.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback, bool isAnimationProhibited);
public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback, bool isAnimationProhibited);
new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback * bool -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback, isAnimationProhibited As Boolean)

Parâmetros

defaultValue
Object

O valor padrão da propriedade de dependência, geralmente, fornecido como um tipo específico.

flags
FrameworkPropertyMetadataOptions

Os sinalizadores de opção de metadados (uma combinação de valores FrameworkPropertyMetadataOptions). Essas opções especificam características da propriedade de dependência que interagem com sistemas, como layout ou vinculação de dados.

propertyChangedCallback
PropertyChangedCallback

Uma referência a uma implementação do manipulador que será chamada pelo sistema de propriedades sempre que o valor efetivo da propriedade for alterado.

coerceValueCallback
CoerceValueCallback

Uma referência a uma implementação de manipulador será chamada sempre que o sistema de propriedades chamar CoerceValue(DependencyProperty) nessa propriedade de dependência.

isAnimationProhibited
Boolean

true para impedir que o sistema de propriedades anime a propriedade à qual esses metadados foram aplicados. Propriedades desse tipo acionarão uma exceção de tempo de execução que provenientes do sistema de propriedades, em caso de tentativa de criar animações delas. false para permitir que a propriedade seja animada. O padrão é false.

Exceções

defaultValue é definido como UnsetValue.

Exemplos

O exemplo a seguir chama essa assinatura de construtor:

static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading),
    true //Animation prohibited
);

Comentários

O tipo do valor fornecido para defaultValue deve corresponder ou estar relacionado ao tipo especificado no registro original da propriedade de dependência à qual esses metadados serão aplicados. Incompatibilidades entre o tipo de valor padrão de metadados e o tipo da propriedade de dependência à qual ele está sendo aplicado podem ser difíceis de depurar, pois a incompatibilidade não é detectável durante a compilação. O sistema de propriedades não avalia o valor efetivo de uma propriedade até o tempo de execução, portanto, o resultado de uma incompatibilidade de tipo de propriedade/tipo de valor padrão é um erro em tempo de execução.

O valor UnsetValue tem um significado especial no sistema de propriedades e não pode ser usado como um valor padrão da propriedade de dependência.

O isAnimationProhibited parâmetro define o valor inicial da IsAnimationProhibited propriedade declarada pela classe base UIPropertyMetadata imediata.

Os valores marcados como sinalizadores definidos no flags parâmetro definirão o valor booliano das FrameworkPropertyMetadata propriedades que correspondem ao FrameworkPropertyMetadataOptions nome desse sinalizador como true. Você ainda pode alterar os valores das propriedades nos metadados, desde que os metadados ainda não sejam aplicados a uma operação específica do sistema de propriedades.

Confira também

Aplica-se a

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger)

Inicializa uma nova instância da classe FrameworkPropertyMetadata com o valor padrão e as opções de metadados da estrutura fornecidos, os retornos de chamada especificados, um booliano que pode ser usado para impedir a animação da propriedade e um padrão de gatilho de atualização com associação de dados.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback, bool isAnimationProhibited, System::Windows::Data::UpdateSourceTrigger defaultUpdateSourceTrigger);
public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback, bool isAnimationProhibited, System.Windows.Data.UpdateSourceTrigger defaultUpdateSourceTrigger);
new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback * bool * System.Windows.Data.UpdateSourceTrigger -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback, isAnimationProhibited As Boolean, defaultUpdateSourceTrigger As UpdateSourceTrigger)

Parâmetros

defaultValue
Object

O valor padrão da propriedade de dependência, geralmente, fornecido como um tipo específico.

flags
FrameworkPropertyMetadataOptions

Os sinalizadores de opção de metadados (uma combinação de valores FrameworkPropertyMetadataOptions). Essas opções especificam características da propriedade de dependência que interagem com sistemas, como layout ou vinculação de dados.

propertyChangedCallback
PropertyChangedCallback

Uma referência a uma implementação do manipulador que será chamada pelo sistema de propriedades sempre que o valor efetivo da propriedade for alterado.

coerceValueCallback
CoerceValueCallback

Uma referência a uma implementação de manipulador que será chamada sempre que o sistema de propriedades chamar CoerceValue(DependencyProperty) nessa propriedade.

isAnimationProhibited
Boolean

true para impedir que o sistema de propriedades anime a propriedade à qual esses metadados foram aplicados. Propriedades desse tipo acionarão uma exceção de tempo de execução que provenientes do sistema de propriedades, em caso de tentativa de criar animações delas. O padrão é false.

defaultUpdateSourceTrigger
UpdateSourceTrigger

O UpdateSourceTrigger a ser usado quando as associações dessa propriedade forem aplicadas com seu UpdateSourceTrigger definido como Default.

Exceções

defaultValue é definido como UnsetValue.

Exemplos

static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading),
    true //Animation prohibited
    , UpdateSourceTrigger.PropertyChanged
);

Comentários

O tipo do valor fornecido para defaultValue deve corresponder ou estar relacionado ao tipo especificado no registro original da propriedade de dependência à qual esses metadados serão aplicados. Incompatibilidades entre o tipo de valor padrão de metadados e o tipo da propriedade de dependência à qual ele está sendo aplicado podem ser difíceis de depurar, pois a incompatibilidade não é detectável durante a compilação. O sistema de propriedades não avalia o valor efetivo de uma propriedade até o tempo de execução, portanto, o resultado de uma incompatibilidade de tipo de propriedade/tipo de valor padrão é um erro em tempo de execução.

O valor UnsetValue tem um significado especial no sistema de propriedades e não pode ser usado como um valor padrão da propriedade de dependência.

O isAnimationProhibited parâmetro define o valor inicial da IsAnimationProhibited propriedade declarada pela classe base UIPropertyMetadata imediata.

Para obter mais informações sobre o comportamento da fonte de atualização para associações, consulte Visão geral da associação de dados.

Os valores marcados como sinalizadores definidos no flags parâmetro definirão o valor booliano das FrameworkPropertyMetadata propriedades que correspondem ao FrameworkPropertyMetadataOptions nome desse sinalizador como true. Você ainda pode alterar os valores das propriedades nos metadados, desde que os metadados ainda não sejam aplicados a uma operação específica do sistema de propriedades.

Confira também

Aplica-se a