Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Opmerking
De ATL (Active Template Library) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.
Deze klasse vertegenwoordigt een pad.
Belangrijk
Deze klasse en de bijbehorende leden kunnen niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.
Syntaxis
template <typename StringType>
class CPathT
Parameterwaarden
StringType
De tekenreeksklasse ATL/MFC die moet worden gebruikt voor het pad (zie CStringT).
Leden
Openbare typedefs
| Naam | Description |
|---|---|
| CPathT::P CXSTR | Een constant tekenreekstype. |
| CPathT::P XSTR | Een tekenreekstype. |
| CPathT::XCHAR | Een tekentype. |
Openbare constructors
| Naam | Description |
|---|---|
| CPathT::CPathT | De constructor voor het pad. |
Openbare methoden
| Naam | Description |
|---|---|
| CPathT::AddBackslash | Roep deze methode aan om een backslash toe te voegen aan het einde van een tekenreeks om de juiste syntaxis voor een pad te maken. |
| CPathT::AddExtension | Roep deze methode aan om een bestandsextensie toe te voegen aan een pad. |
| CPathT::Toevoegen | Roep deze methode aan om een tekenreeks toe te voegen aan het huidige pad. |
| CPathT::BuildRoot | Roep deze methode aan om een hoofdpad te maken van een bepaald stationsnummer. |
| CPathT::Canonicalize | Roep deze methode aan om het pad naar canonieke vorm te converteren. |
| CPathT::Combine | Roep deze methode aan om een tekenreeks samen te voegen die een mapnaam vertegenwoordigt en een tekenreeks die een bestandsnaam vertegenwoordigt in één pad. |
| CPathT::CommonPrefix | Roep deze methode aan om te bepalen of het opgegeven pad een gemeenschappelijk voorvoegsel deelt met het huidige pad. |
| CPathT::CompactPath | Roep deze methode aan om een bestandspad af tekappen zodat het binnen een bepaalde pixelbreedte past door padonderdelen te vervangen door het beletselteken. |
| CPathT::CompactPathEx | Roep deze methode aan om een bestandspad af tekappen zodat het binnen een bepaald aantal tekens past door padonderdelen te vervangen door het beletselteken. |
| CPathT::FileExists | Roep deze methode aan om te controleren of het bestand op dit pad bestaat. |
| CPathT::FindExtension | Roep deze methode aan om de positie van de bestandsextensie binnen het pad te vinden. |
| CPathT::FindFileName | Roep deze methode aan om de positie van de bestandsnaam binnen het pad te vinden. |
| CPathT::GetDriveNumber | Roep deze methode aan om het pad naar een stationsletter binnen het bereik van 'A' naar 'Z' te zoeken en het bijbehorende stationsnummer te retourneren. |
| CPathT::GetExtension | Roep deze methode aan om de bestandsextensie op te halen uit het pad. |
| CPathT::IsDirectory | Roep deze methode aan om te controleren of het pad een geldige map is. |
| CPathT::IsFileSpec | Roep deze methode aan om een pad te zoeken naar padscheidingstekens (bijvoorbeeld : of \). Als er geen padscheidingstekens aanwezig zijn, wordt het pad beschouwd als een bestandsspecificatiepad. |
| CPathT::IsPrefix | Roep deze methode aan om te bepalen of een pad een geldig voorvoegsel bevat van het type dat wordt doorgegeven door pszPrefix. |
| CPathT::IsRelative | Roep deze methode aan om te bepalen of het pad relatief is. |
| CPathT::IsRoot | Roep deze methode aan om te bepalen of het pad een maphoofdmap is. |
| CPathT::IsSameRoot | Roep deze methode aan om te bepalen of een ander pad een gemeenschappelijk hoofdonderdeel heeft met het huidige pad. |
| CPathT::IsUNC | Roep deze methode aan om te bepalen of het pad een geldig UNC-pad (universal naming convention) is voor een server en share. |
| CPathT::IsUNCServer | Roep deze methode aan om te bepalen of het pad alleen een geldig UNC-pad (universal naming convention) voor een server is. |
| CPathT::IsUNCServerShare | Roep deze methode aan om te bepalen of het pad een geldig UNC(universal naming convention) sharepad is, \\server\share. |
| CPathT::MakePretty | Roep deze methode aan om een pad te converteren naar alle kleine letters om het pad een consistent uiterlijk te geven. |
| CPathT::MatchSpec | Roep deze methode aan om het pad te zoeken naar een tekenreeks met een jokertekenovereenkomsttype. |
| CPathT::QuoteSpaces | Roep deze methode aan om het pad tussen aanhalingstekens te plaatsen als het spaties bevat. |
| CPathT::RelativePathTo | Roep deze methode aan om een relatief pad te maken van het ene bestand of de ene map naar het andere. |
| CPathT::RemoveArgs | Roep deze methode aan om opdrachtregelargumenten uit het pad te verwijderen. |
| CPathT::RemoveBackslash | Roep deze methode aan om de afsluitende backslash van het pad te verwijderen. |
| CPathT::RemoveBlanks | Roep deze methode aan om alle voorloop- en volgspaties uit het pad te verwijderen. |
| CPathT::RemoveExtension | Roep deze methode aan om de bestandsextensie uit het pad te verwijderen, als er een is. |
| CPathT::RemoveFileSpec | Roep deze methode aan om de achtervolgende bestandsnaam en backslash van het pad te verwijderen, als deze deze bevat. |
| CPathT::RenameExtension | Roep deze methode aan om de bestandsnaamextensie in het pad te vervangen door een nieuwe extensie. Als de bestandsnaam geen extensie bevat, wordt de extensie gekoppeld aan het einde van de tekenreeks. |
| CPathT::SkipRoot | Roep deze methode aan om een pad te parseren, waarbij de stationsletter of UNC-server/deelpadonderdelen worden genegeerd. |
| CPathT::StripPath | Roep deze methode aan om het padgedeelte van een volledig gekwalificeerde pad en bestandsnaam te verwijderen. |
| CPathT::StripToRoot | Roep deze methode aan om alle delen van het pad te verwijderen, met uitzondering van de hoofdinformatie. |
| CPathT::UnquoteSpaces | Roep deze methode aan om aanhalingstekens van het begin en einde van een pad te verwijderen. |
Openbare operators
| Naam | Description |
|---|---|
| CPathT::operator const StringType & | Met deze operator kan het object worden behandeld als een tekenreeks. |
| CPathT::operator CPathT::P CXSTR | Met deze operator kan het object worden behandeld als een tekenreeks. |
| CPathT::operator StringType & | Met deze operator kan het object worden behandeld als een tekenreeks. |
| CPathT::operator += | Deze operator voegt een tekenreeks toe aan het pad. |
Publieke dataleden
| Naam | Description |
|---|---|
| CPathT::m_strPath | Het pad. |
Opmerkingen
CPath, CPathAen CPathW zijn instantiëringen van CPathT gedefinieerd als volgt:
typedef CPathT< CString > CPath;
typedef CPathT< CStringA > CPathA;
typedef CPathT< CStringW > CPathW;
Requirements
Koptekst: atlpath.h
CPathT::AddBackslash
Roep deze methode aan om een backslash toe te voegen aan het einde van een tekenreeks om de juiste syntaxis voor een pad te maken. Als het pad al een afsluitende backslash heeft, wordt er geen backslash toegevoegd.
void AddBackslash();
Opmerkingen
Zie PathAddBackSlash voor meer informatie.
CPathT::AddExtension
Roep deze methode aan om een bestandsextensie toe te voegen aan een pad.
BOOL AddExtension(PCXSTR pszExtension);
Parameterwaarden
pszExtension
De bestandsextensie die moet worden toegevoegd.
Retourwaarde
Retourneert TRUE bij succes, ONWAAR bij mislukt.
Opmerkingen
Zie PathAddExtension voor meer informatie.
CPathT::Toevoegen
Roep deze methode aan om een tekenreeks toe te voegen aan het huidige pad.
BOOL Append(PCXSTR pszMore);
Parameterwaarden
pszMore
De tekenreeks die moet worden toegevoegd.
Retourwaarde
Retourneert TRUE bij succes, ONWAAR bij mislukt.
Opmerkingen
Zie PathAppend voor meer informatie.
CPathT::BuildRoot
Roep deze methode aan om een hoofdpad te maken van een bepaald stationsnummer.
void BuildRoot(int iDrive);
Parameterwaarden
Idrive
Het stationnummer (0 is A:, 1 is B:, enzovoort).
Opmerkingen
Zie PathBuildRoot voor meer informatie.
CPathT::Canonicalize
Roep deze methode aan om het pad naar canonieke vorm te converteren.
void Canonicalize();
Opmerkingen
Zie PathCanonicalize voor meer informatie.
CPathT::Combine
Roep deze methode aan om een tekenreeks samen te voegen die een mapnaam vertegenwoordigt en een tekenreeks die een bestandsnaam vertegenwoordigt in één pad.
void Combine(PCXSTR pszDir, PCXSTR pszFile);
Parameterwaarden
pszDir
Het pad naar de map.
pszFile
Het bestandspad.
Opmerkingen
Zie PathCombine voor meer informatie.
CPathT::CommonPrefix
Roep deze methode aan om te bepalen of het opgegeven pad een gemeenschappelijk voorvoegsel deelt met het huidige pad.
CPathT<StringType> CommonPrefix(PCXSTR pszOther);
Parameterwaarden
pszOther
Het pad om te vergelijken met de huidige.
Retourwaarde
Retourneert het algemene voorvoegsel.
Opmerkingen
Een voorvoegsel is een van deze typen: "C:\\", ".", "..", ".. \\". Zie PathCommonPrefix voor meer informatie.
CPathT::CompactPath
Roep deze methode aan om een bestandspad af tekappen zodat het binnen een bepaalde pixelbreedte past door padonderdelen te vervangen door het beletselteken.
BOOL CompactPath(HDC hDC, UINT nWidth);
Parameterwaarden
Hdc
De apparaatcontext die wordt gebruikt voor metrische lettertypegegevens.
nWidth
De breedte, in pixels, waarin de tekenreeks wordt gedwongen in te passen.
Retourwaarde
Retourneert TRUE bij succes, ONWAAR bij mislukt.
Opmerkingen
Zie PathCompactPath voor meer informatie.
CPathT::CompactPathEx
Roep deze methode aan om een bestandspad af tekappen zodat het binnen een bepaald aantal tekens past door padonderdelen te vervangen door het beletselteken.
BOOL CompactPathEx(UINT nMaxChars, DWORD dwFlags = 0);
Parameterwaarden
nMaxChars
Het maximum aantal tekens dat moet worden opgenomen in de nieuwe tekenreeks, inclusief het afsluitende NULL-teken.
dwFlags
Gereserveerd.
Retourwaarde
Retourneert TRUE bij succes, ONWAAR bij mislukt.
Opmerkingen
Zie PathCompactPathEx voor meer informatie.
CPathT::CPathT
De constructor.
CPathT(PCXSTR pszPath);
CPathT(const CPathT<StringType>& path);
CPathT() throw();
Parameterwaarden
pszPath
De aanwijzer naar een padtekenreeks.
path
De padtekenreeks.
CPathT::FileExists
Roep deze methode aan om te controleren of het bestand op dit pad bestaat.
BOOL FileExists() const;
Retourwaarde
Retourneert TRUE als het bestand bestaat, anders ONWAAR.
Opmerkingen
Zie PathFileExists voor meer informatie.
CPathT::FindExtension
Roep deze methode aan om de positie van de bestandsextensie binnen het pad te vinden.
int FindExtension() const;
Retourwaarde
Retourneert de positie van de '.' voorafgaand aan de extensie. Als er geen extensie wordt gevonden, wordt -1 geretourneerd.
Opmerkingen
Zie PathFindExtension voor meer informatie.
CPathT::FindFileName
Roep deze methode aan om de positie van de bestandsnaam binnen het pad te vinden.
int FindFileName() const;
Retourwaarde
Retourneert de positie van de bestandsnaam. Als er geen bestandsnaam wordt gevonden, wordt -1 geretourneerd.
Opmerkingen
Zie PathFindFileName voor meer informatie.
CPathT::GetDriveNumber
Roep deze methode aan om het pad naar een stationsletter binnen het bereik van 'A' naar 'Z' te zoeken en het bijbehorende stationsnummer te retourneren.
int GetDriveNumber() const;
Retourwaarde
Retourneert het stationsnummer als een geheel getal van 0 tot en met 25 (overeenkomend met A tot en met Z) als het pad een stationsletter heeft of anders -1.
Opmerkingen
Zie PathGetDriveNumber voor meer informatie.
CPathT::GetExtension
Roep deze methode aan om de bestandsextensie op te halen uit het pad.
StringType GetExtension() const;
Retourwaarde
Retourneert de bestandsextensie.
CPathT::IsDirectory
Roep deze methode aan om te controleren of het pad een geldige map is.
BOOL IsDirectory() const;
Retourwaarde
Retourneert een niet-nulwaarde (16) als het pad een map is, anders ONWAAR.
Opmerkingen
Zie PathIsDirectory voor meer informatie.
CPathT::IsFileSpec
Roep deze methode aan om een pad te zoeken naar padscheidingstekens (bijvoorbeeld : of \). Als er geen padscheidingstekens aanwezig zijn, wordt het pad beschouwd als een bestandsspecificatiepad.
BOOL IsFileSpec() const;
Retourwaarde
Retourneert TRUE als er geen padscheidingstekens binnen het pad zijn, of ONWAAR als er padscheidingstekens zijn.
Opmerkingen
Zie PathIsFileSpec voor meer informatie.
CPathT::IsPrefix
Roep deze methode aan om te bepalen of een pad een geldig voorvoegsel bevat van het type dat wordt doorgegeven door pszPrefix.
BOOL IsPrefix(PCXSTR pszPrefix) const;
Parameterwaarden
pszPrefix
Het voorvoegsel waarnaar moet worden gezocht. Een voorvoegsel is een van deze typen: "C:\\", ".", "..", ".. \\".
Retourwaarde
Retourneert TRUE als het pad het voorvoegsel bevat of anders ONWAAR.
Opmerkingen
Zie PathIsPrefix voor meer informatie.
CPathT::IsRelative
Roep deze methode aan om te bepalen of het pad relatief is.
BOOL IsRelative() const;
Retourwaarde
Retourneert TRUE als het pad relatief is of ONWAAR als het absoluut is.
Opmerkingen
Zie PathIsRelative voor meer informatie.
CPathT::IsRoot
Roep deze methode aan om te bepalen of het pad een maphoofdmap is.
BOOL IsRoot() const;
Retourwaarde
Retourneert TRUE als het pad een hoofdmap is of anders ONWAAR.
Opmerkingen
Zie PathIsRoot voor meer informatie.
CPathT::IsSameRoot
Roep deze methode aan om te bepalen of een ander pad een gemeenschappelijk hoofdonderdeel heeft met het huidige pad.
BOOL IsSameRoot(PCXSTR pszOther) const;
Parameterwaarden
pszOther
Het andere pad.
Retourwaarde
Retourneert TRUE als beide tekenreeksen hetzelfde hoofdonderdeel hebben of anders ONWAAR.
Opmerkingen
Zie PathIsSameRoot voor meer informatie.
CPathT::IsUNC
Roep deze methode aan om te bepalen of het pad een geldig UNC-pad (universal naming convention) is voor een server en share.
BOOL IsUNC() const;
Retourwaarde
Retourneert TRUE als het pad een geldig UNC-pad is, of anders ONWAAR.
Opmerkingen
Zie PathIsUNC voor meer informatie.
CPathT::IsUNCServer
Roep deze methode aan om te bepalen of het pad alleen een geldig UNC-pad (universal naming convention) voor een server is.
BOOL IsUNCServer() const;
Retourwaarde
Retourneert TRUE als de tekenreeks alleen een geldig UNC-pad voor een server is (geen sharenaam) of ANDERS ONWAAR.
Opmerkingen
Zie PathIsUNCServer voor meer informatie.
CPathT::IsUNCServerShare
Roep deze methode aan om te bepalen of het pad een geldig UNC-pad (universal naming convention) is, \\ servershare\ .
BOOL IsUNCServerShare() const;
Retourwaarde
Retourneert TRUE als het pad zich in de vorm \\ servershare\ bevindt, of anders ONWAAR.
Opmerkingen
Zie PathIsUNCServerShare voor meer informatie.
CPathT::m_strPath
Het pad.
StringType m_strPath;
Opmerkingen
StringType is de sjabloonparameter voor CPathT.
CPathT::MakePretty
Roep deze methode aan om een pad te converteren naar alle kleine letters om het pad een consistent uiterlijk te geven.
BOOL MakePretty();
Retourwaarde
Retourneert TRUE als het pad is geconverteerd of anders ONWAAR.
Opmerkingen
Zie PathMakePretty voor meer informatie.
CPathT::MatchSpec
Roep deze methode aan om het pad te zoeken naar een tekenreeks met een jokertekenovereenkomsttype.
BOOL MatchSpec(PCXSTR pszSpec) const;
Parameterwaarden
pszSpec
Wijs een tekenreeks met null-beëindiging aan met het bestandstype waarnaar moet worden gezocht. Als u bijvoorbeeld wilt testen of het bestand op het huidige pad een DOC-bestand is, moet pszSpec worden ingesteld op '*.doc'.
Retourwaarde
Retourneert TRUE als de tekenreeks overeenkomt of anders ONWAAR.
Opmerkingen
Zie PathMatchSpec voor meer informatie.
CPathT::operator +=
Deze operator voegt een tekenreeks toe aan het pad.
CPathT<StringType>& operator+=(PCXSTR pszMore);
Parameterwaarden
pszMore
De tekenreeks die moet worden toegevoegd.
Retourwaarde
Retourneert het bijgewerkte pad.
CPathT::operator const StringType &
Met deze operator kan het object worden behandeld als een tekenreeks.
operator const StringType&() const throw();
Retourwaarde
Retourneert een tekenreeks die het huidige pad vertegenwoordigt dat wordt beheerd door dit object.
CPathT::operator CPathT::P CXSTR
Met deze operator kan het object worden behandeld als een tekenreeks.
operator PCXSTR() const throw();
Retourwaarde
Retourneert een tekenreeks die het huidige pad vertegenwoordigt dat wordt beheerd door dit object.
CPathT::operator StringType &
Met deze operator kan het object worden behandeld als een tekenreeks.
operator StringType&() throw();
Retourwaarde
Retourneert een tekenreeks die het huidige pad vertegenwoordigt dat wordt beheerd door dit object.
CPathT::P CXSTR
Een constant tekenreekstype.
typedef StringType::PCXSTR PCXSTR;
Opmerkingen
StringType is de sjabloonparameter voor CPathT.
CPathT::P XSTR
Een tekenreekstype.
typedef StringType::PXSTR PXSTR;
Opmerkingen
StringType is de sjabloonparameter voor CPathT.
CPathT::QuoteSpaces
Roep deze methode aan om het pad tussen aanhalingstekens te plaatsen als het spaties bevat.
void QuoteSpaces();
Opmerkingen
Zie PathQuoteSpaces voor meer informatie.
CPathT::RelativePathTo
Roep deze methode aan om een relatief pad te maken van het ene bestand of de ene map naar het andere.
BOOL RelativePathTo(
PCXSTR pszFrom,
DWORD dwAttrFrom,
PCXSTR pszTo,
DWORD dwAttrTo);
Parameterwaarden
pszFrom
Het begin van het relatieve pad.
dwAttrFrom
De bestandskenmerken van pszFrom. Als deze waarde FILE_ATTRIBUTE_DIRECTORY bevat, wordt ervan uitgegaan dat pszFrom een map is; anders wordt ervan uitgegaan dat pszFrom een bestand is.
pszTo
Het eindpunt van het relatieve pad.
dwAttrTo
De bestandskenmerken van pszTo. Als deze waarde FILE_ATTRIBUTE_DIRECTORY bevat, wordt ervan uitgegaan dat pszTo een map is; anders wordt ervan uitgegaan dat pszTo een bestand is.
Retourwaarde
Retourneert TRUE bij succes, ONWAAR bij mislukt.
Opmerkingen
Zie PathRelativePathTo voor meer informatie.
CPathT::RemoveArgs
Roep deze methode aan om opdrachtregelargumenten uit het pad te verwijderen.
void RemoveArgs();
Opmerkingen
Zie PathRemoveArgs voor meer informatie.
CPathT::RemoveBackslash
Roep deze methode aan om de afsluitende backslash van het pad te verwijderen.
void RemoveBackslash();
Opmerkingen
Zie PathRemoveBackslash voor meer informatie.
CPathT::RemoveBlanks
Roep deze methode aan om alle voorloop- en volgspaties uit het pad te verwijderen.
void RemoveBlanks();
Opmerkingen
Zie PathRemoveBlanks voor meer informatie.
CPathT::RemoveExtension
Roep deze methode aan om de bestandsextensie uit het pad te verwijderen, als er een is.
void RemoveExtension();
Opmerkingen
Zie PathRemoveExtension voor meer informatie.
CPathT::RemoveFileSpec
Roep deze methode aan om de achtervolgende bestandsnaam en backslash van het pad te verwijderen, als deze deze bevat.
BOOL RemoveFileSpec();
Retourwaarde
Retourneert TRUE bij succes, ONWAAR bij mislukt.
Opmerkingen
Zie PathRemoveFileSpec voor meer informatie.
CPathT::RenameExtension
Roep deze methode aan om de bestandsnaamextensie in het pad te vervangen door een nieuwe extensie. Als de bestandsnaam geen extensie bevat, wordt de extensie gekoppeld aan het einde van het pad.
BOOL RenameExtension(PCXSTR pszExtension);
Parameterwaarden
pszExtension
De nieuwe bestandsnaamextensie, voorafgegaan door een "." teken.
Retourwaarde
Retourneert TRUE bij succes, ONWAAR bij mislukt.
Opmerkingen
Zie PathRenameExtension voor meer informatie.
CPathT::SkipRoot
Roep deze methode aan om een pad te parseren, waarbij de stationsletter of UNC (universal naming convention) server-/sharepadonderdelen worden genegeerd.
int SkipRoot() const;
Retourwaarde
Retourneert de positie van het begin van het subpad dat volgt op de hoofdmap (stationsletter of UNC-server/share).
Opmerkingen
Zie PathSkipRoot voor meer informatie.
CPathT::StripPath
Roep deze methode aan om het padgedeelte van een volledig gekwalificeerde pad en bestandsnaam te verwijderen.
void StripPath();
Opmerkingen
Zie PathStripPath voor meer informatie.
CPathT::StripToRoot
Roep deze methode aan om alle delen van het pad te verwijderen, met uitzondering van de hoofdinformatie.
BOOL StripToRoot();
Retourwaarde
Retourneert TRUE als er een geldige stationsletter is gevonden in het pad, of anders ONWAAR.
Opmerkingen
Zie PathStripToRoot voor meer informatie.
CPathT::UnquoteSpaces
Roep deze methode aan om aanhalingstekens van het begin en einde van een pad te verwijderen.
void UnquoteSpaces();
Opmerkingen
Zie PathUnquoteSpaces voor meer informatie.
CPathT::XCHAR
Een tekentype.
typedef StringType::XCHAR XCHAR;
Opmerkingen
StringType is de sjabloonparameter voor CPathT.