~ubuntu-branches/ubuntu/trusty/monodevelop/trusty-proposed

<para>This constructor should be called by derived classes when they completely construct the object in managed code and merely want the runtime to allocate and initialize the NSObject. This is required to implement the two-step initialization process that Objective-C uses, the first step is to perform the object allocation, the second step is to initialize the object. When you invoke the constructor that takes the NSObjectFlag.Empty you taking advatnage of a direct path that goes all the way up to NSObject to merely allocate the object's memory and bind the Objective-C and C# objects together. The actual initialization of the object is up to you.</para>

<para>This constructor is typically used by the binding generator to allocate the object, but prevent the actual initialization to take place. Once the allocation has taken place, the constructor has to initialize the object. With constructors generated by the binding generator this means that it manually invokes one of the "init" methods to initialize the object.</para>

<para>It is your responsability to completely initialize the object if you chain up using the NSObjectFlag.Empty path.</para>

<para>In general, if your constructors invokes the NSObjectFlag.Empty base implementation, then it should be calling an Objective-C init method. If this is not the case, you should instead chain to the proper constructor in your class. </para>

<para>The argument value is ignored and merely ensures that the only code that is executed is the construction phase is the basic NSObject allocation and runtime type registration. Typically the chaining would look like this:</para>

<para>This constructor should be called by derived classes when they are initialized using an [Export] attribute. The argument value is ignore, typically the chaining would look like this:</para>

// The NSObjectFlag merely allocates the object and registers the

// C# class with the Objective-C runtime if necessary, but no actual

// initXxx method is invoked, that is done later in the constructor

// This is taken from MonoMac's source code:

[Export ("initWithFrame:")]

public UIView (System.Drawing.RectangleF frame) : base (NSObjectFlag.Empty)

{

// Invoke the init method now.

var initWithFrame = new Selector ("initWithFrame:").Handle;

if (IsDirectBinding)

Handle = MonoMac.ObjCRuntime.Messaging.IntPtr_objc_msgSend_RectangleF (this.Handle, initWithFrame, frame);

else

Handle = MonoMac.ObjCRuntime.Messaging.IntPtr_objc_msgSendSuper_RectangleF (this.SuperHandle, initWithFrame, frame);

}

public class MyClass : BaseClass {

[Export ("initWithFoo:")]

public MyClass (string foo) : base (NSObjectFlag.Empty)

{

...

}

100

</code>

101

</example>

102

</remarks>

133

129

134

130

135

131

</AssemblyInfo>

132

133

134

<AttributeName>System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Advanced)</AttributeName>

135

</Attribute>

136

</Attributes>

136

137

137

138

138

139

</Parameters>

275

276

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

276

277

</ReturnValue>

277

278

<Docs>

278

<summary>To be added.</summary>

279

<value>To be added.</value>

279

<summary>Represents the value associated with the constant IKImageBrowserBackgroundColorKey</summary>

280

<value>

281

</value>

280

282

<remarks>To be added.</remarks>

281

283

</Docs>

282

284

</Member>

354

356

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

355

357

</ReturnValue>

356

358

<Docs>

357

<summary>To be added.</summary>

358

<value>To be added.</value>

359

<summary>Represents the value associated with the constant IKImageBrowserCellsHighlightedTitleAttributesKey</summary>

360

<value>

361

</value>

359

362

<remarks>To be added.</remarks>

360

363

</Docs>

361

364

</Member>

394

397

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

395

398

</ReturnValue>

396

399

<Docs>

397

<summary>To be added.</summary>

398

<value>To be added.</value>

400

<summary>Represents the value associated with the constant IKImageBrowserCellsOutlineColorKey</summary>

401

<value>

402

</value>

399

403

<remarks>To be added.</remarks>

400

404

</Docs>

401

405

</Member>

434

438

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

435

439

</ReturnValue>

436

440

<Docs>

437

<summary>To be added.</summary>

438

<value>To be added.</value>

441

<summary>Represents the value associated with the constant IKImageBrowserCellsSubtitleAttributesKey</summary>

