PathCompactPathA, fonction (shlwapi.h)

Article
11/20/2024

Tronque un chemin d’accès de fichier pour s’adapter à une largeur de pixel donnée en remplaçant les composants de chemin d’accès par des points de suspension.

Syntaxe

BOOL PathCompactPathA(
  [in]      HDC   hDC,
  [in, out] LPSTR pszPath,
  [in]      UINT  dx
);

Paramètres

[in] hDC

Type : HDC

Handle vers le contexte de l’appareil utilisé pour les métriques de police. Cette valeur peut être NULL.

[in, out] pszPath

Type : LPTSTR

Pointeur vers une chaîne de longueur terminée par null MAX_PATH qui contient le chemin d’accès à modifier. Lors du retour, cette mémoire tampon contiendra la chaîne modifiée.

[in] dx

Type : uiNT

Largeur, en pixels, dans laquelle la chaîne doit tenir.

Valeur de retour

Type : BOOL

Retourne TRUE si le chemin d’accès a été correctement compacté à la largeur spécifiée. Retourne FALSE en cas d’échec, ou si la partie de base du chemin d’accès ne correspond pas à la largeur spécifiée.

Remarques

Cette fonction utilise la police actuellement sélectionnée dans hDC pour calculer la largeur du texte. Cette fonction ne compacte pas le chemin au-delà du nom de fichier de base précédé de points de suspension.

Exemples

#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

Note

L’en-tête shlwapi.h définit PathCompactPath comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	shlwapi.h
bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 4.71 ou ultérieure)

Partager via