Interface ID2D1Properties (d2d1_1.h)
Représente un ensemble de propriétés pouvant être liées et détectables au moment de l’exécution qui permettent à une application pilotée par les données de modifier l’état d’un effet Direct2D.
Héritage
L’interface ID2D1Properties hérite de l’interface IUnknown. ID2D1Properties a également les types de membres suivants :
Méthodes
L’interface ID2D1Properties utilise ces méthodes.
| ID2D1Properties::GetPropertyCount Obtient le nombre de propriétés de niveau supérieur. |
| ID2D1Properties::GetPropertyIndex Obtient l’index correspondant au nom de propriété donné. |
| ID2D1Properties::GetPropertyName Obtient le nom de la propriété qui correspond à l’index donné. Il s’agit d’une surcharge de modèle. Consultez la section Notes. |
| ID2D1Properties::GetPropertyName Obtient le nom de la propriété qui correspond à l’index donné. |
| ID2D1Properties::GetPropertyNameLength Obtient le nombre de caractères pour le nom de propriété donné. Il s’agit d’une surcharge de modèle. Consultez la section Notes. |
| ID2D1Properties::GetPropertyNameLength Obtient le nombre de caractères pour le nom de propriété donné. |
| ID2D1Properties::GetSubProperties Obtient les sous-propriétés de la propriété fournie par index. Il s’agit d’une surcharge de modèle. |
| ID2D1Properties::GetSubProperties Obtient les sous-propriétés de la propriété fournie par index. |
| ID2D1Properties::GetType Obtient le D2D1_PROPERTY_TYPE de la propriété sélectionnée. Il s’agit d’une surcharge de modèle. Consultez la section Notes. |
| ID2D1Properties::GetType Obtient le D2D1_PROPERTY_TYPE de la propriété sélectionnée. |
| ID2D1Properties::GetValue Obtient la valeur de la propriété par index. Il s’agit d’une surcharge de modèle. Consultez la section Notes. (surcharge 1/2) |
| ID2D1Properties::GetValue Obtient la valeur de la propriété spécifiée par index. Il s’agit d’une surcharge de modèle. Consultez la section Notes. |
| ID2D1Properties::GetValue Obtient la valeur de la propriété par index. Il s’agit d’une surcharge de modèle. Consultez la section Notes. (surcharge 2/2) |
| ID2D1Properties::GetValue Obtient la valeur de la propriété spécifiée par index. (surcharge 1/2) |
| ID2D1Properties::GetValue Obtient la valeur de la propriété spécifiée par index. (surcharge 2/2) |
| ID2D1Properties::GetValueByName Obtient la valeur de la propriété par nom. Il s’agit d’une surcharge de modèle. Consultez la section Notes. (surcharge 2/2) |
| ID2D1Properties::GetValueByName Obtient la valeur de la propriété par nom. (surcharge 2/2) |
| ID2D1Properties::GetValueByName Obtient la valeur de la propriété par nom. (surcharge 1/2) |
| ID2D1Properties::GetValueByName Obtient la valeur de la propriété par nom. Il s’agit d’une surcharge de modèle. Consultez la section Notes. (surcharge 1/2) |
| ID2D1Properties::GetValueSize Obtient la taille de la valeur de propriété en octets, à l’aide de l’index de propriété. Il s’agit d’une surcharge de modèle. Consultez la section Notes. |
| ID2D1Properties::GetValueSize Obtient la taille de la valeur de propriété en octets, à l’aide de l’index de propriété. |
| ID2D1Properties::SetValue Définit la propriété correspondante par index. Il s’agit d’une surcharge de modèle. (surcharge 2/2) |
| ID2D1Properties::SetValue Définit la propriété correspondante par index. Il s’agit d’une surcharge de modèle. (surcharge 1/2) |
| ID2D1Properties::SetValue Définit la propriété correspondante par index. (surcharge 1/2) |
| ID2D1Properties::SetValue Définit la propriété correspondante par index. (surcharge 2/2) |
| ID2D1Properties::SetValueByName Définit la propriété nommée sur la valeur donnée. (surcharge 1/2) |
| ID2D1Properties::SetValueByName Définit la propriété nommée sur la valeur donnée. Il s’agit d’une surcharge de modèle. Consultez la section Notes. |
| ID2D1Properties::SetValueByName Définit la propriété nommée sur la valeur donnée. (surcharge 2/2) |
Remarques
Cette interface prend en charge l’accès via des index ou des noms de propriétés. En plus des propriétés de niveau supérieur, chaque propriété d’un objet ID2D1Properties peut contenir un objet ID2D1Properties , qui stocke les métadonnées décrivant la propriété parente.
Aperçu
L’interface ID2D1Properties expose un ensemble de propriétés pouvant être liées à l’exécution et détectables qui permettent à une application pilotée par les données, telle qu’un outil de création de graphe d’effets ou un système d’animation, de modifier l’état d’un effet Direct2D.L’interface prend en charge l’accès via des index ou des noms de propriétés. En plus des propriétés de niveau supérieur, chaque propriété dans un ID2D1Properties peut contenir une interface de sous-ID2D1Properties , qui stocke les métadonnées décrivant sa propriété parente. Les sous-propriétés sont accessibles en demandant cette sous-interface par index de propriété ou en utilisant une chaîne de nom de propriété séparée par un point (.).
L’interface est intentionnellement conçue pour éviter les dépendances au moment de l’exécution. Toute l’allocation est effectuée par l’appelant de l’API et les types VARIANT ne sont pas utilisés. L’interface de propriété est généralement conçue pour ne pas retourner les échecs dans lesquels l’application pourrait modifier trivialement leur séquence d’appel afin d’éviter la condition. Par exemple, étant donné que le nombre de propriétés prises en charge par le instance est retourné par la méthode GetPropertyCount, d’autres méthodes qui prennent un index de propriété ne retournent pas de défaillance, sauf si elles utilisent également le système de propriétés de l’effet de plug-in.
L’interface est principalement basée sur un modèle d’accès basé sur un index et prend en charge les sous-propriétés imbriquées dans les propriétés. Contrairement à une structure de répertoires, la propriété elle-même a une valeur et un type et peut éventuellement prendre en charge les sous-propriétés (les répertoires ne sont pas des fichiers). Il s’agit normalement de métadonnées qui décrivent la propriété, mais elles sont également utilisées pour spécifier des tableaux d’objets. Afin de simplifier l’accès aux sous-propriétés et d’autoriser l’accès par nom, deux méthodes d’assistance ( GetValueByName ) sont définies. Celles-ci utilisent une notation « pointillée » pour permettre la spécification directe des sous-propriétés, par exemple :
alphaMode = pEffect->GetValueByName<UINT32>(L"Inputs.0.AlphaMode");
Ou :
pEffect->SetValueByName<UINT32>(
L"Inputs.0.AlphaMode",
DXGI_ALPHA_MODE_PREMULTIPLIED);
Propriétés d’effet standard
| Nom/index de la propriété | Type de propriété | Description de la propriété |
|---|---|---|
| CLSID / D2D1_PROPERTY_CLSID | D2D1_PROPERTY_TYPE_CLSID | CLSID de l’effet. |
| DisplayName / D2D1_PROPERTY_DISPLAYNAME | D2D1_PROPERTY_TYPE_STRING | Nom localisable de l’effet. |
| Auteur / D2D1_PROPERTY_AUTHOR | D2D1_PROPERTY_TYPE_STRING | Auteur de l’effet. |
| Catégorie / D2D1_PROPERTY_CATEGORY | D2D1_PROPERTY_TYPE_STRING | Catégorie de l’effet. |
| Description / D2D1_PROPERTY_DESCRIPTION | D2D1_PROPERTY_TYPE_STRING | Description de l’effet. |
| Entrées / D2D1_PROPERTY_INPUTS | D2D1_PROPERTY_TYPE_ARRAY Note Les éléments de ce tableau sont de type D2D1_PROPERTY_TYPE_STRING.
|
Tableau de noms pour les entrées de l’effet. Chaque élément du tableau est une chaîne localisée spécifiant le nom d’une entrée. |
Sub-Properties standard
Les sous-propriétés suivantes peuvent être utilisées pour l’accès aux métadonnées et peuvent être disponibles sur les propriétés système et personnalisées. Pour plus d’informations, consultez les énumérations D2D1_SUBPROPERTY et D2D1_PROPERTY_TYPE .| Nom/index de la propriété | Type de propriété | Description de la propriété |
|---|---|---|
| DisplayName / D2D1_SUBPROPERTY_DISPLAYNAME | D2D1_PROPERTY_TYPE_STRING |
Nom localisable pour la propriété parente.
Cette sous-propriété est présente sur toutes les propriétés de niveau supérieur. |
| IsReadOnly / D2D1_SUBPROPERTY_ISREADONLY | D2D1_PROPERTY_TYPE_BOOL |
Valeur indiquant si la propriété parente peut être écrite dans.
Cette sous-propriété est présente sur toutes les propriétés de niveau supérieur. |
| Par défaut / D2D1_SUBPROPERTY_DEFAULT | Identique à la propriété parente. |
Valeur par défaut de la propriété.
Cette sous-propriété est éventuellement présente sur toutes les propriétés. |
| Min/ D2D1_SUBPROPERTY_MIN | Identique à la propriété parente.
Note Applicable uniquement aux propriétés de type numérique.
|
Valeur minimale prise en charge par la propriété parente. |
| Max/ D2D1_SUBPROPERTY_MAX | Identique à la propriété parente.
Note Applicable uniquement aux propriétés de type numérique.
|
Valeur maximale prise en charge par la propriété parente. |
| Champs / D2D1_SUBPROPERTY_FIELDS | Tableau / D2D1_PROPERTY_TYPE_ARRAY Note Applicable uniquement lorsque la propriété parente est de type Enum.
|
Ensemble de valeurs valides qui peuvent être définies sur la propriété parente.
Chaque valeur de ce tableau est une paire nom/index. Les index peuvent être définis sur le parent et les noms sont des valeurs localisées conçues pour être utilisées par l’interface utilisateur. Consultez la section suivante pour plus d’informations. |
Sub-Properties de type tableau
Pour plus d’informations , consultez ID2D1Properties::GetType et D2D1_PROPERTY_TYPE . Si le type de propriété est D2D1_PROPERTY_TYPE_ARRAY, la valeur de la propriété est considérée comme un UINT qui a le nombre d’éléments de tableau. La sous-propriété suivante mappe directement l’index à la valeur de propriété demandée. Par exemple :Inputs: UINT32 – 2
Inputs.0 : <Type> – First input
Inputs.1 : <Type> – Second input
L’exemple ci-dessus utilise les sous-propriétés suivantes, qui apparaîtront sur les propriétés de type ARRAY. Notez que les propriétés numérotées ne sont pas des propriétés système et se trouvent dans la plage normale (0x0 – 0x80000000).
| Nom de la propriété | Index de propriété | Description de la propriété |
|---|---|---|
| Property.0 | 0 | Premier élément du tableau de propriétés. |
| ... | ... | ... |
| Property.N | N | Nième élément du tableau de propriétés. |
Le type de chaque sous-élément sera quel que soit le type du tableau. Dans l’exemple ci-dessus, il s’agissait d’un tableau de chaînes.
Enum-Type Sub-Properties
Si la propriété a le type D2D1_PROPERTY_TYPE_ENUM la propriété aura la valeur de l’énumération correspondante. Il y aura un sous-tableau de champs qui sera conforme aux règles générales pour les sous-propriétés de tableau et se compose des paires nom/valeur. Par exemple :PixelFormat: ENUM – The pixel format value
PixelFormat.Fields: UINT32 – The number of fields
PixelFormat.Fields.0:String – The name of the first enum
PixelFormat.Fields.0.Index: UINT32 – The value of the enumeration.
L’exemple ci-dessus utilise les sous-propriétés suivantes. Pour plus d’informations, consultez les énumérations D2D1_SUBPROPERTY et D2D1_PROPERTY_TYPE .
| Nom de la propriété | Index de propriété | Description de la propriété |
|---|---|---|
| Property.Fields | D2D1_SUBPROPERTY_FIELDS | Propriété de type tableau qui fournit des informations sur chaque champ de l’énumération. |
| Property.Fields.N | N | Élément de tableau qui donne le nom de la Nième valeur d’énumération. |
| Property.Fields.N.Index | D2D1_SUBPROPERTY_INDEX | Index qui correspond à la Nième valeur d’énumération. |
Configuration requise
| Client minimal pris en charge | Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2012 et Platform Update pour Windows Server 2008 R2 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | d2d1_1.h |
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour