Aracılığıyla paylaş


CPathT Sınıfı

Bu sınıf bir yolu temsil eder.

Önemli

Bu sınıf ve üyeleri Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz.

Sözdizimi

template <typename StringType>
class CPathT

Parametreler

StringType
Yol için kullanılacak ATL/MFC dize sınıfı (bkz . CStringT).

Üyeler

Genel Tür Tanımları

Veri Akışı Adı Açıklama
CPathT::P CXSTR Sabit dize türü.
CPathT::P XSTR Dize türü.
CPathT::XCHAR Karakter türü.

Ortak Oluşturucular

Veri Akışı Adı Açıklama
CPathT::CPathT Yol için oluşturucu.

Genel Yöntemler

Veri Akışı Adı Açıklama
CPathT::AddBackslash Bir yol için doğru söz dizimini oluşturmak üzere dizenin sonuna ters eğik çizgi eklemek için bu yöntemi çağırın.
CPathT::AddExtension Bir yola dosya uzantısı eklemek için bu yöntemi çağırabilirsiniz.
CPathT::Append Geçerli yola bir dize eklemek için bu yöntemi çağırın.
CPathT::BuildRoot Belirli bir sürücü numarasından kök yol oluşturmak için bu yöntemi çağırabilirsiniz.
CPathT::Canonicalize Yolu kurallı forma dönüştürmek için bu yöntemi çağırın.
CPathT::Combine Dizin adını temsil eden bir dizeyi ve dosya yolu adını temsil eden bir dizeyi tek bir yolda birleştirmek için bu yöntemi çağırabilirsiniz.
CPathT::CommonPrefix Belirtilen yolun geçerli yolla ortak bir ön ek paylaşıp paylaşmadığını belirlemek için bu yöntemi çağırın.
CPathT::CompactPath Yol bileşenlerini üç noktayla değiştirerek belirli bir piksel genişliğine sığacak şekilde bir dosya yolunu kesecek şekilde bu yöntemi çağırabilirsiniz.
CPathT::CompactPathEx Yol bileşenlerini üç noktayla değiştirerek belirli sayıda karaktere sığacak şekilde bir dosya yolunu kesmeye yönelik bu yöntemi çağırın.
CPathT::FileExists Bu yol adındaki dosyanın var olup olmadığını denetlemek için bu yöntemi çağırın.
CPathT::FindExtension Dosya uzantısının yol içindeki konumunu bulmak için bu yöntemi çağırın.
CPathT::FindFileName Dosya adının yol içindeki konumunu bulmak için bu yöntemi çağırın.
CPathT::GetDriveNumber 'A' ile 'Z' aralığındaki bir sürücü harfinin yolunu aramak ve karşılık gelen sürücü numarasını döndürmek için bu yöntemi çağırın.
CPathT::GetExtension Dosya uzantısını yoldan almak için bu yöntemi çağırın.
CPathT::IsDirectory Yolun geçerli bir dizin olup olmadığını denetlemek için bu yöntemi çağırın.
CPathT::IsFileSpec Yol sınırlandıran karakterleri (örneğin, : veya \) aramak için bu yöntemi çağırabilirsiniz. Yol sınırlayıcı karakter yoksa, yol Dosya Belirtimi yolu olarak kabul edilir.
CPathT::IsPrefix Yolun pszPrefix tarafından geçirilen türün geçerli bir ön ekini içerip içermediğini belirlemek için bu yöntemi çağırın.
CPathT::IsRelative Yolun göreli olup olmadığını belirlemek için bu yöntemi çağırın.
CPathT::IsRoot Yolun bir dizin kökü olup olmadığını belirlemek için bu yöntemi çağırın.
CPathT::IsSameRoot Başka bir yolun geçerli yol ile ortak bir kök bileşeni olup olmadığını belirlemek için bu yöntemi çağırın.
CPathT::IsUNC Yolun bir sunucu ve paylaşım için geçerli bir UNC (evrensel adlandırma kuralı) yolu olup olmadığını belirlemek için bu yöntemi çağırın.
CPathT::IsUNCServer Yolun yalnızca bir sunucu için geçerli bir UNC (evrensel adlandırma kuralı) yolu olup olmadığını belirlemek için bu yöntemi çağırın.
CPathT::IsUNCServerShare Yolun geçerli bir UNC (evrensel adlandırma kuralı) paylaşım yolu \\server\shareolup olmadığını belirlemek için bu yöntemi çağırın.
CPathT::MakePretty Yolu tüm küçük harflere dönüştürerek yola tutarlı bir görünüm kazandırmak için bu yöntemi çağırın.
CPathT::MatchSpec Joker karakter eşleştirme türü içeren bir dizenin yolunu aramak için bu yöntemi çağırın.
CPathT::QuoteSpaces Boşluk içeriyorsa yolu tırnak içine almak için bu yöntemi çağırın.
CPathT::RelativePathTo Bir dosyadan veya klasörden diğerine göreli yol oluşturmak için bu yöntemi çağırabilirsiniz.
CPathT::RemoveArgs Yoldaki tüm komut satırı bağımsız değişkenlerini kaldırmak için bu yöntemi çağırın.
CPathT::RemoveBackslash Sondaki ters eğik çizgiyi yoldan kaldırmak için bu yöntemi çağırın.
CPathT::RemoveBlanks Yoldaki tüm baştaki ve sondaki boşlukları kaldırmak için bu yöntemi çağırın.
CPathT::RemoveExtension Varsa dosya uzantısını yoldan kaldırmak için bu yöntemi çağırın.
CPathT::RemoveFileSpec Varsa, sonundaki dosya adını ve ters eğik çizgiyi yoldan kaldırmak için bu yöntemi çağırın.
CPathT::RenameExtension Yoldaki dosya adı uzantısını yeni bir uzantıyla değiştirmek için bu yöntemi çağırın. Dosya adı bir uzantı içermiyorsa, uzantı dizenin sonuna eklenir.
CPathT::SkipRoot Sürücü harfini veya UNC sunucusu/paylaşım yolu bölümlerini yoksayarak yolu ayrıştırmak için bu yöntemi çağırın.
CPathT::StripPath Tam yol ve dosya adının yol bölümünü kaldırmak için bu yöntemi çağırın.
CPathT::StripToRoot Kök bilgiler dışında yolun tüm bölümlerini kaldırmak için bu yöntemi çağırın.
CPathT::UnquoteSpaces Yolun başından ve sonundan tırnak işaretlerini kaldırmak için bu yöntemi çağırın.

