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, FALSE 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, FALSE 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, FALSE 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, FALSE 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, false 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, FALSE 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 FALSE 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 FALSE 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 FALSE 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 FALSE 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 FALSE 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 FALSE 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 FALSE 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 FALSE 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 FALSE 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 FALSE 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, FALSE 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, FALSE 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, FALSE 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 FALSE 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.