Control.CreateGraphics Control.CreateGraphics Control.CreateGraphics Control.CreateGraphics Method

Definizione

Crea l'oggetto Graphics per il controllo.Creates the Graphics for the control.

public:
 System::Drawing::Graphics ^ CreateGraphics();
public System.Drawing.Graphics CreateGraphics ();
member this.CreateGraphics : unit -> System.Drawing.Graphics
Public Function CreateGraphics () As Graphics

Restituisce

Oggetto Graphics per il controllo.The Graphics for the control.

Esempi

Nell'esempio seguente ridimensiona il controllo specificato in modo che il controllo permetteranno il relativo testo formattato.The following code example resizes the specified control so the control will accommodate its formatted text. Il testo formattato è il Text assegnato con il controllo proprietà Font applicato al testo.The formatted text is the Text property with the control's assigned Font applied to the text. Il AutoSizeControl metodo in questo esempio ha anche un textPadding parametro che rappresenta la spaziatura interna da applicare a tutti i bordi del controllo.The AutoSizeControl method in this example also has a textPadding parameter that represents the padding to apply to all edges of the control. Per ottenere la spaziatura interna apparentemente uguali, allineare il testo con il MiddleCenter pari a System.Drawing.ContentAlignment se supportato dal controllo.To make the padding appear equal, align the text with the MiddleCenter value of System.Drawing.ContentAlignment if your control supports it.

private:
   void AutoSizeControl( Control^ control, int textPadding )
   {
      
      // Create a Graphics object for the Control.
      Graphics^ g = control->CreateGraphics();
      
      // Get the Size needed to accommodate the formatted Text.
      System::Drawing::Size preferredSize = g->MeasureString( control->Text, control->Font ).ToSize();
      
      // Pad the text and resize the control.
      control->ClientSize = System::Drawing::Size( preferredSize.Width + (textPadding * 2), preferredSize.Height + (textPadding * 2) );
      
      // Clean up the Graphics object.
      delete g;
   }
private void AutoSizeControl(Control control, int textPadding)
{
   // Create a Graphics object for the Control.
   Graphics g = control.CreateGraphics();

   // Get the Size needed to accommodate the formatted Text.
   Size preferredSize = g.MeasureString(
      control.Text, control.Font).ToSize();

   // Pad the text and resize the control.
   control.ClientSize = new Size(
      preferredSize.Width + (textPadding * 2), 
      preferredSize.Height+(textPadding * 2) );

   // Clean up the Graphics object.
   g.Dispose();
}
Private Sub AutoSizeControl(control As Control, textPadding As Integer)
   ' Create a Graphics object for the Control.
   Dim g As Graphics = control.CreateGraphics()
   
   ' Get the Size needed to accommodate the formatted Text.
   Dim preferredSize As Size = g.MeasureString( _
     control.Text, control.Font).ToSize()
   
   ' Pad the text and resize the control.
   control.ClientSize = New Size( _
     preferredSize.Width + textPadding * 2, _
     preferredSize.Height + textPadding * 2)
   
   ' Clean up the Graphics object.
   g.Dispose()
End Sub

Commenti

Il Graphics oggetto recuperato tramite il CreateGraphics metodo deve non normalmente venga mantenuto dopo l'elaborazione del messaggio corrente di Windows, perché verrà cancellato qualsiasi elemento disegnato con quell'oggetto con il successivo messaggio WM_PAINT.The Graphics object that you retrieve through the CreateGraphics method should not normally be retained after the current Windows message has been processed, because anything painted with that object will be erased with the next WM_PAINT message. Di conseguenza è possibile memorizzare nella cache le Graphics oggetto per il riutilizzo, tranne per usare i metodi non visivo, ad esempio Graphics.MeasureString.Therefore you cannot cache the Graphics object for reuse, except to use non-visual methods like Graphics.MeasureString. In alternativa, è necessario chiamare CreateGraphics ogni volta che si desidera utilizzare il Graphics dell'oggetto e quindi chiamare Dispose dopo aver terminato di usarlo.Instead, you must call CreateGraphics every time that you want to use the Graphics object, and then call Dispose when you are finished using it. Per altre informazioni sui messaggi di Windows, vedere WndProc.For more information about Windows messages, see WndProc.

Per impostazione predefinita, CreateGraphics imposta la proprietà per il thread chiamante e non riesce se viene chiamato in altri thread.By design, CreateGraphics sets ownership to the calling thread, and fails if it is called on other threads.

Nota

Oltre al InvokeRequired proprietà, sono disponibili quattro metodi su un controllo che sono thread-safe: Invoke, BeginInvoke, EndInvoke, e CreateGraphics se l'handle per il controllo è già stato creato.In addition to the InvokeRequired property, there are four methods on a control that are thread safe: Invoke, BeginInvoke, EndInvoke, and CreateGraphics if the handle for the control has already been created. La chiamata a CreateGraphics prima che venga creato l'handle del controllo in un thread in background può causare valido chiamate tra thread.Calling CreateGraphics before the control's handle has been created on a background thread can cause illegal cross thread calls. Per tutte le altre chiamate di metodo, è consigliabile usare uno dei metodi invoke per effettuare il marshalling della chiamata al thread del controllo.For all other method calls, you should use one of the invoke methods to marshal the call to the control's thread.

Sicurezza

UIPermission
per le sottofinestre chiamare questo metodo.for safe subwindows to call this method. Enumerazione associata: SafeSubWindows pari a UIPermissionWindow.Associated enumeration: SafeSubWindows value of UIPermissionWindow.

Si applica a

Vedi anche