442

<value>

443

</value>

439

444

<remarks>To be added.</remarks>

440

445

</Docs>

441

446

</Member>

450

455

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

451

456

</ReturnValue>

452

457

<Docs>

453

<summary>To be added.</summary>

454

<value>To be added.</value>

458

<summary>Represents the value associated with the constant IKImageBrowserCellsTitleAttributesKey</summary>

459

<value>

460

</value>

455

461

<remarks>To be added.</remarks>

456

462

</Docs>

457

463

</Member>

606

612

</ReturnValue>

607

613

<Docs>

608

614

<summary>To be added.</summary>

609

<value>To be added.</value>

615

<value>

616

<para>(More documentation for this node is coming)</para>

617

<para tool="nullallowed">This value can be <see langword="null" />.</para>

618

</value>

610

619

<remarks>To be added.</remarks>

611

620

</Docs>

612

621

</Member>

622

631

</ReturnValue>

623

632

<Docs>

624

633

<summary>An instance of the MonoMac.ImageKit.IKImageBrowserDelegate model class which acts as the class delegate.</summary>

625

<value>The instance of the MonoMac.ImageKit.IKImageBrowserDelegate model class</value>

634

<value>

635

<para>The instance of the MonoMac.ImageKit.IKImageBrowserDelegate model class</para>

636

<para tool="nullallowed">This value can be <see langword="null" />.</para>

637

</value>

626

638

627

639

<para>The delegate instance assigned to this object will be used to handle events or provide data on demand to this class.</para>

628

640

<para>When setting the Delegate or WeakDelegate values events will be delivered to the specified instance instead of being delivered to the C#-style events</para>

647

659

648

660

<para>If set to <see langword="true" />, the method is invoked directly and will dispose manage and unmanaged resources; If set to <see langword="false" /> the method is being called by the garbage collector finalizer and should only release unmanaged resources.</para>

649

661

</param>

650

<summary>Releases the resourced used by the IKImageBrowserView object.</summary>

662

<summary>Releases the resources used by the IKImageBrowserView object.</summary>

651

663

652

664

<para>This Dispose method releases the resources used by the IKImageBrowserView class.</para>

653

665

<para>This method is called by both the Dispose() method and the object finalizer (Finalize). When invoked by the Dispose method, the parameter disposting <paramref name="disposing" /> is set to <see langword="true" /> and any managed object references that this object holds are also disposed or released; when invoked by the object finalizer, on the finalizer thread the value is set to <see langword="false" />. </para>

1120

1132

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

1121

1133

</ReturnValue>

1122

1134

<Docs>

1123

<summary>To be added.</summary>

1124

<value>To be added.</value>

1135

<summary>Represents the value associated with the constant IKImageBrowserSelectionColorKey</summary>

1136

<value>

1137

</value>

1125

1138

<remarks>To be added.</remarks>

1126

1139

</Docs>

1127

1140

</Member>

1233

1246

</ReturnValue>

1234

1247

<Docs>

1235

1248

<summary>To be added.</summary>

1236

<value>To be added.</value>

1249

<value>

1250

<para>(More documentation for this node is coming)</para>

1251

<para tool="nullallowed">This value can be <see langword="null" />.</para>

1252

</value>

1237

1253

<remarks>To be added.</remarks>

1238

1254

</Docs>

1239

1255

</Member>

1257

1273

</ReturnValue>

1258

1274

<Docs>

1259

1275

<summary>An object that can respond to the delegate protocol for this type</summary>

1260

<value>The instance that will respond to events and data requests.</value>

1276

<value>

1277

<para>The instance that will respond to events and data requests.</para>

1278

<para tool="nullallowed">This value can be <see langword="null" />.</para>

1279

</value>

1261

1280

1262

1281

<para>The delegate instance assigned to this object will be used to handle events or provide data on demand to this class.</para>

1263

1282

<para>When setting the Delegate or WeakDelegate values events will be delivered to the specified instance instead of being delivered to the C#-style events</para>

Older »