Metodo IDCompositionVisual::SetOffsetX(float) (dcomp.h)

Modifica il valore della proprietà OffsetX di questo oggetto visivo. La proprietà OffsetX specifica il nuovo offset dell'oggetto visivo lungo l'asse x, rispetto all'oggetto visivo padre.

Sintassi

HRESULT SetOffsetX(
  [in] float offsetX
);

Parametri

[in] offsetX

Tipo: float

Nuovo offset dell'oggetto visivo lungo l'asse x, espresso in pixel.

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

Questo metodo ha esito negativo se il parametro offsetX è NaN, infinito positivo o infinito negativo.

La modifica della proprietà OffsetX di un oggetto visivo trasforma il sistema di coordinate dell'intero sottoalbero visivo radicato in tale oggetto visivo. Se viene specificata la proprietà Clip di questo oggetto visivo, viene trasformato anche il rettangolo di ritaglio.

Una trasformazione specificata dalla proprietà Transform viene applicata dopo la proprietà OffsetX. In altre parole, l'effetto dell'impostazione della proprietà Transform e della proprietà OffsetX equivale a impostare solo la proprietà Transform su un oggetto gruppo di trasformazione in cui il primo membro del gruppo è un oggetto IDCompositionTranslateTranslateTransform con lo stesso valore OffsetX di offsetX. Tuttavia, è consigliabile usare IDCompositionVisual::SetOffsetX quando possibile perché è leggermente più veloce.

Se le proprietà OffsetX e OffsetY sono impostate su 0 e la proprietà Transform è impostata su NULL, il sistema di coordinate dell'oggetto visivo corrisponde a quello del relativo padre.

Se la proprietà OffsetX è stata animata in precedenza, questo metodo rimuove l'animazione e imposta la proprietà sul valore statico specificato.

Esempio

Per un esempio, vedere Come compilare una struttura ad albero visuale semplice.

Requisiti

   
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione dcomp.h
Libreria Dcomp.lib
DLL Dcomp.dll

Vedi anche

IDCompositionVisual

IDCompositionVisual::SetOffsetY

IDCompositionVisual::SetTransform