Metodo IDCompositionVisual::SetBorderMode (dcomp.h)

Imposta la proprietà BorderMode, che specifica come comporre i bordi delle bitmap e delle clip associate a questo oggetto visivo o agli oggetti visivi nel sottoalbero radice in questo oggetto visivo.

Sintassi

HRESULT SetBorderMode(
  [in] DCOMPOSITION_BORDER_MODE borderMode
);

Parametri

[in] borderMode

Tipo: DCOMPOSITION_BORDER_MODE

Modalità bordo da usare.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore DirectComposition .

Commenti

La modalità bordo influisce sul modo in cui i bordi di una bitmap vengono composti quando la bitmap viene trasformata in modo che i bordi non siano esattamente allineati all'asse e a limiti di pixel precisi. Influisce anche sul modo in cui il contenuto viene ritagliato agli angoli di una clip che ha angoli arrotondati e al bordo di una clip trasformata in modo che i bordi non siano esattamente allineati all'asse e a limiti di pixel precisi.

Per impostazione predefinita, un oggetto visivo eredita la modalità bordo dell'oggetto visivo padre, che può ereditare la modalità bordo dell'oggetto visivo padre e così via. Un oggetto visivo usa la modalità bordo predefinita se questo metodo non viene mai chiamato per l'oggetto visivo o se questo metodo viene chiamato con DCOMPOSITION_BORDER_MODE_INHERIT. Se non vengono impostati oggetti visivi, il valore predefinito per l'intero albero visivo è aliased rendering, che offre la qualità visiva più bassa, ma le prestazioni più elevate.

Se il parametro borderMode è diverso da DCOMPOSITION_BORDER_MODE_INHERIT, la bitmap e la clip dell'oggetto visivo sono composte con la modalità bordo specificata. Inoltre, questa modalità bordo diventa la nuova impostazione predefinita per gli elementi figlio dell'oggetto visivo corrente. Ovvero, se la modalità bordo degli elementi figlio dell'oggetto visivo è invariata o impostata in modo esplicito su DCOMPOSITION_BORDER_MODE_INHERIT, le bitmap e le clip degli oggetti visivi figlio sono composte usando la modalità bordo di questo oggetto visivo.

Requisiti

Vedi anche

IDCompositionVisual