IDCompositionVisual::SetBorderMode, méthode (dcomp.h)

Définit la propriété BorderMode, qui spécifie comment composer les bords des bitmaps et des clips associés à ce visuel, ou avec des visuels dans la sous-arborescence enracinée à ce visuel.

Syntaxe

HRESULT SetBorderMode(
  [in] DCOMPOSITION_BORDER_MODE borderMode
);

Paramètres

[in] borderMode

Type : DCOMPOSITION_BORDER_MODE

Mode bordure à utiliser.

Valeur retournée

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur DirectComposition .

Notes

Le mode bordure affecte la façon dont les bords d’une bitmap sont composés lorsque la bitmap est transformée de telle sorte que les bords ne soient pas exactement alignés sur l’axe et à des limites de pixels précises. Cela affecte également la façon dont le contenu est coupé aux coins d’un clip qui a des coins arrondis, et au bord d’un clip qui est transformé de telle sorte que les bords ne soient pas exactement alignés sur l’axe et aux limites précises des pixels.

Par défaut, un visuel hérite du mode bordure de son visuel parent, qui peut hériter du mode bordure de son visuel parent, et ainsi de suite. Un visuel utilise le mode bordure par défaut si cette méthode n’est jamais appelée pour le visuel ou si cette méthode est appelée avec DCOMPOSITION_BORDER_MODE_INHERIT. Si aucun visuel ne définit le mode bordure, la valeur par défaut de l’arborescence visuelle entière est le rendu avec alias, qui offre la qualité visuelle la plus faible, mais les performances les plus élevées.

Si le paramètre borderMode est autre que DCOMPOSITION_BORDER_MODE_INHERIT, le bitmap et le clip de ce visuel sont composés avec le mode de bordure spécifié. En outre, ce mode de bordure devient la nouvelle valeur par défaut pour les enfants du visuel actuel. Autrement dit, si le mode bordure des enfants de ce visuel est inchangé ou explicitement défini sur DCOMPOSITION_BORDER_MODE_INHERIT, les bitmaps et les clips des visuels enfants sont composés à l’aide du mode bordure de ce visuel.

Spécifications

Voir aussi

IDCompositionVisual