Ortak İşleçler

Veri Akışı Adı Açıklama
CPathT::operator const StringType & Bu işleç, nesnenin dize gibi değerlendirilmesini sağlar.
CPathT::operator CPathT::P CXSTR Bu işleç, nesnenin dize gibi değerlendirilmesini sağlar.
CPathT::operator StringType & Bu işleç, nesnenin dize gibi değerlendirilmesini sağlar.
CPathT::operator += Bu işleç yola bir dize ekler.

Ortak Veri Üyeleri

Veri Akışı Adı Açıklama
CPathT::m_strPath Yol.

Açıklamalar

CPath, CPathAve CPathW örneği CPathT aşağıdaki gibi tanımlanmıştır:

typedef CPathT< CString > CPath;

typedef CPathT< CStringA > CPathA;

typedef CPathT< CStringW > CPathW;

Gereksinimler

Üst bilgi: atlpath.h

CPathT::AddBackslash

Bir yol için doğru söz dizimini oluşturmak üzere dizenin sonuna ters eğik çizgi eklemek için bu yöntemi çağırın. Yolun sonunda bir ters eğik çizgi varsa, ters eğik çizgi eklenmez.

void AddBackslash();

Açıklamalar

Daha fazla bilgi için bkz . PathAddBackSlash.

CPathT::AddExtension

Bir yola dosya uzantısı eklemek için bu yöntemi çağırabilirsiniz.

BOOL AddExtension(PCXSTR pszExtension);

Parametreler

pszExtension
Eklenecek dosya uzantısı.

Dönüş Değeri

Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathAddExtension.

CPathT::Append

Geçerli yola bir dize eklemek için bu yöntemi çağırın.

BOOL Append(PCXSTR pszMore);

Parametreler

pszMore
Eklenecek dize.

Dönüş Değeri

Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathAppend.

CPathT::BuildRoot

Belirli bir sürücü numarasından kök yol oluşturmak için bu yöntemi çağırabilirsiniz.

void BuildRoot(int iDrive);

Parametreler

iDrive
Sürücü numarası (0, A:1, B:vb.).

Açıklamalar

Daha fazla bilgi için bkz . PathBuildRoot.

CPathT::Canonicalize

Yolu kurallı forma dönüştürmek için bu yöntemi çağırın.

void Canonicalize();

Açıklamalar

Daha fazla bilgi için bkz . PathCanonicalize.

CPathT::Combine

Dizin adını temsil eden bir dizeyi ve dosya yolu adını temsil eden bir dizeyi tek bir yolda birleştirmek için bu yöntemi çağırabilirsiniz.

