FrameworkPropertyMetadata Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.
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.
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.
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.
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.
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.