GetSaveFileName işlevi sürücü, dizin ve kaydetmek için bir dosya adı belirttiğiniz kullanıcı sağlar bir kaydetme ortak iletişim kutusu oluşturur.
bool GetSaveFileName () LPOPENFILENAME lpofn / / adres yapısı ile başlatma / / veri);
Kullanıcı bir dosya adı belirtir ve Tamam düğmesini tıklattığında, dönüş değeri sıfır. Kullanıcı tarafından belirtilen dosya adını ve tam yolunu OPENDOSYAADI yapısı lpstrFile üyesi tarafından işaret arabellek içeriyor.
Kullanıcı iptal eder veya Kaydet iletişim kutusunu kapatır veya bir hata oluştuğunda, dönüş değeri sıfırdır. Uzatılmış hata bilgilerini almak için aşağıdaki değerlerden birini döndürebilir CommDlgExtendedError işlevini çağırmak:
|CDERR_FINDRESFAILURE||CDERR_NOHINSTANCE|
|CDERR_INITIALIZATION||CDERR_NOHOOK|
|CDERR_LOCKRESFAILURE||CDERR_NOTEMPLATE|
|CDERR_LOADRESFAILURE||CDERR_STRUCTSIZE|
|CDERR_LOADSTRFAILURE||FNERR_BUFFERTOOSMALL|
|CDERR_MEMALLOCFAILURE||FNERR_INVALIDFILENAME|
|CDERR_MEMLOCKFAILURE||FNERR_SUBCLASSFAILURE|
Varsayılan olarak, Windows 95 ve Windows NT sürüm 4.0, Windows Gezgini'ne benzeyen kullanıcı arabirimi özellikleri sağlar Kaydet iletişim kutusu yeni bir sürümünü görüntüler. Bir Explorer tarzı Kaydet iletişim kutusunda bir OFNHookProc kancası yordamı sağlayabilirsiniz. Kanca işlemi etkinleştirmek için OPENDOSYAADI yapısını bayrakları üyesi ofn_explorer ve ofn_enablehook bayrakları ayarlamak ve lpfnHook üye kancası yordamı adresini belirtin.
Windows 95 ve Windows NT 4.0 Windows 3.1 veya Windows NT 3.51 kullanıcı arabirimi ile tutarlı bir kullanıcı arabirimi korumak isteyen uygulamalar için eski stil Kaydet iletişim kutusundaki destek vermeye devam. Eski stil Kaydet iletişim kutusunu görüntülemek için bir OFNHookProcOldStyle kanca işlemi etkinleştirmek ve ofn_explorer bayrağı değil ayarlandığından emin olun.
Windows ce: Tüm üyeler OPENDOSYAADI yapısı Windows ce tanımlanır. Tanımlanan üyeler hakkında daha fazla bilgi için başvuru konusuna OPENDOSYAADI yapısı.
nbsp; Windows &NT: sürüm 3.1 veya üstü gerektirir.
Windows:Windows 95 veya sonraki sürümleri gerektirir.
Windows ce:Sürüm 1.0 veya daha ilerisini gerektirir.
Header:Commdlg.h ilan etti.
İçe Library:Comdlg32.lib kullanın.
Unicode:Unicode ve ANSI sürümleri Windows NT olarak uygulanır.
Ortak iletişim kutusuna kitaplığın genel bakış, ortak iletişim kutusundaki işlevler, CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENDOSYAADI
Index