void Combine(PCXSTR pszDir, PCXSTR  pszFile);

Parametreler

pszDir
Dizin yolu.

pszFile
Dosya yolu.

Açıklamalar

Daha fazla bilgi için bkz . PathCombine.

CPathT::CommonPrefix

Belirtilen yolun geçerli yolla ortak bir ön ek paylaşıp paylaşmadığını belirlemek için bu yöntemi çağırın.

CPathT<StringType> CommonPrefix(PCXSTR pszOther);

Parametreler

pszOther
Geçerli olanla karşılaştıracak yol.

Dönüş Değeri

Ortak ön eki döndürür.

Açıklamalar

Ön ek şu türlerden biridir: "C:\\", ".", "..", "... \\". Daha fazla bilgi için bkz . PathCommonPrefix.

CPathT::CompactPath

Yol bileşenlerini üç noktayla değiştirerek belirli bir piksel genişliğine sığacak şekilde bir dosya yolunu kesecek şekilde bu yöntemi çağırabilirsiniz.

BOOL CompactPath(HDC hDC, UINT nWidth);

Parametreler

hDC
Yazı tipi ölçümleri için kullanılan cihaz bağlamı.

nWidth
Dizenin sığmaya zorlanacağı piksel cinsinden genişlik.

Dönüş Değeri

Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathCompactPath.

CPathT::CompactPathEx

Yol bileşenlerini üç noktayla değiştirerek belirli sayıda karaktere sığacak şekilde bir dosya yolunu kesmeye yönelik bu yöntemi çağırın.

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

Parametreler

nMaxChars
Sonlandırıcı NULL karakteri de dahil olmak üzere yeni dizede yer alan karakter sayısı üst sınırı.

dwFlags
Ayrılmış.

Dönüş Değeri

Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathCompactPathEx.

CPathT::CPathT

Oluşturucu.

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

Parametreler

pszPath
Yol dizesi işaretçisi.

yol
Yol dizesi.

CPathT::FileExists

Bu yol adındaki dosyanın var olup olmadığını denetlemek için bu yöntemi çağırın.

BOOL FileExists() const;

Dönüş Değeri

Dosya varsa TRUE, aksi takdirde YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathFileExists.

CPathT::FindExtension

Dosya uzantısının yol içindeki konumunu bulmak için bu yöntemi çağırın.

int FindExtension() const;

Dönüş Değeri

Uzantıdan önceki "." konumunu döndürür. Uzantı bulunmazsa -1 döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathFindExtension.

CPathT::FindFileName

Dosya adının yol içindeki konumunu bulmak için bu yöntemi çağırın.

int FindFileName() const;

Dönüş Değeri

Dosya adının konumunu döndürür. Dosya adı bulunmazsa -1 döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathFindFileName.

CPathT::GetDriveNumber

'A' ile 'Z' aralığındaki bir sürücü harfinin yolunu aramak ve karşılık gelen sürücü numarasını döndürmek için bu yöntemi çağırın.

int GetDriveNumber() const;

Dönüş Değeri

Yolun sürücü harfi varsa sürücü numarasını 0 ile 25 arasında bir tamsayı ('A' ile 'Z' arasında) veya başka bir şekilde -1 olarak döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathGetDriveNumber.

CPathT::GetExtension

Dosya uzantısını yoldan almak için bu yöntemi çağırın.

StringType GetExtension() const;

Dönüş Değeri

Dosya uzantısını döndürür.

CPathT::IsDirectory

Yolun geçerli bir dizin olup olmadığını denetlemek için bu yöntemi çağırın.

BOOL IsDirectory() const;

Dönüş Değeri

Yol bir dizinse sıfır olmayan bir değer (16), aksi takdirde YANLIŞ değerini döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathIsDirectory.

CPathT::IsFileSpec

Yol sınırlandıran karakterleri (örneğin, : veya \) aramak için bu yöntemi çağırabilirsiniz. Yol sınırlayıcı karakter yoksa, yol Dosya Belirtimi yolu olarak kabul edilir.

BOOL IsFileSpec() const;

Dönüş Değeri

Yol içinde yol sınırlayıcı karakter yoksa TRUE veya yol sınırlandırma karakterleri varsa YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathIsFileSpec.

CPathT::IsPrefix

Yolun pszPrefix tarafından geçirilen türün geçerli bir ön ekini içerip içermediğini belirlemek için bu yöntemi çağırın.

BOOL IsPrefix(PCXSTR pszPrefix) const;

Parametreler

