GetSaveFileName

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);
 

Parametreleri

lpofn
İletişim kutusu başlatmak için kullanılan bilgileri içeren bir OPENDOSYAADI yapısı için işaretçi. GetSaveFileName döndüğünde bu yapı kullanıcının dosya seçimi hakkında bilgi içerir.

Dönüş değerleri

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

Açıklamalar

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ı.

QuickInfo

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.

Ayrıca bkz:

Ortak iletişim kutusuna kitaplığın genel bakış, ortak iletişim kutusundaki işlevler, CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENDOSYAADI

Index