Metodo IPreviewHandler::SetWindow (shobjidl_core.h)

Articolo
03/02/2024

Imposta la finestra padre della finestra del visualizzatore di anteprima, nonché l'area all'interno dell'elemento padre da usare per la finestra del visualizzatore di anteprima.

Sintassi

HRESULT SetWindow(
  [in] HWND       hwnd,
  [in] const RECT *prc
);

Parametri

[in] hwnd

Tipo: HWND

Handle per la finestra padre.

[in] prc

Tipo: const RECT*

Puntatore a un RECT che definisce l'area per il visualizzatore di anteprima.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il gestore dell'anteprima è responsabile della pittura dell'intera area definita da prc. Se la finestra del visualizzatore di anteprima è stata creata, il gestore di anteprima deve associare la finestra del visualizzatore di anteprima al nuovo elemento padre hwnd e ridimensionare la finestra del visualizzatore di anteprima nell'area definita da prc. Se la finestra del visualizzatore di anteprima non è ancora stata creata, il gestore dell'anteprima deve ricordare queste informazioni per quando viene creata la finestra del visualizzatore di anteprima in IPreviewHandler::D oPreview.

Nota È preferibile archiviare queste informazioni prima di chiamare IPreviewHandler::D oPreview. In questo modo si aumentano le prestazioni in fase di configurazione per tutti i casi in cui l'anteprima non viene avviata.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
Componente ridistribuibile	Windows Search 4 o versione successiva

Condividi tramite