pszPrefix
Aranacak ön ek. Ön ek şu türlerden biridir: "C:\\", ".", "..", "... \\".

Dönüş Değeri

Yol ön ekini içeriyorsa TRUE veya aksi halde YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathIsPrefix.

CPathT::IsRelative

Yolun göreli olup olmadığını belirlemek için bu yöntemi çağırın.

BOOL IsRelative() const;

Dönüş Değeri

Yol göreliyse TRUE veya mutlaksa YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathIsRelative.

CPathT::IsRoot

Yolun bir dizin kökü olup olmadığını belirlemek için bu yöntemi çağırın.

BOOL IsRoot() const;

Dönüş Değeri

Yol bir kökse TRUE veya aksi halde YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathIsRoot.

CPathT::IsSameRoot

Başka bir yolun geçerli yol ile ortak bir kök bileşeni olup olmadığını belirlemek için bu yöntemi çağırın.

BOOL IsSameRoot(PCXSTR pszOther) const;

Parametreler

pszOther
Diğer yol.

Dönüş Değeri

Her iki dize de aynı kök bileşene sahipse TRUE veya aksi halde YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathIsSameRoot.

CPathT::IsUNC

Yolun bir sunucu ve paylaşım için geçerli bir UNC (evrensel adlandırma kuralı) yolu olup olmadığını belirlemek için bu yöntemi çağırın.

BOOL IsUNC() const;

Dönüş Değeri

Yol geçerli bir UNC yoluysa TRUE veya aksi takdirde YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathIsUNC.

CPathT::IsUNCServer

Yolun yalnızca bir sunucu için geçerli bir UNC (evrensel adlandırma kuralı) yolu olup olmadığını belirlemek için bu yöntemi çağırın.

BOOL IsUNCServer() const;

Dönüş Değeri

Dize yalnızca bir sunucu için geçerli bir UNC yoluysa (paylaşım adı yoksa) VEYA YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathIsUNCServer.

CPathT::IsUNCServerShare

Yolun geçerli bir UNC (evrensel adlandırma kuralı) paylaşım yolu (\\ sunucu\ paylaşımı) olup olmadığını belirlemek için bu yöntemi çağırın.

BOOL IsUNCServerShare() const;

Dönüş Değeri

Yol \\ sunucu\ paylaşımı biçimindeyse TRUE veya aksi halde YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathIsUNCServerShare.

CPathT::m_strPath

Yol.

StringType m_strPath;

Açıklamalar

StringType , için CPathTşablon parametresidir.

CPathT::MakePretty

Yolu tüm küçük harflere dönüştürerek yola tutarlı bir görünüm kazandırmak için bu yöntemi çağırın.

BOOL MakePretty();

Dönüş Değeri

Yol dönüştürüldüyse TRUE veya aksi halde YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathMakePretty.

CPathT::MatchSpec

Joker karakter eşleştirme türü içeren bir dizenin yolunu aramak için bu yöntemi çağırın.

BOOL MatchSpec(PCXSTR pszSpec) const;

Parametreler

pszSpec
Aranacak dosya türüyle null olarak sonlandırılan bir dizenin işaretçisi. Örneğin, geçerli yoldaki dosyanın doc dosyası olup olmadığını test etmek için pszSpec "*.doc" olarak ayarlanmalıdır.

Dönüş Değeri

Dize eşleşiyorsa TRUE veya başka bir şekilde YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathMatchSpec.

CPathT::operator +=

Bu işleç yola bir dize ekler.

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

Parametreler

pszMore
Eklenecek dize.

Dönüş Değeri

Güncelleştirilmiş yolu döndürür.

CPathT::operator const StringType &

Bu işleç, nesnenin dize gibi değerlendirilmesini sağlar.

operator const StringType&() const throw();

Dönüş Değeri

Bu nesne tarafından yönetilen geçerli yolu temsil eden bir dize döndürür.

CPathT::operator CPathT::P CXSTR

Bu işleç, nesnenin dize gibi değerlendirilmesini sağlar.

operator PCXSTR() const throw();

Dönüş Değeri

Bu nesne tarafından yönetilen geçerli yolu temsil eden bir dize döndürür.

CPathT::operator StringType &

Bu işleç, nesnenin dize gibi değerlendirilmesini sağlar.

operator StringType&() throw();

Dönüş Değeri

Bu nesne tarafından yönetilen geçerli yolu temsil eden bir dize döndürür.

CPathT::P CXSTR

Sabit dize türü.

typedef StringType::PCXSTR PCXSTR;

Açıklamalar

StringType , için CPathTşablon parametresidir.

