PageSetupDialog Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Kullanıcıların kenar boşlukları ve kağıt yönlendirmesi dahil olmak üzere sayfayla ilgili yazdırma ayarlarını değiştirmesine olanak tanır. Bu sınıf devralınamaz.
public ref class PageSetupDialog sealed : System::Windows::Forms::CommonDialog
public sealed class PageSetupDialog : System.Windows.Forms.CommonDialog
type PageSetupDialog = class
inherit CommonDialog
Public NotInheritable Class PageSetupDialog
Inherits CommonDialog
- Devralma
Örnekler
Aşağıdaki kod örneği, , PrinterSettingsve ShowNetwork özelliklerini kullanmayı PageSettingsgösterirPageSetupDialog. Bu örneği çalıştırmak için, adlı , ListBox1
ListBox adlı ve adlı Button1
bir Button öğesini içeren bir PageSetupDialogPageSetupDialog1
forma yerleştirin. Düğmenin tıklama olayının bu örnekteki olay işleme yöntemine bağlı olduğundan emin olun.
//This method displays a PageSetupDialog object. If the
// user clicks OK in the dialog, selected results of
// the dialog are displayed in ListBox1.
void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Initialize the dialog's PrinterSettings property to hold user
// defined printer settings.
PageSetupDialog1->PageSettings = gcnew System::Drawing::Printing::PageSettings;
// Initialize dialog's PrinterSettings property to hold user
// set printer settings.
PageSetupDialog1->PrinterSettings = gcnew System::Drawing::Printing::PrinterSettings;
//Do not show the network in the printer dialog.
PageSetupDialog1->ShowNetwork = false;
//Show the dialog storing the result.
System::Windows::Forms::DialogResult result = PageSetupDialog1->ShowDialog();
// If the result is OK, display selected settings in
// ListBox1. These values can be used when printing the
// document.
if ( result == ::DialogResult::OK )
{
array<Object^>^results = {PageSetupDialog1->PageSettings->Margins,PageSetupDialog1->PageSettings->PaperSize,PageSetupDialog1->PageSettings->Landscape,PageSetupDialog1->PrinterSettings->PrinterName,PageSetupDialog1->PrinterSettings->PrintRange};
ListBox1->Items->AddRange( results );
}
}
//This method displays a PageSetupDialog object. If the
// user clicks OK in the dialog, selected results of
// the dialog are displayed in ListBox1.
private void Button1_Click(System.Object sender, System.EventArgs e)
{
// Initialize the dialog's PrinterSettings property to hold user
// defined printer settings.
PageSetupDialog1.PageSettings =
new System.Drawing.Printing.PageSettings();
// Initialize dialog's PrinterSettings property to hold user
// set printer settings.
PageSetupDialog1.PrinterSettings =
new System.Drawing.Printing.PrinterSettings();
//Do not show the network in the printer dialog.
PageSetupDialog1.ShowNetwork = false;
//Show the dialog storing the result.
DialogResult result = PageSetupDialog1.ShowDialog();
// If the result is OK, display selected settings in
// ListBox1. These values can be used when printing the
// document.
if (result == DialogResult.OK)
{
object[] results = new object[]{
PageSetupDialog1.PageSettings.Margins,
PageSetupDialog1.PageSettings.PaperSize,
PageSetupDialog1.PageSettings.Landscape,
PageSetupDialog1.PrinterSettings.PrinterName,
PageSetupDialog1.PrinterSettings.PrintRange};
ListBox1.Items.AddRange(results);
}
}
'This method displays a PageSetupDialog object. If the
' user clicks OK in the dialog, selected results of
' the dialog are displayed in ListBox1.
Private Sub Button1_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button1.Click
' Initialize the dialog's PrinterSettings property to hold user
' defined printer settings.
PageSetupDialog1.PageSettings = _
New System.Drawing.Printing.PageSettings
' Initialize dialog's PrinterSettings property to hold user
' set printer settings.
PageSetupDialog1.PrinterSettings = _
New System.Drawing.Printing.PrinterSettings
'Do not show the network in the printer dialog.
PageSetupDialog1.ShowNetwork = False
'Show the dialog storing the result.
Dim result As DialogResult = PageSetupDialog1.ShowDialog()
' If the result is OK, display selected settings in
' ListBox1. These values can be used when printing the
' document.
If (result = DialogResult.OK) Then
Dim results() As Object = New Object() _
{PageSetupDialog1.PageSettings.Margins, _
PageSetupDialog1.PageSettings.PaperSize, _
PageSetupDialog1.PageSettings.Landscape, _
PageSetupDialog1.PrinterSettings.PrinterName, _
PageSetupDialog1.PrinterSettings.PrintRange}
ListBox1.Items.AddRange(results)
End If
End Sub
Açıklamalar
İletişim PageSetupDialog kutusu, belirli Documentbir öğesinin PageSettings ve PrinterSettings bilgilerini değiştirir. Kullanıcı, yazdırma ve kenar boşluklarını işlemek için iletişim kutusunun bölümlerini etkinleştirebilir; kağıt yönlendirmesi, boyutu ve kaynağı; ve Yardım ve ağ düğmelerini gösterir. özelliği, MinMargins bir kullanıcının seçebileceği minimum kenar boşluklarını tanımlar.
Sınıfının bir örneğini PageSetupDialog oluşturduğunuzda, okuma/yazma özellikleri ilk değerlere ayarlanır. Bu değerlerin listesi için oluşturucuya PageSetupDialog bakın.
Bir PageSetupDialog sayfa ayarlarının görüntülenmesi gerektiğindenDocument, çağırmadan ShowDialogönce , PrinterSettingsveya PageSettings özelliğini ayarlamanız gerekir; aksi takdirde bir özel durum oluşur.
Oluşturucular
PageSetupDialog() |
PageSetupDialog sınıfının yeni bir örneğini başlatır. |
Özellikler
AllowMargins |
İletişim kutusunun kenar boşlukları bölümünün etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar. |
AllowOrientation |
İletişim kutusunun yönlendirme bölümünün (yatay veya dikey) etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar. |
AllowPaper |
İletişim kutusunun kağıt bölümünün (kağıt boyutu ve kağıt kaynağı) etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar. |
AllowPrinter |
Yazıcı düğmesinin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar. |
CanRaiseEvents |
Bileşenin bir olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component) |
Container |
öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component) |
DesignMode |
öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component) |
Document |
Sayfa ayarlarının alındığını PrintDocument belirten bir değer alır veya ayarlar. |
EnableMetric |
Milimetre cinsinden görüntülendiğinde kenar boşluğu ayarlarının otomatik olarak inçin yüzde biri veya yüzde birinden dönüştürülmesi gerekip gerekmediğini belirten bir değer alır veya ayarlar. |
Events |
Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component) |
MinMargins |
Minimum kenar boşluklarını belirten bir değeri alır veya ayarlar; inçin yüzde biri cinsinden kullanıcının seçmesine izin verilir. |
PageSettings |
Değiştirileceği sayfa ayarlarını belirten bir değer alır veya ayarlar. |
PrinterSettings |
Kullanıcı iletişim kutusundaki Yazıcı düğmesine tıkladığında değiştirilen yazıcı ayarlarını alır veya ayarlar. |
ShowHelp |
Yardım düğmesinin görünür olup olmadığını belirten bir değer alır veya ayarlar. |
ShowNetwork |
Ağ düğmesinin görünür olup olmadığını belirten bir değer alır veya ayarlar. |
Site |
öğesini alır veya ayarlar ISiteComponent. (Devralındığı yer: Component) |
Tag |
Denetimle ilgili verileri içeren bir nesneyi alır veya ayarlar. (Devralındığı yer: CommonDialog) |
Yöntemler
CreateObjRef(Type) |
Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject) |
Dispose() |
Component tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component) |
Dispose(Boolean) |
Component tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır. (Devralındığı yer: Component) |
Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
GetLifetimeService() |
Geçersiz.
Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject) |
GetService(Type) |
veya tarafından ComponentContainersağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component) |
GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
HookProc(IntPtr, Int32, IntPtr, IntPtr) |
Ortak bir iletişim kutusuna belirli işlevler eklemek için geçersiz kılınan ortak iletişim kutusu kanca yordamını tanımlar. (Devralındığı yer: CommonDialog) |
InitializeLifetimeService() |
Geçersiz.
Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject) |
MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
MemberwiseClone(Boolean) |
Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject) |
OnHelpRequest(EventArgs) |
Olayı tetikler HelpRequest . (Devralındığı yer: CommonDialog) |
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) |
Ortak bir iletişim kutusuna belirli işlevler eklemek için geçersiz kılınan sahip penceresi yordamını tanımlar. (Devralındığı yer: CommonDialog) |
Reset() |
Tüm seçenekleri varsayılan değerlerine sıfırlar. |
RunDialog(IntPtr) |
Türetilmiş bir sınıfta geçersiz kılındığında, ortak bir iletişim kutusu belirtir. (Devralındığı yer: CommonDialog) |
ShowDialog() |
Varsayılan sahibi olan ortak bir iletişim kutusu çalıştırır. (Devralındığı yer: CommonDialog) |
ShowDialog(IWin32Window) |
Belirtilen sahiple ortak bir iletişim kutusu çalıştırır. (Devralındığı yer: CommonDialog) |
ToString() |
Varsa, adını Componentiçeren bir String döndürür. Bu yöntem geçersiz kılınmamalıdır. (Devralındığı yer: Component) |
Ekinlikler
Disposed |
Bileşen yöntemine Dispose() yapılan bir çağrı tarafından atıldığında gerçekleşir. (Devralındığı yer: Component) |
HelpRequest |
Kullanıcı ortak bir iletişim kutusunda Yardım düğmesine tıkladığında gerçekleşir. (Devralındığı yer: CommonDialog) |