Classe CPathT

Questa classe rappresenta un percorso.

Importante

Questa classe e i relativi membri non possono essere usati nelle applicazioni eseguite in Windows Runtime.

Sintassi

template <typename StringType>
class CPathT

Parametri

StringType
Classe stringa ATL/MFC da usare per il percorso (vedere CStringT).

Membri

Typedef pubblici

Nome	Descrizione
CPathT::P CXSTR	Tipo stringa costante.
CPathT::P XSTR	Un tipo stringa.
CPathT::XCHAR	Tipo carattere.

Costruttori pubblici

Nome	Descrizione
CPathT::CPathT	Costruttore per il percorso.

Metodi pubblici

Nome	Descrizione
CPathT::AddBackslash	Chiamare questo metodo per aggiungere una barra rovesciata alla fine di una stringa per creare la sintassi corretta per un percorso.
CPathT::AddExtension	Chiamare questo metodo per aggiungere un'estensione di file a un percorso.
CPathT::Append	Chiamare questo metodo per aggiungere una stringa al percorso corrente.
CPathT::BuildRoot	Chiamare questo metodo per creare un percorso radice da un determinato numero di unità.
CPathT::Canonicalize	Chiamare questo metodo per convertire il percorso in formato canonico.
CPathT::Combine	Chiamare questo metodo per concatenare una stringa che rappresenta un nome di directory e una stringa che rappresenta un nome di percorso file in un percorso.
CPathT::CommonPrefix	Chiamare questo metodo per determinare se il percorso specificato condivide un prefisso comune con il percorso corrente.
CPathT::CompactPath	Chiamare questo metodo per troncare un percorso di file per adattarsi all'interno di una determinata larghezza di pixel sostituendo i componenti del percorso con i puntini di sospensione.
CPathT::CompactPathEx	Chiamare questo metodo per troncare un percorso di file per adattarsi a un determinato numero di caratteri sostituendo i componenti del percorso con i puntini di sospensione.
CPathT::FileExists	Chiamare questo metodo per verificare se il file in corrispondenza del nome del percorso esiste.
CPathT::FindExtension	Chiamare questo metodo per trovare la posizione dell'estensione di file all'interno del percorso.
CPathT::FindFileName	Chiamare questo metodo per trovare la posizione del nome file all'interno del percorso.
CPathT::GetDriveNumber	Chiamare questo metodo per cercare una lettera di unità all'interno dell'intervallo di 'A' a 'Z' e restituire il numero di unità corrispondente.
CPathT::GetExtension	Chiamare questo metodo per ottenere l'estensione del file dal percorso.
CPathT::IsDirectory	Chiamare questo metodo per verificare se il percorso è una directory valida.
CPathT::IsFilespec	Chiamare questo metodo per cercare in un percorso qualsiasi carattere delimitatore di percorso (ad esempio, : o \). Se non sono presenti caratteri delimitatori di percorso, il percorso viene considerato un percorso di specifica file.
CPathT::IsPrefix	Chiamare questo metodo per determinare se un percorso contiene un prefisso valido del tipo passato da pszPrefix.
CPathT::IsRelative	Chiamare questo metodo per determinare se il percorso è relativo.
CPathT::IsRoot	Chiamare questo metodo per determinare se il percorso è una directory radice.
CPathT::IsSameRoot	Chiamare questo metodo per determinare se un altro percorso ha un componente radice comune con il percorso corrente.
CPathT::IsUNC	Chiamare questo metodo per determinare se il percorso è un percorso UNC (universal naming convention) valido per un server e una condivisione.
CPathT::IsUNCServer	Chiamare questo metodo per determinare se il percorso è un percorso UNC (universal naming convention) valido solo per un server.
CPathT::IsUNCServerShare	Chiamare questo metodo per determinare se il percorso è un percorso di condivisione UNC (universal naming convention) valido, \\server\share.
CPathT::MakePretty	Chiamare questo metodo per convertire un percorso in tutti i caratteri minuscoli per dare al percorso un aspetto coerente.
CPathT::MatchSpec	Chiamare questo metodo per cercare nel percorso una stringa contenente un tipo di corrispondenza con caratteri jolly.
CPathT::QuoteSpaces	Chiamare questo metodo per racchiudere il percorso tra virgolette se contiene spazi.
CPathT::RelativePathTo	Chiamare questo metodo per creare un percorso relativo da un file o una cartella a un altro.
CPathT::RemoveArgs	Chiamare questo metodo per rimuovere gli argomenti della riga di comando dal percorso.
CPathT::RemoveBackslash	Chiamare questo metodo per rimuovere la barra rovesciata finale dal percorso.
CPathT::RemoveBlanks	Chiamare questo metodo per rimuovere tutti gli spazi iniziali e finali dal percorso.
CPathT::RemoveExtension	Chiamare questo metodo per rimuovere l'estensione del file dal percorso, se presente.
CPathT::RemoveFileSpec	Chiamare questo metodo per rimuovere il nome del file finale e la barra rovesciata dal percorso, se presente.
CPathT::RenameExtension	Chiamare questo metodo per sostituire l'estensione del nome file nel percorso con una nuova estensione. Se il nome del file non contiene un'estensione, l'estensione verrà associata alla fine della stringa.
CPathT::SkipRoot	Chiamare questo metodo per analizzare un percorso, ignorando la lettera di unità o le parti del percorso UNC o del server UNC.
CPathT::StripPath	Chiamare questo metodo per rimuovere la parte del percorso di un percorso completo e di un nome file.
CPathT::StripToRoot	Chiamare questo metodo per rimuovere tutte le parti del percorso, ad eccezione delle informazioni radice.
CPathT::UnquoteSpaces	Chiamare questo metodo per rimuovere le virgolette dall'inizio e dalla fine di un percorso.

