Metodo IViewObjectEx::GetRect (ocidl.h)
Recupera un rettangolo che descrive un aspetto di disegno richiesto.
Sintassi
HRESULT GetRect(
[in] DWORD dwAspect,
[out] LPRECTL pRect
);
Parametri
[in] dwAspect
Aspetto del disegno richiesto.
[out] pRect
Puntatore al rettangolo che descrive l'aspetto del disegno richiesto.
Valore restituito
Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Il metodo non supporta l'aspetto specificato. L'oggetto non supporta l'aspetto richiesto o l'aspetto non è rettangolare. |
Commenti
Questo metodo restituisce un rettangolo che descrive l'aspetto di disegno specificato. Il rettangolo restituito è in unità HIMETRIC , rispetto all'origine dell'oggetto. Il rettangolo restituito dipende dall'aspetto del disegno come indicato di seguito.
| Aspetto del disegno | Descrizione |
|---|---|
| DVASPECT_CONTENT | Gli oggetti devono restituire il rettangolo di associazione dell'intero oggetto. L'angolo superiore sinistro è all'origine dell'oggetto e la dimensione è uguale all'estensione restituita da IViewObject2::GetExtent. |
| DVASPECT_OPAQUE |
Gli oggetti con un'area opaca rettangolare devono restituire tale rettangolo. Altri devono avere esito negativo e restituire il codice di errore DV_E_DVASPECT.
Se viene restituito un rettangolo, è garantito che venga completamente oscurato chiamando IViewObject::D raw per tale aspetto. Il contenitore deve usare tale rettangolo per ritagliare le parti opache dell'oggetto prima di disegnare qualsiasi oggetto dietro di esso durante il passaggio indietro al passaggio anteriore. Se questo metodo ha esito negativo su un oggetto con un'area opaca non rettangolare, il contenitore deve disegnare l'intero oggetto nella parte posteriore alla parte anteriore usando l'aspetto DVASPECT_CONTENT. |
| DVASPECT_TRANSPARENT | Gli oggetti devono restituire il rettangolo che copre tutte le parti trasparenti o irregolari. Se l'oggetto non dispone di parti trasparenti o irregolari, può restituire DV_E_ASPECT. Un contenitore può usare questo rettangolo per determinare se sono presenti altri oggetti sovrapposti alle parti trasparenti di un determinato oggetto. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ocidl.h |