Shape. QueryCancelGroup イベント (Visio)Shape.QueryCancelGroup event (Visio)

ユーザーの操作に応答して、アプリケーションが選択された図形をグループ化する前に発生します。Occurs before the application groups a selection of shapes in response to a user action in the interface. いずれかのイベントハンドラーがTrueを返す場合、操作は取り消されます。If any event handler returns True, the operation is canceled.

構文Syntax

Querycancelgroup(選択)expression.QueryCancelGroup (Selection)

Shape オブジェクトを表す変数を取得します。expression A variable that represents a Shape object.

パラメーターParameters

名前Name 必須 / オプションRequired/Optional データ型Data type 説明Description
SelectionSelection 必須Required IVSELECTION[IVSELECTION] グループ化される図形です。The selection of shapes that is going to be grouped.

解説Remarks

ユーザーが選択した図形をグループ化するようにインスタンスを指示した後、Microsoft Visio のインスタンスはQuerycancelgroupを起動します。A Microsoft Visio instance fires QueryCancelGroup after the user has directed the instance to group a selection of shapes. 選択範囲内の図形がすべて親図形のサブ図形である場合にだけイベントが発生します。The event fires only if the shapes in the selection are all sub-shapes of the parent shape.

  • いずれかのイベントハンドラーがTrue (キャンセル) を返した場合、インスタンスはgroupcanceledイベントを発生させ、図形をグループ化しません。If any event handler returns True (cancel), the instance fires GroupCanceled and does not group the shapes.

  • すべてのイベントハンドラーがFalse (取り消しない) を返した場合、グループ化が実行されます。If all handlers return False (do not cancel), the grouping is performed.

クエリ イベントまたはキャンセル イベントを発生させている間、Visio のインスタンスはクライアント コードからの問い合わせに応答しますが、操作の実行は拒否します。While a Visio instance is firing a query or cancel event, it responds to inquiries from client code but refuses to perform operations. クエリ イベントまたはキャンセル イベントに応答している間、クライアント コードはフォームまたはメッセージ ボックスを表示できます。Client code can show forms or message boxes while responding to a query or cancel event.

Microsoft Visual Basic または Visual Basic for Applications (VBA) を使用している場合、このトピックの構文を使用して、イベントを一般的な方法で効率的に処理できます。If you use Microsoft Visual Basic or Visual Basic for Applications (VBA), the syntax in this topic describes a common, efficient way to handle events.

独自のイベントオブジェクトを作成する場合は、 Add メソッドまたは**AddAdvise** メソッドを使用します。If you want to create your own Event objects, use the Add or AddAdvise method.

アドオンを実行する Event オブジェクトを作成するには、EventList コレクションに対して Add メソッドを使用します。To create an Event object that runs an add-on, use the Add method as it applies to the EventList collection.

通知を受け取る Event オブジェクトを作成するには、AddAdvise メソッドを使用します。To create an Event object that receives notification, use the AddAdvise method.

作成するイベントのイベント コードについては、「イベント コード」を参照してください。To find an event code for the event that you want to create, see Event codes.

サポートとフィードバックSupport and feedback

Office VBA またはこの説明書に関するご質問やフィードバックがありますか?Have questions or feedback about Office VBA or this documentation? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.