Operatori pubblici

Nome	Descrizione
CPathT::operator const StringType &	Questo operatore consente di trattare l'oggetto come una stringa.
CPathT::operator CPathT::P CXSTR	Questo operatore consente di trattare l'oggetto come una stringa.
CPathT::operator StringType &	Questo operatore consente di trattare l'oggetto come una stringa.
CPathT::operator +=	Questo operatore aggiunge una stringa al percorso.

Membri dati pubblici

Nome	Descrizione
CPathT::m_strPath	Percorso.

Osservazioni:

CPath, CPathAe CPathW sono istanze di CPathT definite come segue:

typedef CPathT< CString > CPath;

typedef CPathT< CStringA > CPathA;

typedef CPathT< CStringW > CPathW;

Requisiti

Intestazione: atlpath.h

CPathT::AddBackslash

Chiamare questo metodo per aggiungere una barra rovesciata alla fine di una stringa per creare la sintassi corretta per un percorso. Se il percorso ha già una barra rovesciata finale, non verrà aggiunta alcuna barra rovesciata.

void AddBackslash();

Osservazioni:

Per altre informazioni, vedere PathAddBackSlash.

CPathT::AddExtension

Chiamare questo metodo per aggiungere un'estensione di file a un percorso.

BOOL AddExtension(PCXSTR pszExtension);

Parametri

pszExtension
Estensione di file da aggiungere.

Valore restituito

Restituisce TRUE in caso di esito positivo, FAL edizione Standard in caso di errore.

Osservazioni:

Per altre informazioni, vedere PathAddExtension.

CPathT::Append

Chiamare questo metodo per aggiungere una stringa al percorso corrente.

BOOL Append(PCXSTR pszMore);

Parametri

pszMore
Stringa da accodare.

Valore restituito

Restituisce TRUE in caso di esito positivo, FAL edizione Standard in caso di errore.

Osservazioni:

Per altre informazioni, vedere PathAppend.

CPathT::BuildRoot

Chiamare questo metodo per creare un percorso radice da un determinato numero di unità.

void BuildRoot(int iDrive);

Parametri

Idrive
Numero di unità (0 è A:, 1 è B:e così via).

Osservazioni:

Per altre informazioni, vedere PathBuildRoot.

CPathT::Canonicalize

Chiamare questo metodo per convertire il percorso in formato canonico.

void Canonicalize();

Osservazioni:

Per altre informazioni, vedere PathCanonicalize.

CPathT::Combine

Chiamare questo metodo per concatenare una stringa che rappresenta un nome di directory e una stringa che rappresenta un nome di percorso file in un percorso.

void Combine(PCXSTR pszDir, PCXSTR  pszFile);

Parametri

pszDir
Percorso della directory.

pszFile
Percorso del file.

Osservazioni:

Per altre informazioni, vedere PathCombine.

CPathT::CommonPrefix

Chiamare questo metodo per determinare se il percorso specificato condivide un prefisso comune con il percorso corrente.

CPathT<StringType> CommonPrefix(PCXSTR pszOther);

Parametri

pszOther
Percorso da confrontare con quello corrente.

Valore restituito

Restituisce il prefisso comune.

Osservazioni:

Un prefisso è uno di questi tipi: "C:\\", ".", "..", ".. \\". Per altre informazioni, vedere PathCommonPrefix.

CPathT::CompactPath

Chiamare questo metodo per troncare un percorso di file per adattarsi all'interno di una determinata larghezza di pixel sostituendo i componenti del percorso con i puntini di sospensione.

