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 |