CPathT::P XSTR

Dize türü.

typedef StringType::PXSTR PXSTR;

Açıklamalar

StringType , için CPathTşablon parametresidir.

CPathT::QuoteSpaces

Boşluk içeriyorsa yolu tırnak içine almak için bu yöntemi çağırın.

void QuoteSpaces();

Açıklamalar

Daha fazla bilgi için bkz . PathQuoteSpaces.

CPathT::RelativePathTo

Bir dosyadan veya klasörden diğerine göreli yol oluşturmak için bu yöntemi çağırabilirsiniz.

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

Parametreler

pszFrom
Göreli yolun başlangıcı.

dwAttrFrom
pszFrom'un Dosya öznitelikleri. Bu değer FILE_ATTRIBUTE_DIRECTORY içeriyorsa pszFrom'un bir dizin olduğu varsayılır; aksi takdirde pszFrom'un bir dosya olduğu varsayılır.

pszTo
Göreli yolun bitiş noktası.

dwAttrTo
pszTo'nun Dosya öznitelikleri. Bu değer FILE_ATTRIBUTE_DIRECTORY içeriyorsa, pszTo bir dizin olduğu varsayılır; aksi takdirde pszTo'nın bir dosya olduğu varsayılır.

Dönüş Değeri

Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathRelativePathTo.

CPathT::RemoveArgs

Yoldaki tüm komut satırı bağımsız değişkenlerini kaldırmak için bu yöntemi çağırın.

void RemoveArgs();

Açıklamalar

Daha fazla bilgi için bkz . PathRemoveArgs.

CPathT::RemoveBackslash

Sondaki ters eğik çizgiyi yoldan kaldırmak için bu yöntemi çağırın.

void RemoveBackslash();

Açıklamalar

Daha fazla bilgi için bkz . PathRemoveBackslash.

CPathT::RemoveBlanks

Yoldaki tüm baştaki ve sondaki boşlukları kaldırmak için bu yöntemi çağırın.

void RemoveBlanks();

Açıklamalar

Daha fazla bilgi için bkz . PathRemoveBlanks.

CPathT::RemoveExtension

Varsa dosya uzantısını yoldan kaldırmak için bu yöntemi çağırın.

void RemoveExtension();

Açıklamalar

Daha fazla bilgi için bkz . PathRemoveExtension.

CPathT::RemoveFileSpec

Varsa, sonundaki dosya adını ve ters eğik çizgiyi yoldan kaldırmak için bu yöntemi çağırın.

BOOL RemoveFileSpec();

Dönüş Değeri

Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathRemoveFileSpec.

CPathT::RenameExtension

Yoldaki dosya adı uzantısını yeni bir uzantıyla değiştirmek için bu yöntemi çağırın. Dosya adı bir uzantı içermiyorsa, uzantı yolun sonuna eklenir.

BOOL RenameExtension(PCXSTR pszExtension);

Parametreler

pszExtension
Önce "." karakteri bulunan yeni dosya adı uzantısı.

Dönüş Değeri

Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathRenameExtension.

CPathT::SkipRoot

Sürücü harfini veya UNC (evrensel adlandırma kuralı) sunucusu/paylaşım yolu bölümlerini yoksayarak yolu ayrıştırmak için bu yöntemi çağırın.

int SkipRoot() const;

Dönüş Değeri

Kök (sürücü harfi veya UNC sunucusu/paylaşımı) izleyen alt yol başlangıcının konumunu döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathSkipRoot.

CPathT::StripPath

Tam yol ve dosya adının yol bölümünü kaldırmak için bu yöntemi çağırın.

void StripPath();

Açıklamalar

Daha fazla bilgi için bkz . PathStripPath.

CPathT::StripToRoot

Kök bilgiler dışında yolun tüm bölümlerini kaldırmak için bu yöntemi çağırın.

BOOL StripToRoot();

Dönüş Değeri

Yolda geçerli bir sürücü harfi bulunursa TRUE veya aksi takdirde YANLIŞ döndürür.

Açıklamalar

Daha fazla bilgi için bkz . PathStripToRoot.

CPathT::UnquoteSpaces

Yolun başından ve sonundan tırnak işaretlerini kaldırmak için bu yöntemi çağırın.

void UnquoteSpaces();

Açıklamalar

Daha fazla bilgi için bkz . PathUnquoteSpaces.

CPathT::XCHAR

Karakter türü.

typedef StringType::XCHAR XCHAR;

Açıklamalar

StringType , için CPathTşablon parametresidir.

Ayrıca bkz.

Sınıflar
CStringT Sınıfı