BOOL CompactPath(HDC hDC, UINT nWidth);

Parametri

Hdc
Contesto di dispositivo usato per le metriche dei tipi di carattere.

nWidth
Larghezza, in pixel, in cui verrà forzata la stringa.

Valore restituito

Restituisce TRUE in caso di esito positivo, FAL edizione Standard in caso di errore.

Osservazioni:

Per altre informazioni, vedere PathCompactPath.

CPathT::CompactPathEx

Chiamare questo metodo per troncare un percorso di file per adattarsi a un determinato numero di caratteri sostituendo i componenti del percorso con i puntini di sospensione.

BOOL CompactPathEx(UINT nMaxChars, DWORD dwFlags = 0);

Parametri

nMaxChars
Numero massimo di caratteri da includere nella nuova stringa, incluso il carattere NULL di terminazione.

dwFlags
Riservato.

Valore restituito

Restituisce TRUE in caso di esito positivo, FAL edizione Standard in caso di errore.

Osservazioni:

Per altre informazioni, vedere PathCompactPathEx.

CPathT::CPathT

Costruttore.

CPathT(PCXSTR pszPath);
CPathT(const CPathT<StringType>& path);
CPathT() throw();

Parametri

pszPath
Puntatore a una stringa di percorso.

path
Stringa di percorso.

CPathT::FileExists

Chiamare questo metodo per verificare se il file in corrispondenza del nome del percorso esiste.

BOOL FileExists() const;

Valore restituito

Restituisce TRUE se il file esiste, FAL edizione Standard in caso contrario.

Osservazioni:

Per altre informazioni, vedere PathFileExists.

CPathT::FindExtension

Chiamare questo metodo per trovare la posizione dell'estensione di file all'interno del percorso.

int FindExtension() const;

Valore restituito

Restituisce la posizione dell'oggetto "." precedente all'estensione. Se non viene trovata alcuna estensione, restituisce -1.

Osservazioni:

Per altre informazioni, vedere PathFindExtension.

CPathT::FindFileName

Chiamare questo metodo per trovare la posizione del nome file all'interno del percorso.

int FindFileName() const;

Valore restituito

Restituisce la posizione del nome del file. Se non viene trovato alcun nome file, restituisce -1.

Osservazioni:

Per altre informazioni, vedere PathFindFileName.

CPathT::GetDriveNumber

Chiamare questo metodo per cercare una lettera di unità all'interno dell'intervallo di 'A' a 'Z' e restituire il numero di unità corrispondente.

int GetDriveNumber() const;

Valore restituito

Restituisce il numero di unità come numero intero compreso tra 0 e 25 (corrispondente a "A" e "Z") se il percorso ha una lettera di unità o -1 in caso contrario.

Osservazioni:

Per altre informazioni, vedere PathGetDriveNumber.

CPathT::GetExtension

Chiamare questo metodo per ottenere l'estensione del file dal percorso.

StringType GetExtension() const;

Valore restituito

Restituisce l'estensione del file.

CPathT::IsDirectory

Chiamare questo metodo per verificare se il percorso è una directory valida.

BOOL IsDirectory() const;

Valore restituito

Restituisce un valore diverso da zero (16) se il percorso è una directory, FAL edizione Standard in caso contrario.

Osservazioni:

Per altre informazioni, vedere PathIsDirectory.

CPathT::IsFilespec

Chiamare questo metodo per cercare in un percorso qualsiasi carattere delimitatore di percorso (ad esempio, : o \). Se non sono presenti caratteri delimitatori di percorso, il percorso viene considerato un percorso di specifica file.

BOOL IsFileSpec() const;

Valore restituito

Restituisce TRUE se non sono presenti caratteri delimitatori di percorso all'interno del percorso o FAL edizione Standard se sono presenti caratteri delimitatori di percorso.

Osservazioni:

Per altre informazioni, vedere PathIsFileSpec.

CPathT::IsPrefix

Chiamare questo metodo per determinare se un percorso contiene un prefisso valido del tipo passato da pszPrefix.

BOOL IsPrefix(PCXSTR pszPrefix) const;

Parametri

pszPrefix
Prefisso per il quale eseguire la ricerca. Un prefisso è uno di questi tipi: "C:\\", ".", "..", ".. \\".

Valore restituito

Restituisce TRUE se il percorso contiene il prefisso o FAL edizione Standard in caso contrario.

Osservazioni:

Per altre informazioni, vedere PathIsPrefix.

CPathT::IsRelative

Chiamare questo metodo per determinare se il percorso è relativo.

