MapDialogRect

La funzione MapDialogRect converte unità di casella di dialogo (mappe) specificato in unità schermo (pixel). La funzione sostituisce le coordinate nel specificato struttura RECT con le coordinate convertite, che consente alla struttura di essere utilizzato per creare una finestra di dialogo o un controllo di posizione all'interno di una finestra di dialogo.

(BOOL MapDialogRect HWND  hDlg, / / handle di finestra di dialogoLPRECTlpRect / / indirizzo della struttura con rectangle);
 

Parametri

hDlg
Identifica una finestra di dialogo. Questa funzione accetta solo le maniglie per finestre di dialogo, creati da una delle funzioni di creazione casella di dialogo; maniglie per altre finestre non sono valide.
lpRect
Puntatore a una struttura RECT che contiene la finestra di dialogo casella coordinate da convertire.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

La funzione MapDialogRect si presuppone che l'iniziale coordinate nei struttura RECT rappresentano unità casella di dialogo. Per convertire queste coordinate da unità di casella di dialogo pixel, la funzione recupera le correnti orizzontali e verticali unità di base per la finestra di dialogo, quindi applica le seguenti formule

sinistra = (sinistra * baseunitX) / 4 destra = (destra * baseunitX) / 4 top = (cima * baseunitY) / 8 inferiore = (fondo * baseunitY) / 8 
 

Nella maggior parte dei casi, le unità di base per la finestra di dialogo sono le stesse di quelle recuperate utilizzando la funzione GetDialogBaseUnits . Se il modello di finestra di dialogo ha lo stile DS_SETFONT, tuttavia, le unità di base sono la media larghezza e l'altezza in pixel, dei caratteri nel tipo di carattere dato dal modello.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Panoramica di finestre di dialogo, nella finestra di dialogo funziona, CreateDialog, CreateDialogIndirect, CreateDialogIndirectParam, CreateDialogParam, DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogBoxParam, GetDialogBaseUnits, RECT

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index