winuser.h


GetDlgItemText

La función GetDlgItemText recupera el título o el texto asociado con un control en un cuadro de diálogo.

Sintaxis

UINT GetDlgItemText(
    HWND hDlg,         // manipulador al cuadro de diálogo
    int nIDDlgItem,    // identificador del control
    LPCTSTR lpString,  // dirección del buffer de texto
    int nMaxCount      // máximo tamaño de la cadena
   );

Parámetros:

hDlg: identifica al cuadro de diálogo que contienen el control.

nIdDlgItem: especifica el identificador del control del que se recuperará el título o el texto.

lpString: puntero al buffer que recibirá el título o el texto.

nMaxCount: especifica la longitud máxima, en caracteres, de la cadena a copiar en le buffer apuntado por lpString. Si la longitud de la cadena excede el límite, la cadena se truncará.

Valor de retorno

Si la función tiene éxito, el valor de retorno indicará el número de caracteres copiados a buffer, sin incluir el carácter nulo de terminación.

Si la función falla, el valor de retorno es cero.

Observaciones

La función GetDlgItemText envía un mensaje WM_GETTEXT al control especificado.