Compartilhar via


FrameworkPropertyMetadata Construtores

Definição

Inicializa uma nova instância da classe FrameworkPropertyMetadata.

Sobrecargas

Nome Description
FrameworkPropertyMetadata()

Inicializa uma nova instância da classe FrameworkPropertyMetadata.

FrameworkPropertyMetadata(Object)

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

FrameworkPropertyMetadata(PropertyChangedCallback)

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

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)

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

FrameworkPropertyMetadata(Object, PropertyChangedCallback)

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

FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)

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

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)

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

FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

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

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)

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

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

Inicializa uma nova instância da FrameworkPropertyMetadata classe com as opções de metadados de estrutura e valor padrão fornecidos, 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 FrameworkPropertyMetadata classe com as opções de metadados de estrutura e valor padrão fornecidos, 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 de 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 seus padrões de FrameworkPropertyMetadata propriedade. DefaultValue será null, e as várias propriedades boolianas FrameworkPropertyMetadata serão false.

Confira também

Aplica-se a

FrameworkPropertyMetadata(Object)

Inicializa uma nova instância da FrameworkPropertyMetadata classe 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 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 FrameworkPropertyMetadata classe com o retorno de chamada especificado PropertyChangedCallback .

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 de manipulador que o sistema de propriedades chamará 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 FrameworkPropertyMetadata classe com o valor padrão fornecido e as opções de metadados no nível da estrutura.

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 FrameworkPropertyMetadataOptions valores). Essas opções especificam características da propriedade de dependência que interagem com sistemas como layout ou associaçã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 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 truenome desse sinalizador como . Posteriormente, você pode alterar os valores das propriedades nos metadados, desde que os metadados ainda não foram 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 FrameworkPropertyMetadata classe com o valor padrão fornecido e o retorno de chamada especificado PropertyChangedCallback .

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 de manipulador que o sistema de propriedades chamará 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 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 FrameworkPropertyMetadata classe 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 de manipulador que o sistema de propriedades chamará 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) 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 a coerceValueCallback configuração da propriedade na instância base.

Confira também

Aplica-se a

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)

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

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 FrameworkPropertyMetadataOptions valores). Essas opções especificam características da propriedade de dependência que interagem com sistemas como layout ou associação de dados.

propertyChangedCallback
PropertyChangedCallback

Uma referência a uma implementação de manipulador que o sistema de propriedades chamará 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 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 truenome desse sinalizador como . Você ainda pode alterar os valores das propriedades nos metadados, desde que os metadados ainda não foram 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 FrameworkPropertyMetadata classe 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 de manipulador que o sistema de propriedades chamará 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) 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 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 FrameworkPropertyMetadata classe com as opções de metadados de estrutura e valor padrão fornecidos e 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 FrameworkPropertyMetadataOptions valores). Essas opções especificam características da propriedade de dependência que interagem com sistemas como layout ou associação de dados.

propertyChangedCallback
PropertyChangedCallback

Uma referência a uma implementação de manipulador que o sistema de propriedades chamará 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) essa 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 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 truenome desse sinalizador como . Você ainda pode alterar os valores das propriedades nos metadados, desde que os metadados ainda não foram 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 FrameworkPropertyMetadata classe com as opções de metadados de estrutura e valor padrão fornecidos, 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 FrameworkPropertyMetadataOptions valores). Essas opções especificam características da propriedade de dependência que interagem com sistemas como layout ou associação de dados.

propertyChangedCallback
PropertyChangedCallback

Uma referência a uma implementação de manipulador que o sistema de propriedades chamará 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) essa propriedade de dependência.

isAnimationProhibited
Boolean

true para impedir que o sistema de propriedades anime a propriedade à qual esses metadados são aplicados. Essas propriedades gerarão uma exceção em tempo de execução originária do sistema de propriedades se forem tentadas animações delas. false para permitir a animação da propriedade. 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 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.

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

Valores marcados como sinalizadores definidos no flags parâmetro definirão o valor booliano das FrameworkPropertyMetadata propriedades que correspondem FrameworkPropertyMetadataOptions ao truenome desse sinalizador como . Você ainda pode alterar os valores das propriedades nos metadados, desde que os metadados ainda não foram 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 FrameworkPropertyMetadata classe com as opções de metadados de estrutura e valor padrão fornecidos, 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 de 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 FrameworkPropertyMetadataOptions valores). Essas opções especificam características da propriedade de dependência que interagem com sistemas como layout ou associação de dados.

propertyChangedCallback
PropertyChangedCallback

Uma referência a uma implementação de manipulador que o sistema de propriedades chamará 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) essa propriedade.

isAnimationProhibited
Boolean

true para impedir que o sistema de propriedades anime a propriedade à qual esses metadados são aplicados. Essas propriedades gerarão uma exceção em tempo de execução originária do sistema de propriedades se forem tentadas animações delas. O padrão é false.

defaultUpdateSourceTrigger
UpdateSourceTrigger

As UpdateSourceTrigger associações a serem usadas para essa propriedade são aplicadas que têm seu UpdateSourceTrigger conjunto 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 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.

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.

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

Confira também

Aplica-se a