PageSetupDialog Sınıf

Tanım

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ı , ListBox1ListBox adlı ve adlı Button1bir Button öğesini içeren bir PageSetupDialogPageSetupDialog1forma 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

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)

Şunlara uygulanır

Ayrıca bkz.