BOOL IsRelative() const;

Valore restituito

Restituisce TRUE se il percorso è relativo o FAL edizione Standard se è assoluto.

Osservazioni:

Per altre informazioni, vedere PathIsRelative.

CPathT::IsRoot

Chiamare questo metodo per determinare se il percorso è una directory radice.

BOOL IsRoot() const;

Valore restituito

Restituisce TRUE se il percorso è una radice o FAL edizione Standard in caso contrario.

Osservazioni:

Per altre informazioni, vedere PathIsRoot.

CPathT::IsSameRoot

Chiamare questo metodo per determinare se un altro percorso ha un componente radice comune con il percorso corrente.

BOOL IsSameRoot(PCXSTR pszOther) const;

Parametri

pszOther
L'altro percorso.

Valore restituito

Restituisce TRUE se entrambe le stringhe hanno lo stesso componente radice o FAL edizione Standard in caso contrario.

Osservazioni:

Per altre informazioni, vedere PathIsSameRoot.

CPathT::IsUNC

Chiamare questo metodo per determinare se il percorso è un percorso UNC (universal naming convention) valido per un server e una condivisione.

BOOL IsUNC() const;

Valore restituito

Restituisce TRUE se il percorso è un percorso UNC valido o FAL edizione Standard in caso contrario.

Osservazioni:

Per altre informazioni, vedere PathIsUNC.

CPathT::IsUNCServer

Chiamare questo metodo per determinare se il percorso è un percorso UNC (universal naming convention) valido solo per un server.

BOOL IsUNCServer() const;

Valore restituito

Restituisce TRUE se la stringa è un percorso UNC valido solo per un server (nessun nome di condivisione) o FAL edizione Standard in caso contrario.

Osservazioni:

Per altre informazioni, vedere PathIsUNCServer.

CPathT::IsUNCServerShare

Chiamare questo metodo per determinare se il percorso è un percorso di condivisione UNC (universal naming convention) valido, \\ condivisione server\ .

BOOL IsUNCServerShare() const;

Valore restituito

Restituisce TRUE se il percorso è nel formato \\ condivisione server\ o FAL edizione Standard in caso contrario.

Osservazioni:

Per altre informazioni, vedere PathIsUNCServerShare.

CPathT::m_strPath

Percorso.

StringType m_strPath;

Osservazioni:

StringType è il parametro del modello su CPathT.

CPathT::MakePretty

Chiamare questo metodo per convertire un percorso in tutti i caratteri minuscoli per dare al percorso un aspetto coerente.

BOOL MakePretty();

Valore restituito

Restituisce TRUE se il percorso è stato convertito o FAL edizione Standard in caso contrario.

Osservazioni:

Per altre informazioni, vedere PathMakePretty.

CPathT::MatchSpec

Chiamare questo metodo per cercare nel percorso una stringa contenente un tipo di corrispondenza con caratteri jolly.

BOOL MatchSpec(PCXSTR pszSpec) const;

Parametri

pszSpec
Puntatore a una stringa con terminazione Null con il tipo di file in cui eseguire la ricerca. Ad esempio, per verificare se il file nel percorso corrente è un file DOC, pszSpec deve essere impostato su "*.doc".

Valore restituito

Restituisce TRUE se la stringa corrisponde o FAL edizione Standard in caso contrario.

Osservazioni:

Per altre informazioni, vedere PathMatchSpec.

CPathT::operator +=

Questo operatore aggiunge una stringa al percorso.

CPathT<StringType>& operator+=(PCXSTR pszMore);

Parametri

pszMore
Stringa da accodare.

Valore restituito

Restituisce il percorso aggiornato.

CPathT::operator const StringType &

Questo operatore consente di trattare l'oggetto come una stringa.

operator const StringType&() const throw();

Valore restituito

Restituisce una stringa che rappresenta il percorso corrente gestito dall'oggetto .

CPathT::operator CPathT::P CXSTR

Questo operatore consente di trattare l'oggetto come una stringa.

operator PCXSTR() const throw();

Valore restituito

Restituisce una stringa che rappresenta il percorso corrente gestito dall'oggetto .

CPathT::operator StringType &

Questo operatore consente di trattare l'oggetto come una stringa.

operator StringType&() throw();

Valore restituito

Restituisce una stringa che rappresenta il percorso corrente gestito dall'oggetto .

CPathT::P CXSTR

Tipo stringa costante.

typedef StringType::PCXSTR PCXSTR;

Osservazioni:

StringType è il parametro del modello su CPathT.

CPathT::P XSTR

Un tipo stringa.

typedef StringType::PXSTR PXSTR;

Osservazioni:

