Kelas CPathT
Kelas ini mewakili jalur.
Penting
Kelas ini dan anggotanya tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.
Sintaks
template <typename StringType>
class CPathT
Parameter
StringType
Kelas string ATL/MFC yang akan digunakan untuk jalur (lihat CStringT).
Anggota
Typedef Publik
| Nama | Deskripsi |
|---|---|
| CPathT::P CXSTR | Jenis string konstanta. |
| CPathT::P XSTR | Jenis string. |
| CPathT::XCHAR | Jenis karakter. |
Konstruktor Publik
| Nama | Deskripsi |
|---|---|
| CPathT::CPathT | Konstruktor untuk jalur. |
Metode Publik
| Nama | Deskripsi |
|---|---|
| CPathT::AddBackslash | Panggil metode ini untuk menambahkan garis miring terbalik ke akhir string untuk membuat sintaks yang benar untuk jalur. |
| CPathT::AddExtension | Panggil metode ini untuk menambahkan ekstensi file ke jalur. |
| CPathT::Tambahkan | Panggil metode ini untuk menambahkan string ke jalur saat ini. |
| CPathT::BuildRoot | Panggil metode ini untuk membuat jalur akar dari nomor drive tertentu. |
| CPathT::Canonicalize | Panggil metode ini untuk mengonversi jalur ke bentuk kanonis. |
| CPathT::Combine | Panggil metode ini untuk menggabungkan string yang mewakili nama direktori dan string yang mewakili nama jalur file ke dalam satu jalur. |
| CPathT::CommonPrefix | Panggil metode ini untuk menentukan apakah jalur yang ditentukan berbagi awalan umum dengan jalur saat ini. |
| CPathT::CompactPath | Panggil metode ini untuk memotong jalur file agar pas dalam lebar piksel tertentu dengan mengganti komponen jalur dengan elipsis. |
| CPathT::CompactPathEx | Panggil metode ini untuk memotong jalur file agar pas dalam sejumlah karakter tertentu dengan mengganti komponen jalur dengan elipsis. |
| CPathT::FileExists | Panggil metode ini untuk memeriksa apakah file pada nama jalur ini ada. |
| CPatht::FindExtension | Panggil metode ini untuk menemukan posisi ekstensi file di dalam jalur. |
| CPatht::FindFileName | Panggil metode ini untuk menemukan posisi nama file di dalam jalur. |
| CPathT::GetDriveNumber | Panggil metode ini untuk mencari jalur huruf drive dalam rentang 'A' ke 'Z' dan kembalikan nomor drive yang sesuai. |
| CPathT::GetExtension | Panggil metode ini untuk mendapatkan ekstensi file dari jalur. |
| CPathT::IsDirectory | Panggil metode ini untuk memeriksa apakah jalur tersebut adalah direktori yang valid. |
| CPathT::IsFileSpec | Panggil metode ini untuk mencari jalur untuk karakter pembatas jalur apa pun (misalnya, : atau \). Jika tidak ada karakter pembatas jalur yang ada, jalur dianggap sebagai jalur Spesifikasi File. |
| CPathT::IsPrefix | Panggil metode ini untuk menentukan apakah jalur berisi awalan yang valid dari jenis yang diteruskan oleh pszPrefix. |
| CPathT::IsRelative | Panggil metode ini untuk menentukan apakah jalur relatif. |
| CPathT::IsRoot | Panggil metode ini untuk menentukan apakah jalur adalah akar direktori. |
| CPathT::IsSameRoot | Panggil metode ini untuk menentukan apakah jalur lain memiliki komponen akar umum dengan jalur saat ini. |
| CPatht::IsUNC | Panggil metode ini untuk menentukan apakah jalur adalah jalur UNC (konvensi penamaan universal) yang valid untuk server dan berbagi. |
| CPatht::IsUNCServer | Panggil metode ini untuk menentukan apakah jalur tersebut adalah jalur UNC (konvensi penamaan universal) yang valid hanya untuk server. |
| CPatht::IsUNCServerShare | Panggil metode ini untuk menentukan apakah jalur adalah jalur berbagi UNC (konvensi penamaan universal) yang valid, \\server\share. |
| CPathT::MakePretty | Panggil metode ini untuk mengonversi jalur ke semua karakter huruf kecil untuk memberikan jalur tampilan yang konsisten. |
| CPathT::MatchSpec | Panggil metode ini untuk mencari jalur untuk string yang berisi jenis pencocokan kartubebas. |
| CPathT::QuoteSpaces | Panggil metode ini untuk mengapit jalur dalam tanda kutip jika berisi spasi. |
| CPatht::RelativePathTo | Panggil metode ini untuk membuat jalur relatif dari satu file atau folder ke file atau folder lainnya. |
| CPathT::RemoveArgs | Panggil metode ini untuk menghapus argumen baris perintah apa pun dari jalur. |
| CPathT::RemoveBackslash | Panggil metode ini untuk menghapus garis miring terbelakang dari jalur. |
| CPathT::RemoveBlanks | Panggil metode ini untuk menghapus semua spasi di depan dan belakang dari jalur. |
| CPatht::RemoveExtension | Panggil metode ini untuk menghapus ekstensi file dari jalur, jika ada. |
| CPathT::RemoveFileSpec | Panggil metode ini untuk menghapus nama file dan garis miring terbelakang dari jalur, jika memilikinya. |
| CPathT::RenameExtension | Panggil metode ini untuk mengganti ekstensi nama file di jalur dengan ekstensi baru. Jika nama file tidak berisi ekstensi, ekstensi akan dilampirkan ke akhir string. |
| CPathT::SkipRoot | Panggil metode ini untuk mengurai jalur, mengabaikan huruf kandar atau bagian jalur server/berbagi UNC. |
| CPathT::StripPath | Panggil metode ini untuk menghapus bagian jalur dari jalur dan nama file yang sepenuhnya memenuhi syarat. |
| CPatht::StripToRoot | Panggil metode ini untuk menghapus semua bagian jalur kecuali untuk informasi akar. |
| CPathT::UnquoteSpaces | Panggil metode ini untuk menghapus tanda kutip dari awal dan akhir jalur. |
Operator Publik
| Nama | Deskripsi |
|---|---|
| CPathT::operator const StringType & | Operator ini memungkinkan objek diperlakukan seperti string. |
| CPathT::operator CPathT::P CXSTR | Operator ini memungkinkan objek diperlakukan seperti string. |
| CPathT::operator StringType & | Operator ini memungkinkan objek diperlakukan seperti string. |
| CPathT::operator += | Operator ini menambahkan string ke jalur. |
Anggota Data Publik
| Nama | Deskripsi |
|---|---|
| CPathT::m_strPath | Jalur. |
Keterangan
CPath, CPathA, dan CPathW merupakan instansiasi dari CPathT yang didefinisikan sebagai berikut:
typedef CPathT< CString > CPath;
typedef CPathT< CStringA > CPathA;
typedef CPathT< CStringW > CPathW;
Persyaratan
Header: atlpath.h
CPathT::AddBackslash
Panggil metode ini untuk menambahkan garis miring terbalik ke akhir string untuk membuat sintaks yang benar untuk jalur. Jika jalur sudah memiliki garis miring terbalik berikutnya, tidak ada garis miring terbalik yang akan ditambahkan.
void AddBackslash();
Keterangan
Untuk informasi selengkapnya, lihat PathAddBackSlash.
CPathT::AddExtension
Panggil metode ini untuk menambahkan ekstensi file ke jalur.
BOOL AddExtension(PCXSTR pszExtension);
Parameter
pszExtension
Ekstensi file yang akan ditambahkan.
Tampilkan Nilai
Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.
Keterangan
Untuk informasi selengkapnya, lihat PathAddExtension.
CPathT::Tambahkan
Panggil metode ini untuk menambahkan string ke jalur saat ini.
BOOL Append(PCXSTR pszMore);
Parameter
pszMore
String yang akan ditambahkan.
Tampilkan Nilai
Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.
Keterangan
Untuk informasi selengkapnya, lihat PathAppend.
CPathT::BuildRoot
Panggil metode ini untuk membuat jalur akar dari nomor drive tertentu.
void BuildRoot(int iDrive);
Parameter
iDrive
Nomor drive (0 adalah A:, 1 adalah B:, dan sebagainya).
Keterangan
Untuk informasi selengkapnya, lihat PathBuildRoot.
CPathT::Canonicalize
Panggil metode ini untuk mengonversi jalur ke bentuk kanonis.
void Canonicalize();
Keterangan
Untuk informasi selengkapnya, lihat PathCanonicalize.
CPathT::Combine
Panggil metode ini untuk menggabungkan string yang mewakili nama direktori dan string yang mewakili nama jalur file ke dalam satu jalur.
void Combine(PCXSTR pszDir, PCXSTR pszFile);
Parameter
pszDir
Jalur direktori.
pszFile
Jalur file.
Keterangan
Untuk informasi selengkapnya, lihat PathCombine.
CPathT::CommonPrefix
Panggil metode ini untuk menentukan apakah jalur yang ditentukan berbagi awalan umum dengan jalur saat ini.
CPathT<StringType> CommonPrefix(PCXSTR pszOther);
Parameter
pszOther
Jalur untuk dibandingkan dengan yang saat ini.
Tampilkan Nilai
Mengembalikan awalan umum.
Keterangan
Awalan adalah salah satu jenis ini: "C:\\", ".", "..", ".. \\". Untuk informasi selengkapnya, lihat PathCommonPrefix.
CPathT::CompactPath
Panggil metode ini untuk memotong jalur file agar pas dalam lebar piksel tertentu dengan mengganti komponen jalur dengan elipsis.
BOOL CompactPath(HDC hDC, UINT nWidth);
Parameter
hDC
Konteks perangkat yang digunakan untuk metrik font.
nWidth
Lebar, dalam piksel, bahwa string akan dipaksa untuk pas.
Tampilkan Nilai
Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.
Keterangan
Untuk informasi selengkapnya, lihat PathCompactPath.
CPathT::CompactPathEx
Panggil metode ini untuk memotong jalur file agar pas dalam sejumlah karakter tertentu dengan mengganti komponen jalur dengan elipsis.
BOOL CompactPathEx(UINT nMaxChars, DWORD dwFlags = 0);
Parameter
nMaxChars
Jumlah maksimum karakter yang akan dimuat dalam string baru, termasuk karakter NULL yang mengakhiri.
dwFlags
Dicadangkan.
Tampilkan Nilai
Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.
Keterangan
Untuk informasi selengkapnya, lihat PathCompactPathEx.
CPathT::CPathT
Konstruktor.
CPathT(PCXSTR pszPath);
CPathT(const CPathT<StringType>& path);
CPathT() throw();
Parameter
pszPath
Penunjuk ke string jalur.
jalan
String jalur.
CPathT::FileExists
Panggil metode ini untuk memeriksa apakah file pada nama jalur ini ada.
BOOL FileExists() const;
Tampilkan Nilai
Mengembalikan TRUE jika file ada, FALSE jika tidak.
Keterangan
Untuk informasi selengkapnya, lihat PathFileExists.
CPatht::FindExtension
Panggil metode ini untuk menemukan posisi ekstensi file di dalam jalur.
int FindExtension() const;
Tampilkan Nilai
Mengembalikan posisi "." sebelum ekstensi. Jika tidak ada ekstensi yang ditemukan, mengembalikan -1.
Keterangan
Untuk informasi selengkapnya, lihat PathFindExtension.
CPatht::FindFileName
Panggil metode ini untuk menemukan posisi nama file di dalam jalur.
int FindFileName() const;
Tampilkan Nilai
Mengembalikan posisi nama file. Jika tidak ada nama file yang ditemukan, mengembalikan -1.
Keterangan
Untuk informasi selengkapnya, lihat PathFindFileName.
CPathT::GetDriveNumber
Panggil metode ini untuk mencari jalur huruf drive dalam rentang 'A' ke 'Z' dan kembalikan nomor drive yang sesuai.
int GetDriveNumber() const;
Tampilkan Nilai
Mengembalikan nomor drive sebagai bilangan bulat dari 0 hingga 25 (sesuai dengan 'A' hingga 'Z') jika jalur memiliki huruf drive, atau -1 sebaliknya.
Keterangan
Untuk informasi selengkapnya, lihat PathGetDriveNumber.
CPathT::GetExtension
Panggil metode ini untuk mendapatkan ekstensi file dari jalur.
StringType GetExtension() const;
Tampilkan Nilai
Mengembalikan ekstensi file.
CPathT::IsDirectory
Panggil metode ini untuk memeriksa apakah jalur tersebut adalah direktori yang valid.
BOOL IsDirectory() const;
Tampilkan Nilai
Mengembalikan nilai bukan nol (16) jika jalurnya adalah direktori, FALSE jika tidak.
Keterangan
Untuk informasi selengkapnya, lihat PathIsDirectory.
CPathT::IsFileSpec
Panggil metode ini untuk mencari jalur untuk karakter pembatas jalur apa pun (misalnya, : atau \). Jika tidak ada karakter pembatas jalur yang ada, jalur dianggap sebagai jalur Spesifikasi File.
BOOL IsFileSpec() const;
Tampilkan Nilai
Mengembalikan TRUE jika tidak ada karakter pembatas jalur dalam jalur, atau FALSE jika ada karakter pembatas jalur.
Keterangan
Untuk informasi selengkapnya, lihat PathIsFileSpec.
CPathT::IsPrefix
Panggil metode ini untuk menentukan apakah jalur berisi awalan yang valid dari jenis yang diteruskan oleh pszPrefix.
BOOL IsPrefix(PCXSTR pszPrefix) const;
Parameter
pszPrefix
Awalan yang akan dicari. Awalan adalah salah satu jenis ini: "C:\\", ".", "..", ".. \\".
Tampilkan Nilai
Mengembalikan TRUE jika jalur berisi awalan, atau FALSE sebaliknya.
Keterangan
Untuk informasi selengkapnya, lihat PathIsPrefix.
CPathT::IsRelative
Panggil metode ini untuk menentukan apakah jalur relatif.
BOOL IsRelative() const;
Tampilkan Nilai
Mengembalikan TRUE jika jalur relatif, atau FALSE jika absolut.
Keterangan
Untuk informasi selengkapnya, lihat PathIsRelative.
CPathT::IsRoot
Panggil metode ini untuk menentukan apakah jalur adalah akar direktori.
BOOL IsRoot() const;
Tampilkan Nilai
Mengembalikan TRUE jika jalur adalah root, atau FALSE sebaliknya.
Keterangan
Untuk informasi selengkapnya, lihat PathIsRoot.
CPathT::IsSameRoot
Panggil metode ini untuk menentukan apakah jalur lain memiliki komponen akar umum dengan jalur saat ini.
BOOL IsSameRoot(PCXSTR pszOther) const;
Parameter
pszOther
Jalur lainnya.
Tampilkan Nilai
Mengembalikan TRUE jika kedua string memiliki komponen akar yang sama, atau FALSE sebaliknya.
Keterangan
Untuk informasi selengkapnya, lihat PathIsSameRoot.
CPatht::IsUNC
Panggil metode ini untuk menentukan apakah jalur adalah jalur UNC (konvensi penamaan universal) yang valid untuk server dan berbagi.
BOOL IsUNC() const;
Tampilkan Nilai
Mengembalikan TRUE jika jalurnya adalah jalur UNC yang valid, atau FALSE sebaliknya.
Keterangan
Untuk informasi selengkapnya, lihat PathIsUNC.
CPatht::IsUNCServer
Panggil metode ini untuk menentukan apakah jalur tersebut adalah jalur UNC (konvensi penamaan universal) yang valid hanya untuk server.
BOOL IsUNCServer() const;
Tampilkan Nilai
Mengembalikan TRUE jika string adalah jalur UNC yang valid hanya untuk server (tanpa nama berbagi), atau FALSE sebaliknya.
Keterangan
Untuk informasi selengkapnya, lihat PathIsUNCServer.
CPatht::IsUNCServerShare
Panggil metode ini untuk menentukan apakah jalur adalah jalur berbagi UNC (konvensi penamaan universal) yang valid, \\ berbagi server\ .
BOOL IsUNCServerShare() const;
Tampilkan Nilai
Mengembalikan TRUE jika jalur berada dalam formulir \\ berbagi server\ , atau FALSE jika tidak.
Keterangan
Untuk informasi selengkapnya, lihat PathIsUNCServerShare.
CPathT::m_strPath
Jalur.
StringType m_strPath;
Keterangan
StringType adalah parameter templat ke CPathT.
CPathT::MakePretty
Panggil metode ini untuk mengonversi jalur ke semua karakter huruf kecil untuk memberikan jalur tampilan yang konsisten.
BOOL MakePretty();
Tampilkan Nilai
Mengembalikan TRUE jika jalur telah dikonversi, atau FALSE sebaliknya.
Keterangan
Untuk informasi selengkapnya, lihat PathMakePretty.
CPathT::MatchSpec
Panggil metode ini untuk mencari jalur untuk string yang berisi jenis pencocokan kartubebas.
BOOL MatchSpec(PCXSTR pszSpec) const;
Parameter
pszSpec
Penunjuk ke string yang dihentikan null dengan jenis file yang akan dicari. Misalnya, untuk menguji apakah file di jalur saat ini adalah file DOC, pszSpec harus diatur ke "*.doc".
Tampilkan Nilai
Mengembalikan TRUE jika string cocok, atau FALSE sebaliknya.
Keterangan
Untuk informasi selengkapnya, lihat PathMatchSpec.
CPathT::operator +=
Operator ini menambahkan string ke jalur.
CPathT<StringType>& operator+=(PCXSTR pszMore);
Parameter
pszMore
String yang akan ditambahkan.
Tampilkan Nilai
Mengembalikan jalur yang diperbarui.
CPathT::operator const StringType &
Operator ini memungkinkan objek diperlakukan seperti string.
operator const StringType&() const throw();
Tampilkan Nilai
Mengembalikan string yang mewakili jalur saat ini yang dikelola oleh objek ini.
CPathT::operator CPathT::P CXSTR
Operator ini memungkinkan objek diperlakukan seperti string.
operator PCXSTR() const throw();
Tampilkan Nilai
Mengembalikan string yang mewakili jalur saat ini yang dikelola oleh objek ini.
CPathT::operator StringType &
Operator ini memungkinkan objek diperlakukan seperti string.
operator StringType&() throw();
Tampilkan Nilai
Mengembalikan string yang mewakili jalur saat ini yang dikelola oleh objek ini.
CPathT::P CXSTR
Jenis string konstanta.
typedef StringType::PCXSTR PCXSTR;
Keterangan
StringType adalah parameter templat ke CPathT.
CPathT::P XSTR
Jenis string.
typedef StringType::PXSTR PXSTR;
Keterangan
StringType adalah parameter templat ke CPathT.
CPathT::QuoteSpaces
Panggil metode ini untuk mengapit jalur dalam tanda kutip jika berisi spasi.
void QuoteSpaces();
Keterangan
Untuk informasi selengkapnya, lihat PathQuoteSpaces.
CPatht::RelativePathTo
Panggil metode ini untuk membuat jalur relatif dari satu file atau folder ke file atau folder lainnya.
BOOL RelativePathTo(
PCXSTR pszFrom,
DWORD dwAttrFrom,
PCXSTR pszTo,
DWORD dwAttrTo);
Parameter
pszFrom
Awal jalur relatif.
dwAttrFrom
Atribut File pszFrom. Jika nilai ini berisi FILE_ATTRIBUTE_DIRECTORY, pszFrom diasumsikan sebagai direktori; jika tidak, pszFrom diasumsikan sebagai file.
pszTo
Titik akhir jalur relatif.
dwAttrTo
Atribut File pszTo. Jika nilai ini berisi FILE_ATTRIBUTE_DIRECTORY, pszTo diasumsikan sebagai direktori; jika tidak, pszTo diasumsikan sebagai file.
Tampilkan Nilai
Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.
Keterangan
Untuk informasi selengkapnya, lihat PathRelativePathTo.
CPathT::RemoveArgs
Panggil metode ini untuk menghapus argumen baris perintah apa pun dari jalur.
void RemoveArgs();
Keterangan
Untuk informasi selengkapnya, lihat PathRemoveArgs.
CPathT::RemoveBackslash
Panggil metode ini untuk menghapus garis miring terbelakang dari jalur.
void RemoveBackslash();
Keterangan
Untuk informasi selengkapnya, lihat PathRemoveBackslash.
CPathT::RemoveBlanks
Panggil metode ini untuk menghapus semua spasi di depan dan belakang dari jalur.
void RemoveBlanks();
Keterangan
Untuk informasi selengkapnya, lihat PathRemoveBlanks.
CPatht::RemoveExtension
Panggil metode ini untuk menghapus ekstensi file dari jalur, jika ada.
void RemoveExtension();
Keterangan
Untuk informasi selengkapnya, lihat PathRemoveExtension.
CPathT::RemoveFileSpec
Panggil metode ini untuk menghapus nama file dan garis miring terbelakang dari jalur, jika memilikinya.
BOOL RemoveFileSpec();
Tampilkan Nilai
Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.
Keterangan
Untuk informasi selengkapnya, lihat PathRemoveFileSpec.
CPathT::RenameExtension
Panggil metode ini untuk mengganti ekstensi nama file di jalur dengan ekstensi baru. Jika nama file tidak berisi ekstensi, ekstensi akan dilampirkan ke akhir jalur.
BOOL RenameExtension(PCXSTR pszExtension);
Parameter
pszExtension
Ekstensi nama file baru, didahului oleh karakter ".".
Tampilkan Nilai
Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.
Keterangan
Untuk informasi selengkapnya, lihat PathRenameExtension.
CPathT::SkipRoot
Panggil metode ini untuk mengurai jalur, mengabaikan huruf kandar atau unc (konvensi penamaan universal) bagian jalur/berbagi.
int SkipRoot() const;
Tampilkan Nilai
Mengembalikan posisi awal subpath yang mengikuti akar (huruf kandar atau server/berbagi UNC).
Keterangan
Untuk informasi selengkapnya, lihat PathSkipRoot.
CPathT::StripPath
Panggil metode ini untuk menghapus bagian jalur dari jalur dan nama file yang sepenuhnya memenuhi syarat.
void StripPath();
Keterangan
Untuk informasi selengkapnya, lihat PathStripPath.
CPatht::StripToRoot
Panggil metode ini untuk menghapus semua bagian jalur kecuali untuk informasi akar.
BOOL StripToRoot();
Tampilkan Nilai
Mengembalikan TRUE jika huruf kandar yang valid ditemukan di jalur, atau FALSE sebaliknya.
Keterangan
Untuk informasi selengkapnya, lihat PathStripToRoot.
CPathT::UnquoteSpaces
Panggil metode ini untuk menghapus tanda kutip dari awal dan akhir jalur.
void UnquoteSpaces();
Keterangan
Untuk informasi selengkapnya, lihat PathUnquoteSpaces.
CPathT::XCHAR
Jenis karakter.
typedef StringType::XCHAR XCHAR;
Keterangan
StringType adalah parameter templat ke CPathT.