Función PathCompactPathW (shlwapi.h)

Trunca una ruta de acceso de archivo para ajustarse a un ancho de píxel determinado reemplazando los componentes de ruta de acceso por puntos suspensivos.

Sintaxis

BOOL PathCompactPathW(
  [in]      HDC    hDC,
  [in, out] LPWSTR pszPath,
  [in]      UINT   dx
);

Parámetros

[in] hDC

Tipo: HDC

Identificador del contexto del dispositivo que se usa para las métricas de fuente. Este valor puede ser NULL.

[in, out] pszPath

Tipo: LPTSTR

Puntero a una cadena terminada en null de longitud MAX_PATH que contiene la ruta de acceso que se va a modificar. A la devolución, este búfer contendrá la cadena modificada.

[in] dx

Tipo: UINT

Ancho, en píxeles, en el que debe caber la cadena.

Valor devuelto

Tipo: BOOL

Devuelve TRUE si la ruta de acceso se compactó correctamente con el ancho especificado. Devuelve FALSE en caso de error o si la parte base de la ruta de acceso no se ajustaría al ancho especificado.

Comentarios

Esta función usa la fuente seleccionada actualmente en hDC para calcular el ancho del texto. Esta función no compactará la ruta de acceso más allá del nombre de archivo base precedido de puntos suspensivos.

Ejemplos

#include <windows.h>
#include <iostream.h>
#include "Shlwapi.h"

HDC hdc;  /* display DC handle to current font metrics */ 

void main( void )
{
// String path name 1.
char buffer_1[MAX_PATH] = "C:\\path1\\path2\\sample.txt";
char *lpStr1;
lpStr1 = buffer_1;

// String path name 2.
char buffer_2[MAX_PATH] = "C:\\path1\\path2\\sample.txt";
char *lpStr2;
lpStr2 = buffer_2;

// String path name 3.
char buffer_3[MAX_PATH] = "C:\\path1\\path2\\sample.txt";
char *lpStr3;
lpStr3 = buffer_3;

// String path name 4.
char buffer_4[MAX_PATH] = "C:\\path1\\path2\\sample.txt";
char *lpStr4;
lpStr4 = buffer_4;

// Variable to get the return from "PathCompactPath".
int retval;

cout << "The un-truncated path is                " << lpStr1 << endl;

retval = PathCompactPath(hdc,lpStr1,125);
cout << "The truncated path at 125 pixels is :   " << lpStr1 << endl;

retval = PathCompactPath(hdc,lpStr2,120);
cout << "The truncated path at 120 pixels is :   " << lpStr2 << endl;

retval = PathCompactPath(hdc,lpStr3,110);
cout << "The truncated path at 110 pixels is :   " << lpStr3 << endl;

retval = PathCompactPath(hdc,lpStr4,25);
cout << "The truncated path at  25 pixels is :   " << lpStr4 << endl;
}

OUTPUT:
===========
The un-truncated path is                C:\path1\path2\sample.txt
The truncated path at 125 pixels is :   C:\path1\...\sample.txt
The truncated path at 120 pixels is :   C:\pat...\sample.txt
The truncated path at 110 pixels is :   C:\p...\sample.txt
The truncated path at  25 pixels is :   ...\sample.txt

Nota:

El encabezado shlwapi.h define PathCompactPath como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlwapi.h
Library	Shlwapi.lib
Archivo DLL	Shlwapi.dll (versión 4.71 o posterior)