StringType è il parametro del modello su CPathT.

CPathT::QuoteSpaces

Chiamare questo metodo per racchiudere il percorso tra virgolette se contiene spazi.

void QuoteSpaces();

Osservazioni:

Per altre informazioni, vedere PathQuoteSpaces.

CPathT::RelativePathTo

Chiamare questo metodo per creare un percorso relativo da un file o una cartella a un altro.

BOOL RelativePathTo(
    PCXSTR pszFrom,
    DWORD dwAttrFrom,
    PCXSTR pszTo,
    DWORD dwAttrTo);

Parametri

pszFrom
Inizio del percorso relativo.

dwAttrFrom
Attributi File di pszFrom. Se questo valore contiene FILE_ATTRIBUTE_DIRECTORY, si presuppone che pszFrom sia una directory. In caso contrario, si presuppone che pszFrom sia un file.

pszTo
Punto finale del percorso relativo.

dwAttrTo
Attributi file di pszTo. Se questo valore contiene FILE_ATTRIBUTE_DIRECTORY, si presuppone che pszTo sia una directory. In caso contrario, si presuppone che pszTo sia un file.

Valore restituito

Restituisce TRUE in caso di esito positivo, FAL edizione Standard in caso di errore.

Osservazioni:

Per altre informazioni, vedere PathRelativePathTo.

CPathT::RemoveArgs

Chiamare questo metodo per rimuovere gli argomenti della riga di comando dal percorso.

void RemoveArgs();

Osservazioni:

Per altre informazioni, vedere PathRemoveArgs.

CPathT::RemoveBackslash

Chiamare questo metodo per rimuovere la barra rovesciata finale dal percorso.

void RemoveBackslash();

Osservazioni:

Per altre informazioni, vedere PathRemoveBackslash.

CPathT::RemoveBlanks

Chiamare questo metodo per rimuovere tutti gli spazi iniziali e finali dal percorso.

void RemoveBlanks();

Osservazioni:

Per altre informazioni, vedere PathRemoveBlanks.

CPathT::RemoveExtension

Chiamare questo metodo per rimuovere l'estensione del file dal percorso, se presente.

void RemoveExtension();

Osservazioni:

Per altre informazioni, vedere PathRemoveExtension.

CPathT::RemoveFileSpec

Chiamare questo metodo per rimuovere il nome del file finale e la barra rovesciata dal percorso, se presente.

BOOL RemoveFileSpec();

Valore restituito

Restituisce TRUE in caso di esito positivo, FAL edizione Standard in caso di errore.

Osservazioni:

Per altre informazioni, vedere PathRemoveFileSpec.

CPathT::RenameExtension

Chiamare questo metodo per sostituire l'estensione del nome file nel percorso con una nuova estensione. Se il nome del file non contiene un'estensione, l'estensione verrà collegata alla fine del percorso.

BOOL RenameExtension(PCXSTR pszExtension);

Parametri

pszExtension
Nuova estensione del nome file, preceduta da un carattere ".".

Valore restituito

Restituisce TRUE in caso di esito positivo, FAL edizione Standard in caso di errore.

Osservazioni:

Per altre informazioni, vedere PathRenameExtension.

CPathT::SkipRoot

Chiamare questo metodo per analizzare un percorso, ignorando la lettera di unità o le parti del percorso UNC (universal naming convention).

int SkipRoot() const;

Valore restituito

Restituisce la posizione dell'inizio del sottopercorso che segue la radice (lettera di unità o server UNC/condivisione).

Osservazioni:

Per altre informazioni, vedere PathSkipRoot.

CPathT::StripPath

Chiamare questo metodo per rimuovere la parte del percorso di un percorso completo e di un nome file.

void StripPath();

Osservazioni:

Per altre informazioni, vedere PathStripPath.

CPathT::StripToRoot

Chiamare questo metodo per rimuovere tutte le parti del percorso, ad eccezione delle informazioni radice.

BOOL StripToRoot();

Valore restituito

Restituisce TRUE se nel percorso è stata trovata una lettera di unità valida o FAL edizione Standard in caso contrario.

Osservazioni:

Per altre informazioni, vedere PathStripToRoot.

CPathT::UnquoteSpaces

Chiamare questo metodo per rimuovere le virgolette dall'inizio e dalla fine di un percorso.

void UnquoteSpaces();

Osservazioni:

Per altre informazioni, vedere PathUnquoteSpaces.

CPathT::XCHAR

Tipo carattere.

typedef StringType::XCHAR XCHAR;

Osservazioni:

StringType è il parametro del modello su CPathT.

Vedi anche

Classi
Classe CStringT